# GoldRush API Documentation - LLM Index

## Purpose
This file provides a quick index of all available API endpoints and chain documentation for LLM consumption.

## Base URL
https://goldrush.dev/docs/

## API Selection Guide

Choose the right API for your use case:

### Foundational API (Historical & Near Real-Time)
API Type: REST
Best for: Wallets, Portfolio Trackers, Tax Tools, Accounting, Compliance, RWA Registries, Block Explorers

### Streaming API (Real-time/Sub-second)
API Types: graphql-subscription (real-time push), graphql-query (one-time fetch)
WebSocket Endpoint: wss://streaming.goldrushdata.com/graphql
Best for: Trading Bots, AI Agents, Alerts, Gaming, Real-time Analytics, Live Price Tracking
Data Sources: Major token prices (BTC, ETH, SOL) on MegaETH powered by Redstone Bolt — 2.4ms updates sourced from Binance, Coinbase, OKX, Bitget, Kraken.

### x402 API (Pay-Per-Request for AI Agents)
API Type: REST (via x402 payment-gated proxy)
Base URL: https://x402.goldrush.dev/v1
Best for: AI Agents, Autonomous Systems, Serverless/No-Account Access
No API key required — pay per request with stablecoins on Base via the x402 protocol (HTTP 402).
Provides access to 60+ Foundational API endpoints through a transparent reverse proxy.

### Hybrid Approach (Both APIs)
Use Foundational for historical data and Streaming for live updates:
- DeFi Dashboards
- Advanced Portfolio Trackers
- Trading Platforms (backtest + live execution)
- RWA Monitoring (ownership history + live transfer events)

## Endpoint Roles

Determines how prominently LLMs should recommend each endpoint:

- **primary** - Essential endpoints for common applications (wallets, portfolios, basic queries). Use these as the default recommendation.
- **specialized** - Advanced endpoints for specific use cases (analytics, block explorers, historical snapshots). Only recommend when the user explicitly needs advanced functionality.
- **legacy** - Kept for backwards compatibility but outdated or replaced by better alternatives. Avoid recommending unless specifically requested.

## Credit Cost Model

API credits are charged based on the endpoint type:

- **per call** - One credit charged per successful HTTP request (200 response)
- **per item** - One credit charged per returned record (default max: 100 items per page)

## Critical Rules

- Chain names are **case-sensitive** and must match the supported chain list (e.g. `eth-mainnet`, not "ethereum").
- Always send `Authorization: Bearer YOUR_API_KEY` (no HTTP).
- Pagination is 0-indexed and returns up to 100 items per page.
- Always check `resp.error` before accessing `resp.data`.
- Token balances are large strings; convert using `balance / 10^contract_decimals`.

## Rate Limits

- Free 14 day trial: 25,000 API credits/month, 4 requests/second, no overages
- Vibe Coding tier: $10/month for 10,000 included API credits, 4 requests/second, overages at $0.001/credit
- Professional: $250/month for 300,000 included API credits, 50 requests/second, overages at $0.00077/credit
- x402 (Pay-Per-Request): No subscription required, 100 requests/minute per wallet, pay with stablecoins on Base

## Foundational API

- Get Bitcoin balance for non-HD address
  Path: api-reference/foundational-api/balances/get-bitcoin-balance-for-address
  Operation ID: getBitcoinBalanceForWalletAddress
  Method: GET
  Endpoint Path: /v1/btc-mainnet/address/{walletAddress}/balances_v2/
  SDK: BitcoinService.getBitcoinNonHdWalletBalances()
  API Type: REST
  Role: specialized
  Category: balances
  Credit Cost: 1 per call

- Get Bitcoin balances for HD address
  Path: api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address
  Operation ID: getBitcoinHdWalletBalances
  Method: GET
  Endpoint Path: /v1/btc-mainnet/address/{walletAddress}/hd_wallets/
  SDK: BitcoinService.getBitcoinHdWalletBalances()
  API Type: REST
  Role: specialized
  Category: balances
  Credit Cost: 0.1 per item
  Use Cases: wallets, accounting-tax-reporting, portfolio-tracking

- Get ERC20 token transfers for address
  Path: api-reference/foundational-api/balances/get-erc20-token-transfers-for-address
  Operation ID: getErc20TransfersForWalletAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/transfers_v2/
  SDK: BalanceService.getErc20TransfersForWalletAddress()
  API Type: REST
  Role: primary
  Category: balances
  Credit Cost: 0.05 per item

- Get historical Bitcoin balance for non-HD address
  Path: api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address
  Operation ID: getHistoricalBitcoinBalanceForWalletAddress
  Method: GET
  Endpoint Path: /v1/btc-mainnet/address/{walletAddress}/historical_balances/
  SDK: BitcoinService.getBitcoinNonHdWalletBalances()
  API Type: REST
  Role: specialized
  Category: balances
  Credit Cost: 1 per call
  Use Cases: accounting-tax-reporting, audit-compliance-forensics, portfolio-tracking

- Get historical portfolio value over time
  Path: api-reference/foundational-api/balances/get-historical-portfolio-value-over-time
  Operation ID: getHistoricalPortfolioForWalletAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/portfolio_v2/
  SDK: BalanceService.getHistoricalPortfolioForWalletAddress()
  API Type: REST
  Role: primary
  Category: balances
  Credit Cost: 2 per item
  Use Cases: portfolio-tracking, accounting-tax-reporting

- Get historical token balances for address
  Path: api-reference/foundational-api/balances/get-historical-token-balances-for-address
  Operation ID: getHistoricalTokenBalancesForWalletAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/historical_balances/
  SDK: BalanceService.getHistoricalTokenBalancesForWalletAddress()
  API Type: REST
  Role: specialized
  Category: balances
  Credit Cost: 1 per call

- Get native token balance for address
  Path: api-reference/foundational-api/balances/get-native-token-balance
  Operation ID: getNativeTokenBalance
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/balances_native/
  SDK: BalanceService.getNativeTokenBalance()
  API Type: REST
  Role: primary
  Category: balances
  Credit Cost: 0.5 per call
  Use Cases: wallets, accounting-tax-reporting, portfolio-tracking

- Get token balances for address
  Path: api-reference/foundational-api/balances/get-token-balances-for-address
  Operation ID: getTokenBalancesForWalletAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/balances_v2/
  SDK: BalanceService.getTokenBalancesForWalletAddress()
  API Type: REST
  Role: primary
  Category: balances
  Credit Cost: 1 per call
  Use Cases: wallets, portfolio-tracking, accounting-tax-reporting

- Get token holders as of any block height (v2)
  Path: api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2
  Operation ID: getTokenHoldersV2ForTokenAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/tokens/{tokenAddress}/token_holders_v2/
  SDK: BalanceService.getTokenHoldersV2ForTokenAddress()
  API Type: REST
  Role: specialized
  Category: balances
  Credit Cost: 0.02 per item

- Get activity across all chains for address
  Path: api-reference/foundational-api/cross-chain/get-address-activity
  Operation ID: getAddressActivity
  Method: GET
  Endpoint Path: /v1/address/{walletAddress}/activity/
  SDK: AllChainsService.getAddressActivity()
  API Type: REST
  Role: primary
  Category: base
  Credit Cost: 0.5 per call

- Get multichain balances
  Path: api-reference/foundational-api/cross-chain/get-allchains-balances
  Operation ID: getTokenBalances
  Method: GET
  Endpoint Path: /v1/allchains/address/{walletAddress}/balances/
  SDK: AllChainsService.getMultiChainBalances()
  API Type: REST
  Role: specialized
  Category: allchains
  Credit Cost: 2.5 per call
  Use Cases: wallets, accounting-tax-reporting, portfolio-tracking

- Get multichain & multiaddress transactions
  Path: api-reference/foundational-api/cross-chain/get-allchains-transactions
  Operation ID: getTransactions
  Method: GET
  Endpoint Path: /v1/allchains/transactions/
  SDK: AllChainsService.getMultiChainMultiAddressTransactions()
  API Type: REST
  Role: specialized
  Category: allchains
  Credit Cost: 0.25 per item
  Use Cases: wallets, portfolio-tracking, audit-compliance-forensics, accounting-tax-reporting

- Check ownership in NFT collection for specific token
  Path: api-reference/foundational-api/nft/check-ownership-in-nft-collection-token
  Operation ID: checkOwnershipInNftForSpecificTokenId
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/collection/{collectionContract}/token/{tokenId}/
  API Type: REST
  Role: specialized
  Category: nft
  Credit Cost: 1 per call

- Check ownership in NFT collection
  Path: api-reference/foundational-api/nft/check-ownership-in-nft-collection
  Operation ID: checkOwnershipInNft
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/collection/{collectionContract}/
  API Type: REST
  Role: specialized
  Category: nft
  Credit Cost: 1 per call

- Get NFTs for address
  Path: api-reference/foundational-api/nft/get-nfts-for-address
  Operation ID: getNftsForAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/balances_nft/
  API Type: REST
  Role: primary
  Category: nft
  Credit Cost: 1 per call

- Get token approvals for address
  Path: api-reference/foundational-api/security/get-token-approvals-for-address
  Operation ID: getApprovals
  Method: GET
  Endpoint Path: /v1/{chainName}/approvals/{walletAddress}/
  SDK: SecurityService.getApprovals()
  API Type: REST
  Role: primary
  Category: security
  Credit Cost: 2 per call

- Get a transaction
  Path: api-reference/foundational-api/transactions/get-a-transaction
  Operation ID: getTransaction
  Method: GET
  Endpoint Path: /v1/{chainName}/transaction_v2/{txHash}/
  SDK: TransactionService.getTransaction()
  API Type: REST
  Role: primary
  Category: transactions
  Credit Cost: 0.1 per call

- Get all transactions in a block by page (v3) 
  Path: api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page
  Operation ID: getTransactionsForBlockByPage
  Method: GET
  Endpoint Path: /v1/{chainName}/block/{blockHeight}/transactions_v3/page/{page}/
  API Type: REST
  Role: specialized
  Category: transactions
  Credit Cost: 0.1 per item

- Get all transactions in a block (v3)
  Path: api-reference/foundational-api/transactions/get-all-transactions-in-a-block
  Operation ID: getTransactionsForBlockHash
  Method: GET
  Endpoint Path: /v1/{chainName}/block_hash/{blockHash}/transactions_v3/
  API Type: REST
  Role: specialized
  Category: transactions
  Credit Cost: 0.1 per item

- Get earliest transactions for address (v3) 
  Path: api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3
  Operation ID: getEarliestTimeBucketTransactionsForAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/bulk/transactions/{walletAddress}/
  API Type: REST
  Role: specialized
  Category: transactions
  Credit Cost: 0.1 per item

- Get paginated transactions for address (v3)
  Path: api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3
  Operation ID: getTransactionsForAddressV3
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/transactions_v3/page/{page}/
  API Type: REST
  Role: primary
  Category: transactions
  Credit Cost: 0.1 per item

- Get recent transactions for address (v3)
  Path: api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3
  Operation ID: getRecentTransactionsForAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/transactions_v3/
  API Type: REST
  Role: primary
  Category: transactions
  Credit Cost: 0.1 per item

- Get bulk time bucket transactions for address (v3)
  Path: api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3
  Operation ID: getTimeBucketTransactionsForAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/
  SDK: TransactionService.getTimeBucketTransactionsForAddress()
  API Type: REST
  Role: specialized
  Category: transactions
  Credit Cost: 0.1 per item

- Get transaction summary for address
  Path: api-reference/foundational-api/transactions/get-transaction-summary-for-address
  Operation ID: getTransactionSummary
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/transactions_summary/
  SDK: TransactionService.getTransactionSummary()
  API Type: REST
  Role: primary
  Category: transactions
  Credit Cost: 1 per call

- Get Bitcoin transactions for non-HD address
  Path: api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address
  Operation ID: getTransactionsForBtcAddress
  Method: GET
  Endpoint Path: /v1/cq/covalent/app/bitcoin/transactions/
  SDK: BitcoinService.getTransactionsForBtcAddress()
  API Type: REST
  Role: primary
  Category: transactions
  Credit Cost: 0.1 per item

- Get a block
  Path: api-reference/foundational-api/utility/get-a-block
  Operation ID: getBlock
  Method: GET
  Endpoint Path: /v1/{chainName}/block_v2/{blockHeight}/
  SDK: BaseService.getBlock()
  API Type: REST
  Role: specialized
  Category: base
  Credit Cost: 1 per call

- Get all chain statuses
  Path: api-reference/foundational-api/utility/get-all-chain-statuses
  Operation ID: getAllChainStatus
  Method: GET
  Endpoint Path: /v1/chains/status/
  SDK: BaseService.getAllChainStatus()
  API Type: REST
  Role: specialized
  Category: base
  Credit Cost: 1 per call

- Get all chains
  Path: api-reference/foundational-api/utility/get-all-chains
  Operation ID: getAllChains
  Method: GET
  Endpoint Path: /v1/chains/
  SDK: BaseService.getAllChains()
  API Type: REST
  Role: specialized
  Category: base
  Credit Cost: 0.01 per call

- Get block heights
  Path: api-reference/foundational-api/utility/get-block-heights
  Operation ID: getBlockHeights
  Method: GET
  Endpoint Path: /v1/{chainName}/block_v2/{startDate}/{endDate}/
  SDK: BaseService.getBlockHeights()
  API Type: REST
  Role: specialized
  Category: base
  Credit Cost: 1 per call

- Get gas prices
  Path: api-reference/foundational-api/utility/get-gas-prices
  Operation ID: getGasPrices
  Method: GET
  Endpoint Path: /v1/{chainName}/event/{eventType}/gas_prices/
  SDK: BaseService.getGasPrices()
  API Type: REST
  Role: primary
  Category: base
  Credit Cost: 1 per call

- Get historical token prices
  Path: api-reference/foundational-api/utility/get-historical-token-prices
  Operation ID: getTokenPrices
  Method: GET
  Endpoint Path: /v1/pricing/historical_by_addresses_v2/{chainName}/{quoteCurrency}/{contractAddress}/
  SDK: PricingService.getTokenPrices()
  API Type: REST
  Role: primary
  Category: pricing
  Credit Cost: 1 per call

- Get log events by contract address
  Path: api-reference/foundational-api/utility/get-log-events-by-contract-address
  Operation ID: getLogEventsByAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/events/address/{contractAddress}/
  SDK: BaseService.getLogEventsByAddress()
  API Type: REST
  Role: specialized
  Category: base
  Credit Cost: 0.01 per item

- Get log events by topic hash(es)
  Path: api-reference/foundational-api/utility/get-log-events-by-topic-hash
  Operation ID: getLogEventsByTopicHash
  Method: GET
  Endpoint Path: /v1/{chainName}/events/topics/{topicHash}/
  SDK: BaseService.getLogEventsByTopicHash()
  API Type: REST
  Role: specialized
  Category: base
  Credit Cost: 0.01 per item

- Get logs
  Path: api-reference/foundational-api/utility/get-logs
  Operation ID: getLogs
  Method: GET
  Endpoint Path: /v1/{chainName}/events/
  SDK: BaseService.getLogs()
  API Type: REST
  Role: primary
  Category: base
  Credit Cost: 0.01 per item

- Get pool spot prices
  Path: api-reference/foundational-api/utility/get-pool-spot-prices
  Operation ID: getPoolSpotPrices
  Method: GET
  Endpoint Path: /v1/pricing/spot_prices/{chainName}/pools/{contractAddress}/
  SDK: PricingService.getPoolSpotPrices()
  API Type: REST
  Role: specialized
  Category: pricing
  Credit Cost: 1 per call

- Get resolved address for registered address
  Path: api-reference/foundational-api/utility/get-resolved-address-for-registered-address
  Operation ID: getResolvedAddress
  Method: GET
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/resolve_address/
  SDK: BaseService.getResolvedAddress()
  API Type: REST
  Role: primary
  Category: base
  Credit Cost: 1 per call

## x402 API (Pay-Per-Request)

The x402 API is a payment-gated proxy in front of the GoldRush Foundational API. AI agents pay per request using the x402 protocol (HTTP 402) with stablecoins on Base — no API keys, accounts, or subscriptions needed.

Base URL: https://x402.goldrush.dev/v1
Protocol: x402 (HTTP 402 Payment Required)
Network: Base Sepolia testnet (Base mainnet coming soon)
Rate Limit: 100 requests/minute per wallet
Client Libraries: @x402/core, @x402/evm

### How It Works
1. Agent calls an endpoint without payment
2. Server responds with HTTP 402 and payment instructions
3. Agent pays with stablecoins on Base and retries with proof of payment
4. Server validates the request before charging, then returns data

### Pricing Model
- Fixed-Price Endpoints: One price per call (e.g., token balances, NFT holdings)
- Tiered Pricing: For variable-length data — Small (1-50 items), Medium (51-200), Large (201-500), XL (501+)
- Response Caching: Cached responses cost less (TTLs: 30s for balances, 5m for pricing data)

### Discovery Endpoints (Free)

- List all available x402 endpoints
  Endpoint Path: /v1/x402/endpoints
  Method: GET
  Cost: Free
  Role: primary

- Search x402 endpoints
  Endpoint Path: /v1/x402/search?q={query}
  Method: GET
  Cost: Free
  Role: primary

- Get details for a specific x402 endpoint
  Endpoint Path: /v1/x402/endpoints/{endpoint-name}
  Method: GET
  Cost: Free
  Role: primary

### Data Endpoints (Paid via x402)

All 60+ Foundational API endpoints are available through the x402 proxy. Key examples:

- Get token balances for address (x402)
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/balances_v2/
  Method: GET
  Pricing: Fixed-price per call

- Get recent transactions for address (x402)
  Endpoint Path: /v1/{chainName}/address/{walletAddress}/transactions_v3/
  Method: GET
  Pricing: Tiered (use ?tier=small|medium|large|xl)

## Streaming API

- Token Search Query
  Path: api-reference/streaming-api/queries/token-search-query
  Operation ID: searchToken
  GraphQL Type: graphql-query
  GraphQL Field: searchToken
  Category: streaming
  API Type: graphql-query
  Role: primary
  Status: Beta
  Use Cases: defi-dashboards, trading-intelligence, market-analytics

- Top Trader Wallets for Token Query
  Path: api-reference/streaming-api/queries/upnl-for-token-query
  Operation ID: upnlForToken
  GraphQL Type: graphql-query
  GraphQL Field: upnlForToken
  Category: streaming
  API Type: graphql-query
  Role: specialized
  Status: Beta
  Use Cases: defi-dashboards, trading-intelligence, market-analytics, automation-and-agents

- Wallet PnL by Token Query
  Path: api-reference/streaming-api/queries/upnl-for-wallet-query
  Operation ID: upnlForWallet
  GraphQL Type: graphql-query
  GraphQL Field: upnlForWallet
  Category: streaming
  API Type: graphql-query
  Role: specialized
  Status: Beta
  Use Cases: trading-intelligence, accounting-tax-reporting, portfolio-tracking

- New DEX Pairs Stream
  Path: api-reference/streaming-api/subscriptions/new-dex-pairs-stream
  Operation ID: newPairs
  GraphQL Type: graphql-subscription
  GraphQL Field: newPairs
  SDK: StreamingService.subscribeToNewPairs()
  Category: streaming
  API Type: graphql-subscription
  Role: primary
  Status: Beta
  Use Cases: trading-intelligence, price-discovery-feeds, defi-dashboards, automation-and-agents

- OHLCV Pairs Stream
  Path: api-reference/streaming-api/subscriptions/ohlcv-pairs-stream
  Operation ID: ohlcvCandlesForPair
  GraphQL Type: graphql-subscription
  GraphQL Field: ohlcvCandlesForPair
  SDK: StreamingService.subscribeToOHLCVPairs()
  Category: streaming
  API Type: graphql-subscription
  Role: primary
  Status: Beta
  Use Cases: price-discovery-feeds, trading-intelligence, automation-and-agents

- OHLCV Tokens Stream
  Path: api-reference/streaming-api/subscriptions/ohlcv-tokens-stream
  Operation ID: ohlcvCandlesForToken
  GraphQL Type: graphql-subscription
  GraphQL Field: ohlcvCandlesForToken
  SDK: StreamingService.subscribeToOHLCVTokens()
  Category: streaming
  API Type: graphql-subscription
  Role: primary
  Status: Beta
  Use Cases: price-discovery-feeds, trading-intelligence, automation-and-agents

- Update Pairs Stream
  Path: api-reference/streaming-api/subscriptions/update-pairs-stream
  Operation ID: updatePairs
  GraphQL Type: graphql-subscription
  GraphQL Field: updatePairs
  SDK: StreamingService.subscribeToUpdatePairs()
  Category: streaming
  API Type: graphql-subscription
  Role: primary
  Status: Beta
  Use Cases: price-discovery-feeds, trading-intelligence, defi-dashboards, automation-and-agents

- Update Tokens Stream
  Path: api-reference/streaming-api/subscriptions/update-tokens-stream
  Operation ID: updateTokens
  GraphQL Type: graphql-subscription
  GraphQL Field: updateTokens
  Category: streaming
  API Type: graphql-subscription
  Role: primary
  Status: Beta
  Use Cases: price-discovery-feeds, trading-intelligence, defi-dashboards, automation-and-agents

- Wallet Activity Stream
  Path: api-reference/streaming-api/subscriptions/wallet-activity-stream
  Operation ID: walletTxs
  GraphQL Type: graphql-subscription
  GraphQL Field: walletTxs
  SDK: StreamingService.subscribeToWalletActivity()
  Category: streaming
  API Type: graphql-subscription
  Role: primary
  Status: Beta
  Use Cases: trading-intelligence, automation-and-agents, onchain-gaming-infrastructure, defi-dashboards

## Chain Documentation

### Support Levels

**Foundational:** These are the top EVM-compatible chains with guaranteed product parity across the entire GoldRush feature suite, including tracing enhancements. Key features that are only supported for these chains include: - **Historical token balances** - **Token holders list for any block height** - **DEX spot prices**

**Frontier:** Cutting-edge blockchain networks where GoldRush continues to expand feature coverage as the ecosystem evolves. This category includes all non-EVM chains and may include special APIs (e.g. Bitcoin).

**Community:** Community-driven blockchain networks with growing GoldRush integration and feature support. All core onchain data such as spot balances, transaction histories for addresses and decoded event logs are provided.

**Archived:** Previously supported blockchain networks that are now in archived status with limited data availability. No live data is available for these chains.

- ADI Chain
  Path: chains/adi-chain
  Chain Name: adi-mainnet
  Chain ID: 36900
  Support Level: frontier

- ApeChain
  Path: chains/apechain
  Chain Name: apechain-mainnet
  Chain ID: 33139
  Support Level: frontier

- Arbitrum Nova
  Path: chains/arbitrum-nova
  Chain Name: arbitrum-nova-mainnet
  Chain ID: 42170
  Support Level: frontier

- Arbitrum
  Path: chains/arbitrum
  Chain Name: arbitrum-mainnet
  Chain ID: 42161
  Support Level: frontier

- Arc Testnet
  Path: chains/arc
  Chain Name: arc-testnet
  Chain ID: 5042002
  Support Level: frontier

- Avalanche C-Chain
  Path: chains/avalanche-c-chain
  Chain Name: avalanche-mainnet
  Chain ID: 43114
  Support Level: frontier

- Axie/Ronin
  Path: chains/axie-ronin
  Chain Name: axie-mainnet
  Chain ID: 2020
  Support Level: frontier

- Base
  Path: chains/base
  Chain Name: base-mainnet
  Chain ID: 8453
  Support Level: foundational

- Berachain
  Path: chains/berachain
  Chain Name: berachain-mainnet
  Chain ID: 80094
  Support Level: frontier

- Bitcoin
  Path: chains/bitcoin
  Chain Name: btc-mainnet
  Chain ID: 20090103
  Support Level: frontier

- Blast
  Path: chains/blast
  Chain Name: blast-mainnet
  Chain ID: 81457
  Support Level: community

- BNB Smart Chain (BSC)
  Path: chains/bnb-smart-chain-bsc
  Chain Name: bsc-mainnet
  Chain ID: 56
  Support Level: foundational

- Canto
  Path: chains/canto
  Chain Name: canto-mainnet
  Chain ID: 7700
  Support Level: community

- Celo
  Path: chains/celo
  Chain Name: celo-mainnet
  Chain ID: 42220
  Support Level: community

- Covalent Onchain Data API
  Path: chains/covalent

- Cronos zkEVM
  Path: chains/cronos-zkevm
  Chain Name: cronos-zkevm-mainnet
  Chain ID: 388
  Support Level: community

- Cronos
  Path: chains/cronos
  Chain Name: cronos-mainnet
  Chain ID: 25
  Support Level: archived

- Ethereum
  Path: chains/ethereum
  Chain Name: eth-mainnet
  Chain ID: 1
  Support Level: foundational

- Fantom
  Path: chains/fantom
  Chain Name: fantom-mainnet
  Chain ID: 250
  Support Level: community

- Gnosis
  Path: chains/gnosis
  Chain Name: gnosis-mainnet
  Chain ID: 100
  Support Level: foundational

- Harmony
  Path: chains/harmony
  Chain Name: harmony-mainnet
  Chain ID: 1666600000
  Support Level: archived

- HyperCore
  Path: chains/hypercore
  Chain Name: hypercore-mainnet
  Chain ID: na
  Support Level: frontier

- HyperEVM
  Path: chains/hyperevm
  Chain Name: hyperevm-mainnet
  Chain ID: 999
  Support Level: frontier

- Ink
  Path: chains/ink
  Chain Name: ink-mainnet
  Chain ID: 57073
  Support Level: frontier

- Linea
  Path: chains/linea
  Chain Name: linea-mainnet
  Chain ID: 59144
  Support Level: frontier

- Lisk Onchain Data API
  Path: chains/lisk

- Manta Pacific Testnet
  Path: chains/manta-pacific
  Chain Name: manta-sepolia-testnet
  Chain ID: 3441006
  Support Level: community

- Mantle
  Path: chains/mantle
  Chain Name: mantle-mainnet
  Chain ID: 5000
  Support Level: frontier

- MegaETH
  Path: chains/megaeth
  Chain Name: megaeth-mainnet
  Chain ID: 4326
  Support Level: frontier

- Monad
  Path: chains/monad
  Chain Name: monad-mainnet
  Chain ID: 143
  Support Level: frontier

- Moonbeam
  Path: chains/moonbeam
  Chain Name: moonbeam-mainnet
  Chain ID: 1284
  Support Level: community

- Moonriver
  Path: chains/moonriver
  Chain Name: moonbeam-moonriver
  Chain ID: 1285
  Support Level: community

- Oasis Sapphire
  Path: chains/oasis-sapphire
  Chain Name: oasis-sapphire-mainnet
  Chain ID: 23294
  Support Level: frontier

- Oasis
  Path: chains/oasis
  Chain Name: emerald-paratime-mainnet
  Chain ID: 42262
  Support Level: community

- opBNB
  Path: chains/opbnb
  Chain Name: bnb-opbnb-mainnet
  Chain ID: 204
  Support Level: community

- Optimism
  Path: chains/optimism
  Chain Name: optimism-mainnet
  Chain ID: 10
  Support Level: foundational

- Plasma
  Path: chains/plasma
  Chain Name: plasma-mainnet
  Chain ID: 9745
  Support Level: frontier

- Polygon
  Path: chains/polygon
  Chain Name: matic-mainnet
  Chain ID: 137
  Support Level: foundational

- Redstone
  Path: chains/redstone
  Chain Name: redstone-mainnet
  Chain ID: 690
  Support Level: community

- Scroll
  Path: chains/scroll
  Chain Name: scroll-mainnet
  Chain ID: 534352
  Support Level: frontier

- Sei
  Path: chains/sei
  Chain Name: sei-mainnet
  Chain ID: 1329
  Support Level: frontier

- Solana
  Path: chains/solana
  Chain Name: solana-mainnet
  Chain ID: 1399811149
  Support Level: frontier

- Sonic
  Path: chains/sonic
  Chain Name: sonic-mainnet
  Chain ID: 146
  Support Level: frontier

- Taiko
  Path: chains/taiko
  Chain Name: taiko-mainnet
  Chain ID: 167000
  Support Level: frontier

- Tempo Onchain Data API
  Path: chains/tempo

- Unichain
  Path: chains/unichain
  Chain Name: unichain-mainnet
  Chain ID: 130
  Support Level: frontier

- Viction
  Path: chains/viction
  Chain Name: viction-mainnet
  Chain ID: 88
  Support Level: frontier

- World Chain
  Path: chains/world-chain
  Chain Name: world-mainnet
  Chain ID: 480
  Support Level: frontier

- ZetaChain
  Path: chains/zetachain
  Chain Name: zetachain-mainnet
  Chain ID: 7000
  Support Level: community

- zkSync Era
  Path: chains/zksync-era
  Chain Name: zksync-mainnet
  Chain ID: 324
  Support Level: frontier