Docs: Docs HomeSupported NetworksUnified APICovalent NetworkIncrementAPI Reference

Moonbeam Blockchain
Data Indexing API

Moonbeam Quick Facts

Moonbeam is an Ethereum-compatible smart contract parachain on Polkadot. Moonbeam is much more than just an EVM implementation: it’s a highly specialized Layer 1.5 chain that mirrors Ethereum’s Web3 RPC, accounts, keys, subscriptions, logs, and more. The Moonbeam platform extends the base Ethereum feature set with additional features such as on-chain governance, staking, and cross-chain integrations.

Unified API Developer Docs

Tutorials, guides and references on the Unified API.

Unified API Reference

Complete reference documentation for the Unified API.

Developer SDK

Official open-source client libraries for your favorite platforms.

FAQ

These FAQs are a self-serve support resource for the Covalent API.

Base URL

The API Host for all requests is https://api.covalenthq.com/v1. Some additional points to keep in mind:

  • All requests are done over HTTPS (calls over plain HTTP will fail.)
  • The default return format for all endpoints is JSON unless the query parameter format=csv is specified.
  • All requests require authentication.

Authentication

To access the Covalent API, you will need an API key. Various authentication mechanisms are available:

Authentication via Query parameter

curl -X GET https://api.covalenthq.com/v1/ENDPOINT/?key=API_KEY

Append key=API_KEY as a query parameter to all requests.

Authentication via Basic Auth

 curl -X GET https://api.covalenthq.com/v1/ENDPOINT/ \
                -u API_KEY:
                -H 'Content-Type: application/json'
                # The colon prevents curl from asking for a password.

Provide your API key as the basic auth username. You do not need to provide a password.

Chain name
moonbeam-mainnet
Chain ID
1284
Block explorer
Blocktime6 seconds
Historical balances❌
NFT assets and metadata❌
Query via SQL on Increment✅

Mainnet

Chain name
moonbeam-mainnet
Chain ID
1284
Block explorer
Blocktime6 seconds
Historical balances❌
NFT assets and metadata❌
Query via SQL on Increment✅

Moonbeam Moonbase Alpha Testnet

Chain name
moonbeam-moonbase-alpha
Chain ID
1287
Block explorer
Blocktime12 seconds
Historical balances❌
NFT assets and metadata❌
Query via SQL on Increment✅

Don't Have an API Key?

Sign up to start building on Moonbeam.

Unlock millions of requests and free archive data on all chains.

Network Status

Monthly Active Wallets
Unique wallets who transact on a monthly basis.		---
Transactions
Unique transactions on a monthly basis.		---
Active Tokens
Unique tokens active on a monthly basis.		---
Powered by Increment.

Monthly

Monthly Active Wallets
Unique wallets who transact on a monthly basis.		---
Transactions
Unique transactions on a monthly basis.		---
Active Tokens
Unique tokens active on a monthly basis.		---
Powered by Increment.

Weekly

Weekly Active Wallets
Unique wallets who transact on a weekly basis.		---
Transactions
Unique transactions on a weekly basis.		---
Active Tokens
Unique tokens active on a weekly basis.		---
Powered by Increment.

Daily

Daily Active Wallets
Unique wallets who transact on a daily basis.		---
Transactions
Unique transactions on a daily basis.		---
Active Tokens
Unique tokens active on a daily basis.		---
Powered by Increment.

Yearly

Yearly Active Wallets
Unique wallets who transact on a yearly basis.		---
Transactions
Unique transactions on a yearly basis.		---
Active Tokens
Unique tokens active on a yearly basis.		---
Powered by Increment.

Supported Endpoints

Get token approvals for address
Get NFT approvals for address
Get token balances for address
Get historical portfolio value over time
Get ERC20 token transfers for address
Get native token balance for address
Get a block
Get resolved address for registered address
Get block heights
Get logs
Get log events by contract address
Get log events by topic hash(es)
Get chain collections
Get NFTs for address
Get NFTs from contract with metadata
Get single NFT with cached metadata from contract
Get NFT transactions for contract
Get traits for a collection
Get attributes for a collection trait
Get trait summary for collection
Check ownership in NFT collection
Check ownership in NFT collection for specific token
Get historical sales count for a collection
Get historical volume for a collection
Get historical floor prices for a collection
Get historical token prices
Get a transaction
Get recent transactions for address (v3)
Get paginated transactions for address (v3)
Get bulk time bucket transactions for address (v3)
Get earliest transactions for address (v3)
Get all transactions in a block by page (v3)
Get all transactions in a block (v3)
Get transaction summary for address

Code Samples

Get token balances for address

GET/v1/{chainName}/address/{walletAddress}/balances_v2/

Commonly used to fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata.

Costs:

1.00 Credits

Processing:

Realtime

Path Params

The chain name eg:  eth-mainnet.
moonbeam-mainnet
The requested address. Passing in an  ENS,  RNS,  Lens Handle, or an  Unstoppable Domain resolves automatically.

Query Params

The currency to convert. Supports  USD,  CAD,  EUR,  SGD,  INR,  JPY,  VND,  CNY,  KRW,  RUB,  TRY,  NGN,  ARS,  AUD,  CHF, and  GBP.
If  true, NFTs will be included in the response.
If  true, only NFTs that have been cached will be included in the response. Helpful for faster response times.
If  true, the suspected spam tokens are removed. Supports  eth-mainnet and  matic-mainnet.
If  true, the response shape is limited to a list of collections and token ids, omitting metadata and asset information. Helpful for faster response times and wallets holding a large number of NFTs.
Show Guides
Installation
npm install @covalenthq/client-sdk
Request
import { CovalentClient } from "@covalenthq/client-sdk";

const ApiServices = async () => {
    const client = new CovalentClient("YOUR_API_KEY");
    const resp = await client.BalanceService.getTokenBalancesForWalletAddress("moonbeam-mainnet");
    console.log(resp.data);
}