Skip to main content

Quickstart - Covalent Indexing and Querying API

Covalent is a hosted blockchain data solution providing access to historical and current onchain data for 200+ supported blockchains, including Arbitrum One, Nova and Arbitrum chains.

Covalent maintains a full replica of every supported blockchain, meaning you have access to:

  • Current and historical account balances
  • Full transaction histories
  • Every contract log event
  • All NFTs including assets and metadata

Use Covalent if you need:

  • Wallet, Transactions, NFT, DEX, Staking or core blockchain data (log events, blocks)
  • Normalized, aggregated and enhanced multichain data, well beyond what you get from RPC providers
  • Enterprise-grade performance

Sign up to start building on Arbitrum

APIs​

The Covalent APIs enables developers to quickly and easily access structured onchain data. This means consistent response schemas regardless of the blockchain. Available APIs and corresponding use cases include:

Wallet API​

  • Features: All token balances (ERC-20, 721, 1155, native), token transfers and prices (spot & historical) for a wallet.
  • Use cases: Wallets, portfolio trackers, token gating, airdrop snapshots.

NFT API​

  • Features: Media assets, metadata, sales, owners, trait & attribute filters, thumbnails & previews.
  • Use cases: NFT galleries & marketplaces, real world asset (RWA) tracking, token gating.

DEX API​

  • Features: Positions, rewards, pool and token details for major DEX protocols.
  • Use cases: Analytics dashboards, leaderboards, reward calculators.

Cross-Chain Activity API​

  • Features: Single API call to fetch a list of active chains and the latest transaction date on each for an address.
  • Use cases: App onboarding.

Transactions API​

Security API​

  • Features: NFT and ERC-20 token allowances, including value-at-risk.
  • Use cases: Revoke features in wallets, security applications.

Blockchain API​

  • Features: Block details, log events by contract address or topic hash, gas prices.
  • Use cases: Custom block explorers.

Developer Tools​

There are three primary developer tools for using the APIs:

  1. Unified API: enterprise-grade endpoints to use with any programming language. Switch blockchains with one path parameter.

    curl -X GET https://api.covalenthq.com/v1/arbitrum-mainnet/address/0xf977814e90da44bfa03b6295a0616a897441acec/balances_v2/ \
        -H 'Content-Type: application/json' \
        -u YOUR_API_KEY:

  2. Client SDKs: official client libraries including TypeScript, Go and Python.

    TypeScript example:

    npm install @covalenthq/client-sdk

    or:

    yarn add @covalenthq/client-sdk
    import { CovalentClient } from "@covalenthq/client-sdk";

    (async () => {
    try {
        const client = new CovalentClient("YOUR_API_KEY");
        const transactions = client.TransactionService.getAllTransactionsForAddress("arbitrum-mainnet", "0xf977814e90da44bfa03b6295a0616a897441acec");

        for await (const tx of transactions) {
        console.log("tx", tx);
        }
    } catch (error) {
        console.log(error.message);
    }
    })();

  3. GoldRush Kit: beautifully designed React components for your dApp frontend

    GoldRush Component Example

Get started​

  • API Key: sign up for free
  • Docs - comprehensive knowledge base for all things Covalent
  • Guides: learn how to build for various use cases and expand your onchain knowledge