> ## 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 and transactions for BNB Smart Chain (BSC). 28 endpoints 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.

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

> [card] [Foundational API](https://goldrush.dev/docs/goldrush-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.**

> [card] [JSON-RPC](https://goldrush.dev/docs/goldrush-json-rpc/overview.md)
>
> Low-latency EVM JSON-RPC with global failover and archive depth.
> Point your existing tooling at the GoldRush endpoint — no code changes required.\
> \\
>
> **Use cases: dApps, wallets, indexers, bots, and trading infrastructure.**

## Mainnet

| Property | Value |
| - | - |
| **Chain Name** | `bsc-mainnet` |
| **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 |

## API Usage

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

#### Chain Name

* `bsc-mainnet` (mainnet)

#### Example API Calls

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

#### SDK Usage

```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"
});
```

## Foundational API Support

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

#### Wallet API

* **[Token Holders API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2.md)**
* **[Historical Token Balance API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address.md)**
* **[ERC-20 Token Balance API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address.md)**
* **[Native Token Balance API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance.md)**
* **[Historical Portfolio Value API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time.md)**
* **[ERC-20 Token Transfers API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address.md)**

#### NFT API

* **[NFT Wallet API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address.md)**
* **[NFT Ownership Check API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection.md)**
* **[NFT Token Ownership API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token.md)**

#### Pricing API

* **[DEX Pool Spot Price API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices.md)**
* **[Historical Token Price API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices.md)**

#### Security API

* **[Token Approvals API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address.md)**

#### Transactions API

* **[Transaction API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction.md)** `with-input-data` `with-internal` `with-classification`
* **[Wallet Transaction Summary API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address.md)**
* **[Earliest Wallet Transactions API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3.md)** `with-input-data` `with-internal` `with-classification`
* **[Wallet Transaction History API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3.md)** `with-input-data` `with-internal` `with-classification`
* **[Paginated Wallet Transactions API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3.md)** `with-input-data` `with-internal` `with-classification`
* **[Time Bucket Transactions API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3.md)**
* **[Block Transactions API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block.md)**
* **[Block Transactions API by Page on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page.md)**

#### Block Explorer API

* **[Block API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block.md)**
* **[Block Heights API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights.md)**
* **[Chain Status API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses.md)**
* **[Contract Event Logs API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address.md)**
* **[Event Logs API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs.md)**
* **[Event Logs by Topic Hash API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash.md)**
* **[Gas Price API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices.md)**
* **[Supported Chains API on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains.md)**

## Internal Transactions (`with-internal`)

BNB Smart Chain (BSC) 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.

> [!NOTE]
>
> Internal transactions are included in the response by passing `with-internal` and cost `0.05` credits/item.

#### Example API Call

```bash Recent transactions with internal transactions theme={null}
curl -X GET "https://api.covalenthq.com/v1/bsc-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions_v3/?with-internal=true&key=<GOLDRUSH_API_KEY>"
```

## Transaction Classification (`with-classification`)

BNB Smart Chain (BSC) 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.

> [!NOTE]
>
> Transaction classification costs `0.05` credits/item.

#### Example API Call

```bash Recent transactions with classification theme={null}
curl -X GET "https://api.covalenthq.com/v1/bsc-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions_v3/?with-classification=true&key=<GOLDRUSH_API_KEY>"
```

## JSON-RPC

BNB Smart Chain (BSC) is available on the GoldRush JSON-RPC service. Point your existing EVM tooling (ethers.js, viem, web3.js, or raw HTTP) at the GoldRush endpoint — the standard `eth_*`, `net_*`, `web3_*`, `debug_*`, and `trace_*` methods are supported.

#### Endpoint

```
https://rpc.goldrushdata.com/v1/bsc-mainnet
```

#### Example JSON-RPC Calls

```bash eth_blockNumber theme={null}
curl https://rpc.goldrushdata.com/v1/bsc-mainnet \
  -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'
```

```bash eth_getBalance theme={null}
curl https://rpc.goldrushdata.com/v1/bsc-mainnet \
  -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBalance","params":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","latest"]}'
```

#### Sample Methods

* **[eth\_blockNumber on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/json-rpc/bsc/eth-blocknumber.md)**
* **[eth\_getBalance on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/json-rpc/bsc/eth-getbalance.md)**
* **[eth\_call on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/json-rpc/bsc/eth-call.md)**
* **[eth\_getLogs on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/json-rpc/bsc/eth-getlogs.md)**
* **[eth\_getTransactionReceipt on BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/json-rpc/bsc/eth-gettransactionreceipt.md)**

See the [full method list and per-method examples for BNB Smart Chain (BSC)](https://goldrush.dev/docs/api-reference/json-rpc/chains/bsc.md).

## Additional Resources

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.