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

# Monad Onchain Data API

> Get token balances, transactions, and OHLCV pricing data for Monad. 31 endpoints supported. Testnet supported.

## Overview

<Tip>
  Monad redefines L1 scalability with 10,000 TPS, 1-second finality, and near-zero gas fees while maintaining full EVM compatibility. The next generation of high-performance blockchains.
</Tip>

GoldRush offers the most comprehensive Monad 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 Monad 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**       | `monad-mainnet` (Foundational API) / `MONAD_MAINNET` (Streaming API) |
| **Chain ID**         | `143`                                                                |
| **Network Type**     | Frontier Chain                                                       |
| **Support Level**    | frontier                                                             |
| **Block Explorer**   | [Monad Blockchain Explorer](https://monadexplorer.com/)              |
| **Official Website** | [Monad Website](https://www.monad.xyz/)                              |
| **Native Gas Token** | MON                                                                  |

## Testnet

| Property             | Value                                                           |
| -------------------- | --------------------------------------------------------------- |
| **Chain Name**       | `monad-testnet`                                                 |
| **Chain ID**         | `10143`                                                         |
| **Purpose**          | Development and testing network                                 |
| **Support Level**    | frontier                                                        |
| **Block Explorer**   | [Monad Blockchain Explorer](https://testnet.monadexplorer.com/) |
| **Official Website** | [Monad Testnet Website](https://www.monad.xyz/)                 |
| **Native Gas Token** | MON                                                             |

## API Usage

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

#### Chain Name

* `monad-mainnet` / `MONAD_MAINNET` (mainnet)
* `monad-testnet` (testnet)

#### Example API Calls

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

  ```bash Chain Name (Monad Testnet) theme={null}
  curl -X GET "https://api.covalenthq.com/v1/monad-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: "monad-mainnet",
      walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  });
  ```

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

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

## Foundational API Support

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

#### Wallet API

* **[Get token balances for address](/api-reference/foundational-api/balances/get-token-balances-for-address/)**
* **[Get native token balance for address](/api-reference/foundational-api/balances/get-native-token-balance/)**
* **[Get historical portfolio value over time](/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time/)**
* **[Get ERC20 token transfers for address](/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address/)**

#### Pricing API

* **[Get historical token prices](/api-reference/foundational-api/utility/get-historical-token-prices/)**

#### Security API

* **[Get token approvals for address](/api-reference/foundational-api/security/get-token-approvals-for-address/)**

#### Transactions API

* **[Get a transaction](/api-reference/foundational-api/transactions/get-a-transaction/)**
* **[Get transaction summary for address](/api-reference/foundational-api/transactions/get-transaction-summary-for-address/)**
* **[Get earliest transactions for address (v3) ](/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3/)**
* **[Get recent transactions for address (v3)](/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3/)**
* **[Get paginated transactions for address (v3)](/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3/)**
* **[Get bulk time bucket transactions for address (v3)](/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3/)**
* **[Get all transactions in a block (v3)](/api-reference/foundational-api/transactions/get-all-transactions-in-a-block/)**
* **[Get all transactions in a block by page (v3) ](/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page/)**

#### Block Explorer API

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

## Streaming API Support

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

* [New DEX Pairs Stream](/api-reference/streaming-api/subscriptions/new-dex-pairs-stream/)
* [OHLCV Pairs Stream](/api-reference/streaming-api/subscriptions/ohlcv-pairs-stream/)
* [OHLCV Tokens Stream](/api-reference/streaming-api/subscriptions/ohlcv-tokens-stream/)
* [Update Pairs Stream](/api-reference/streaming-api/subscriptions/update-pairs-stream/)
* [Update Tokens Stream](/api-reference/streaming-api/subscriptions/update-tokens-stream/)
* [Wallet Activity Stream](/api-reference/streaming-api/subscriptions/wallet-activity-stream/)
* [OHLCV Pairs Query](/api-reference/streaming-api/queries/ohlcv-pairs-query/)
* [OHLCV Tokens Query](/api-reference/streaming-api/queries/ohlcv-tokens-query/)
* [Token Search Query](/api-reference/streaming-api/queries/token-search-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#monad-evm)
* [Transactions](/goldrush-pipeline-api/supported-chains#monad-evm)
* [Logs](/goldrush-pipeline-api/supported-chains#monad-evm)
* [Transfers](/goldrush-pipeline-api/supported-chains#monad-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/)