Gnosis Onchain Data API

Get token balances and transactions for Gnosis. 30 endpoints supported. Testnet supported.

Overview

Discover Gnosis Chain - a community-run Ethereum sidechain for decentralized prediction, governance, and efficient dApps.

GoldRush offers the most comprehensive Gnosis Data API suite for developers, analysts, and enterprises. Whether you’re building a DeFi dashboard, a wallet, a trading bot, an AI agent or a compliance platform, our Gnosis Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need.

Supported APIs

Foundational API

Access structured historical blockchain data across 100+ chains using REST APIs. Get token balances, transaction histories, decoded event logs, NFT assets, token holders and more.

Use cases: Wallets, portfolio trackers, crypto accounting & tax tools, and DeFi dashboards.

Read docs

Mainnet

Property	Value
Chain Name	gnosis-mainnet
Chain ID	100
Network Type	Foundational Chain
Support Level	foundational
Block Explorer	Gnosis Blockscout
Official Website	Gnosis Website
Native Gas Token	xDAI

Testnet

Property	Value
Chain Name	gnosis-testnet
Chain ID	10200
Purpose	Development and testing network
Support Level	foundational
Block Explorer	Gnosis Chiado Blockscout
Official Website	Chiado Testnet Website
Native Gas Token	xDAI

API Usage

To use this blockchain network in GoldRush API calls, use:

Chain Name

• gnosis-mainnet (mainnet)
• gnosis-testnet (testnet)

Example API Calls

Chain Name (Mainnet)

curl -X GET "https://api.covalenthq.com/v1/gnosis-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"

curl -X GET "https://api.covalenthq.com/v1/gnosis-testnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"

SDK Usage

TypeScript SDK (Mainnet)

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "gnosis-mainnet",
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
});

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "gnosis-testnet",
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
});

Foundational API Support

This chain supports 28 GoldRush Foundational APIs:

Wallet API

• Get token holders as of any block height (v2) on Gnosis
• Get historical token balances for address on Gnosis
• Get token balances for address on Gnosis
• Get native token balance for address on Gnosis
• Get historical portfolio value over time on Gnosis
• Get ERC20 token transfers for address on Gnosis

NFT API

• Get NFTs for address on Gnosis
• Check ownership in NFT collection on Gnosis
• Check ownership in NFT collection for specific token on Gnosis

Pricing API

• Get pool spot prices on Gnosis
• Get historical token prices on Gnosis

Security API

• Get token approvals for address on Gnosis

Transactions API

• Get a transaction on Gnosis with-traces
• Get transaction summary for address on Gnosis
• Get earliest transactions for address (v3) on Gnosis with-traces
• Get recent transactions for address (v3) on Gnosis with-traces
• Get paginated transactions for address (v3) on Gnosis with-traces
• Get bulk time bucket transactions for address (v3) on Gnosis
• Get all transactions in a block (v3) on Gnosis
• Get all transactions in a block by page (v3) on Gnosis

Block Explorer API

• Get a block on Gnosis
• Get all chain statuses on Gnosis
• Get all chains on Gnosis
• Get block heights on Gnosis
• Get gas prices on Gnosis
• Get log events by contract address on Gnosis
• Get log events by topic hash(es) on Gnosis
• Get logs on Gnosis

Streaming API Support

This chain supports 2 GoldRush Streaming APIs:

• Top Trader Wallets for Token Query on Gnosis
• Wallet PnL by Token Query on Gnosis

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference