BNB Smart Chain (BSC) Onchain Data API

Documentation Index

Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

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

Streaming API

Subscribe to real-time blockchain events with sub-second latency using GraphQL over WebSockets. Track token transfers, DEX activity, wallet movements, and OHLCV candlestick data across fast chains like Base and Solana.

Use cases: Trading bots & dashboards, gaming, and AI Agents.

Read docs

​

Mainnet

​

Testnet

​

API Usage

​

Chain Name

• bsc-mainnet / BSC_MAINNET (mainnet)
• bsc-testnet (testnet)

​

Example API Calls

curl -X GET "https://api.covalenthq.com/v1/bsc-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY"

​

SDK Usage

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

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

​

Foundational API Support

​

Wallet API

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

​

NFT API

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

​

Pricing API

• Get pool spot prices
• Get historical token prices

​

Security API

• Get token approvals for address

​

Activity Feed API

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

​

Block Explorer API

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

​

Streaming API Support

• New DEX Pairs Stream
• OHLCV Pairs Stream
• OHLCV Tokens Stream
• Update Pairs Stream
• Update Tokens Stream
• Wallet Activity Stream
• Token Search Query
• Top Trader Wallets for Token Query
• Wallet PnL by Token Query

​

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference