Gnosis Onchain Data API

Get token balances and transactions for Gnosis. 28 endpoints 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

API Usage

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

Chain Name

• gnosis-mainnet (mainnet)

Example API Calls

Chain Name (Mainnet)

curl -X GET "https://api.covalenthq.com/v1/gnosis-mainnet/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"
});

Foundational API Support

This chain supports 28 GoldRush Foundational APIs:

Wallet API

• Token Holders API on Gnosis
• Historical Token Balance API on Gnosis
• ERC-20 Token Balance API on Gnosis
• Native Token Balance API on Gnosis
• Historical Portfolio Value API on Gnosis
• ERC-20 Token Transfers API on Gnosis

NFT API

• NFT Wallet API on Gnosis
• NFT Ownership Check API on Gnosis
• NFT Token Ownership API on Gnosis

Pricing API

• DEX Pool Spot Price API on Gnosis
• Historical Token Price API on Gnosis

Security API

• Token Approvals API on Gnosis

Transactions API

• Transaction API on Gnosis with-input-data with-internal with-classification
• Wallet Transaction Summary API on Gnosis
• Earliest Wallet Transactions API on Gnosis with-input-data with-internal with-classification
• Wallet Transaction History API on Gnosis with-input-data with-internal with-classification
• Paginated Wallet Transactions API on Gnosis with-input-data with-internal with-classification
• Time Bucket Transactions API on Gnosis
• Block Transactions API on Gnosis
• Block Transactions API by Page on Gnosis

Block Explorer API

• Block API on Gnosis
• Block Heights API on Gnosis
• Chain Status API on Gnosis
• Contract Event Logs API on Gnosis
• Event Logs API on Gnosis
• Event Logs by Topic Hash API on Gnosis
• Gas Price API on Gnosis
• Supported Chains API on Gnosis

Internal Transactions (with-internal)

Gnosis supports internal transactions (traces). The Transactions API endpoints marked with-input-data with-internal above accept the with-internal=true query parameter, which includes internal transactions (the value transfers triggered by contract execution that are not recorded as standalone onchain transactions) in the response.

Internal transactions are included in the response by passing with-internal and cost 0.05 credits/item.

Example API Call

Recent transactions with internal transactions

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

Transaction Classification (with-classification)

Gnosis supports transaction classification. Pass with-classification=true to the Transactions API to get a type (such as swap or send_token), a category, a plain-English description, and the assets sent and received for each transaction.

Transaction classification costs 0.05 credits/item.

Example API Call

Recent transactions with classification

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

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference