> ## 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.

# BNB Smart Chain (BSC) Onchain Data API

> Get token balances, transactions, and OHLCV pricing data for BNB Smart Chain (BSC). 39 endpoints supported. Testnet supported.

## Overview

<Tip>
  BNB Smart Chain (BSC) combines fast block times with low transaction costs, making it one of the most active chains for DeFi and token launches. Full EVM compatibility for easy deployment.
</Tip>

GoldRush offers the most comprehensive BNB Smart Chain (BSC) 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 BNB Smart Chain (BSC) Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need.

### Supported APIs

<Columns cols={3}>
  <Card title="Foundational API" icon="https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/foundational.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=8a0b97060449218c1b477fe1fffc8a92" href="/goldrush-foundational-api" cta="Read docs" width="24" height="24" data-path="images/icons/foundational.svg">
    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.<br /><br />
    <b>Use cases: Wallets, portfolio trackers, crypto accounting & tax tools, and DeFi dashboards.</b>
  </Card>

  <Card title="Streaming API" icon="https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/streaming.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=c4a22e003bde989c0cd2d01a67bd6adf" href="/goldrush-streaming-api" cta="Read docs" width="24" height="24" data-path="images/icons/streaming.svg">
    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. <br /><br />
    <b>Use cases: Trading bots & dashboards, gaming, and AI Agents.</b>
  </Card>

  <Card title="Pipeline API" icon="https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/pipeline.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=f0027120a50c03e5660514e94a26cabb" href="/goldrush-pipeline-api" cta="Read docs" width="24" height="24" data-path="images/icons/pipeline.svg">
    Stream blockchain data directly to your own infrastructure. Push decoded blocks, transactions, event logs, and protocol-specific data into your database, warehouse, queue, or webhook with ABI decoding and SQL transforms built in.<br /><br />
    <b>Use cases: Data warehousing, analytics dashboards, ETL pipelines, and backend indexing.</b>
  </Card>
</Columns>

## Mainnet

| Property             | Value                                                            |
| -------------------- | ---------------------------------------------------------------- |
| **Chain Name**       | `bsc-mainnet` (Foundational API) / `BSC_MAINNET` (Streaming API) |
| **Chain ID**         | `56`                                                             |
| **Network Type**     | Foundational Chain                                               |
| **Support Level**    | foundational                                                     |
| **Block Explorer**   | [BscScan](https://bscscan.com/)                                  |
| **Official Website** | [BNB Smart Chain (BSC) Website](https://www.bnbchain.org/en)     |
| **Native Gas Token** | BNB                                                              |

## Testnet

| Property             | Value                                            |
| -------------------- | ------------------------------------------------ |
| **Chain Name**       | `bsc-testnet`                                    |
| **Chain ID**         | `97`                                             |
| **Purpose**          | Development and testing network                  |
| **Support Level**    | foundational                                     |
| **Block Explorer**   | [Bsc Testnet Scan](https://testnet.bscscan.com/) |
| **Native Gas Token** | gwei                                             |

## API Usage

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

#### Chain Name

* `bsc-mainnet` / `BSC_MAINNET` (mainnet)
* `bsc-testnet` (testnet)

#### Example API Calls

<CodeGroup>
  ```bash Chain Name (Mainnet) theme={null}
  curl -X GET "https://api.covalenthq.com/v1/bsc-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"
  ```

  ```bash Chain Name (BNB Smart Chain (BSC) Testnet) theme={null}
  curl -X GET "https://api.covalenthq.com/v1/bsc-testnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"
  ```

  ```bash theme={null}
  ```
</CodeGroup>

#### SDK Usage

<CodeGroup>
  ```typescript TypeScript SDK (Mainnet) theme={null}
  import { GoldRushClient } from "@covalenthq/client-sdk";

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

  ```typescript TypeScript SDK (BNB Smart Chain (BSC) Testnet) theme={null}
  import { GoldRushClient } from "@covalenthq/client-sdk";

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

## Foundational API Support

This chain supports **28**  GoldRush Foundational APIs:

#### Wallet API

* **[Get token holders as of any block height (v2) on BNB Smart Chain (BSC)](/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2/)**
* **[Get historical token balances for address on BNB Smart Chain (BSC)](/api-reference/foundational-api/balances/get-historical-token-balances-for-address/)**
* **[Get token balances for address on BNB Smart Chain (BSC)](/api-reference/foundational-api/balances/get-token-balances-for-address/)**
* **[Get native token balance for address on BNB Smart Chain (BSC)](/api-reference/foundational-api/balances/get-native-token-balance/)**
* **[Get historical portfolio value over time on BNB Smart Chain (BSC)](/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time/)**
* **[Get ERC20 token transfers for address on BNB Smart Chain (BSC)](/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address/)**

#### NFT API

* **[Get NFTs for address on BNB Smart Chain (BSC)](/api-reference/foundational-api/nft/get-nfts-for-address/)**
* **[Check ownership in NFT collection on BNB Smart Chain (BSC)](/api-reference/foundational-api/nft/check-ownership-in-nft-collection/)**
* **[Check ownership in NFT collection for specific token on BNB Smart Chain (BSC)](/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token/)**

#### Pricing API

* **[Get pool spot prices on BNB Smart Chain (BSC)](/api-reference/foundational-api/utility/get-pool-spot-prices/)**
* **[Get historical token prices on BNB Smart Chain (BSC)](/api-reference/foundational-api/utility/get-historical-token-prices/)**

#### Security API

* **[Get token approvals for address on BNB Smart Chain (BSC)](/api-reference/foundational-api/security/get-token-approvals-for-address/)**

#### Transactions API

* **[Get a transaction on BNB Smart Chain (BSC)](/api-reference/foundational-api/transactions/get-a-transaction/)** `with-traces`
* **[Get transaction summary for address on BNB Smart Chain (BSC)](/api-reference/foundational-api/transactions/get-transaction-summary-for-address/)**
* **[Get earliest transactions for address (v3)  on BNB Smart Chain (BSC)](/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3/)** `with-traces`
* **[Get recent transactions for address (v3) on BNB Smart Chain (BSC)](/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3/)** `with-traces`
* **[Get paginated transactions for address (v3) on BNB Smart Chain (BSC)](/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3/)** `with-traces`
* **[Get bulk time bucket transactions for address (v3) on BNB Smart Chain (BSC)](/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3/)**
* **[Get all transactions in a block (v3) on BNB Smart Chain (BSC)](/api-reference/foundational-api/transactions/get-all-transactions-in-a-block/)**
* **[Get all transactions in a block by page (v3)  on BNB Smart Chain (BSC)](/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page/)**

#### Block Explorer API

* **[Get a block on BNB Smart Chain (BSC)](/api-reference/foundational-api/utility/get-a-block/)**
* **[Get all chain statuses on BNB Smart Chain (BSC)](/api-reference/foundational-api/utility/get-all-chain-statuses/)**
* **[Get all chains on BNB Smart Chain (BSC)](/api-reference/foundational-api/utility/get-all-chains/)**
* **[Get block heights on BNB Smart Chain (BSC)](/api-reference/foundational-api/utility/get-block-heights/)**
* **[Get gas prices on BNB Smart Chain (BSC)](/api-reference/foundational-api/utility/get-gas-prices/)**
* **[Get log events by contract address on BNB Smart Chain (BSC)](/api-reference/foundational-api/utility/get-log-events-by-contract-address/)**
* **[Get log events by topic hash(es) on BNB Smart Chain (BSC)](/api-reference/foundational-api/utility/get-log-events-by-topic-hash/)**
* **[Get logs on BNB Smart Chain (BSC)](/api-reference/foundational-api/utility/get-logs/)**

## Streaming API Support

This chain supports **11** GoldRush Streaming APIs:

* [New DEX Pairs Stream on BNB Smart Chain (BSC)](/api-reference/streaming-api/subscriptions/new-dex-pairs-stream/)
* [OHLCV Pairs Stream on BNB Smart Chain (BSC)](/api-reference/streaming-api/subscriptions/ohlcv-pairs-stream/)
* [OHLCV Tokens Stream on BNB Smart Chain (BSC)](/api-reference/streaming-api/subscriptions/ohlcv-tokens-stream/)
* [Update Pairs Stream on BNB Smart Chain (BSC)](/api-reference/streaming-api/subscriptions/update-pairs-stream/)
* [Update Tokens Stream on BNB Smart Chain (BSC)](/api-reference/streaming-api/subscriptions/update-tokens-stream/)
* [Wallet Activity Stream on BNB Smart Chain (BSC)](/api-reference/streaming-api/subscriptions/wallet-activity-stream/)
* [OHLCV Pairs Query on BNB Smart Chain (BSC)](/api-reference/streaming-api/queries/ohlcv-pairs-query/)
* [OHLCV Tokens Query on BNB Smart Chain (BSC)](/api-reference/streaming-api/queries/ohlcv-tokens-query/)
* [Token Search Query on BNB Smart Chain (BSC)](/api-reference/streaming-api/queries/token-search-query/)
* [Top Trader Wallets for Token Query on BNB Smart Chain (BSC)](/api-reference/streaming-api/queries/upnl-for-token-query/)
* [Wallet PnL by Token Query on BNB Smart Chain (BSC)](/api-reference/streaming-api/queries/upnl-for-wallet-query/)

## Pipeline API Support

This chain supports **4** GoldRush Pipeline API data objects that can be streamed to your infrastructure:

* [Blocks](/goldrush-pipeline-api/supported-chains#bnb-smart-chain-bsc-evm)
* [Transactions](/goldrush-pipeline-api/supported-chains#bnb-smart-chain-bsc-evm)
* [Logs](/goldrush-pipeline-api/supported-chains#bnb-smart-chain-bsc-evm)
* [Transfers](/goldrush-pipeline-api/supported-chains#bnb-smart-chain-bsc-evm)

## Additional Resources

* [GoldRush API Documentation](https://goldrush.dev/docs/)
* [Supported Chains List](https://goldrush.dev/chains/)
* [API Reference](https://goldrush.dev/docs/api-reference/)