Unichain Testnet Blockchain
Data Indexing API

Unichain Testnet Quick Facts

Unichain is a DeFi-native Ethereum L2, built to be the home for liquidity across chains

GoldRush API Developer Docs

Tutorials, guides and references on the GoldRush API.

GoldRush API Reference

Complete reference documentation for the GoldRush API.

Developer SDK

Official open-source client libraries for your favorite platforms.

FAQ

These FAQs are a self-serve support resource for the GoldRush 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 GoldRush 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
unichain-sepolia-testnet
Chain ID
1301
Block explorer
Blocktime1 seconds
Historical balances❌
NFT assets and metadata❌
Query via SQL on Increment❌

Mainnet

Chain name
unichain-sepolia-testnet
Chain ID
1301
Block explorer
Blocktime1 seconds
Historical balances❌
NFT assets and metadata❌
Query via SQL on Increment❌

Don't Have an API Key?

Sign up to start building on Unichain Testnet.

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

Supported Endpoints

Endpoint

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
Related guides:  Comparing GoldRush’s Token Balances API to RPC Providers, Building a Web3 Portfolio Tracker with the GoldRush API, Building Web3 Wallets (Part 1) - Token Displays,
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();
    console.log(resp.data);
}