Unichain Onchain Data API

Get token balances and transactions for Unichain. 23 endpoints supported. Testnet supported.

Overview

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

GoldRush offers the most comprehensive Unichain 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 Unichain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need.

Supported APIs

Foundational API

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.

Use cases: Wallets, portfolio trackers, crypto accounting & tax tools, and DeFi dashboards.

Read docs

Mainnet

Property	Value
Chain Name	unichain-mainnet
Chain ID	130
Network Type	Frontier Chain
Support Level	frontier
Block Explorer	Unichain Explorer
Official Website	Unichain Website
Native Gas Token	ETH

Testnet

Property	Value
Chain Name	unichain-sepolia-testnet
Chain ID	1301
Purpose	Development and testing network
Support Level	frontier
Block Explorer	Unichain Sepolia Testnet Explorer
Official Website	Unichain Testnet Website
Native Gas Token	ETH

API Usage

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

Chain Name

• unichain-mainnet (mainnet)
• unichain-sepolia-testnet (testnet)

Example API Calls

Chain Name (Mainnet)

curl -X GET "https://api.covalenthq.com/v1/unichain-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"

curl -X GET "https://api.covalenthq.com/v1/unichain-sepolia-testnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"

SDK Usage

TypeScript SDK (Mainnet)

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "unichain-mainnet",
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
});

import { GoldRushClient } from "@covalenthq/client-sdk";

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

Foundational API Support

This chain supports 23 GoldRush Foundational APIs:

Wallet API

• Get token holders as of any block height (v2) on Unichain
• Get token balances for address on Unichain
• Get native token balance for address on Unichain
• Get historical portfolio value over time on Unichain
• Get ERC20 token transfers for address on Unichain

Pricing API

• Get historical token prices on Unichain

Security API

• Get token approvals for address on Unichain

Transactions API

• Get a transaction on Unichain with-traces
• Get transaction summary for address on Unichain
• Get earliest transactions for address (v3) on Unichain with-traces
• Get recent transactions for address (v3) on Unichain with-traces
• Get paginated transactions for address (v3) on Unichain with-traces
• Get bulk time bucket transactions for address (v3) on Unichain
• Get all transactions in a block (v3) on Unichain
• Get all transactions in a block by page (v3) on Unichain

Block Explorer API

• Get a block on Unichain
• Get all chain statuses on Unichain
• Get all chains on Unichain
• Get block heights on Unichain
• Get gas prices on Unichain
• Get log events by contract address on Unichain
• Get log events by topic hash(es) on Unichain
• Get logs on Unichain

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference