Unichain Onchain Data API

Get token balances and transactions for Unichain. 23 endpoints 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

API Usage

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

Chain Name

• unichain-mainnet (mainnet)

Example API Calls

Chain Name (Mainnet)

curl -X GET "https://api.covalenthq.com/v1/unichain-mainnet/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"
});

Foundational API Support

This chain supports 23 GoldRush Foundational APIs:

Wallet API

• Token Holders API on Unichain
• ERC-20 Token Balance API on Unichain
• Native Token Balance API on Unichain
• Historical Portfolio Value API on Unichain
• ERC-20 Token Transfers API on Unichain

Pricing API

• Historical Token Price API on Unichain

Security API

• Token Approvals API on Unichain

Transactions API

• Transaction API on Unichain with-input-data with-internal with-classification
• Wallet Transaction Summary API on Unichain
• Earliest Wallet Transactions API on Unichain with-input-data with-internal with-classification
• Wallet Transaction History API on Unichain with-input-data with-internal with-classification
• Paginated Wallet Transactions API on Unichain with-input-data with-internal with-classification
• Time Bucket Transactions API on Unichain
• Block Transactions API on Unichain
• Block Transactions API by Page on Unichain

Block Explorer API

• Block API on Unichain
• Block Heights API on Unichain
• Chain Status API on Unichain
• Contract Event Logs API on Unichain
• Event Logs API on Unichain
• Event Logs by Topic Hash API on Unichain
• Gas Price API on Unichain
• Supported Chains API on Unichain

Internal Transactions (with-internal)

Unichain supports internal transactions (traces). The Transactions API endpoints marked with-input-data with-internal above accept the with-internal=true query parameter, which includes internal transactions (the value transfers triggered by contract execution that are not recorded as standalone onchain transactions) in the response.

Internal transactions are included in the response by passing with-internal and cost 0.05 credits/item.

Example API Call

Recent transactions with internal transactions

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

Transaction Classification (with-classification)

Unichain supports transaction classification. Pass with-classification=true to the Transactions API to get a type (such as swap or send_token), a category, a plain-English description, and the assets sent and received for each transaction.

Transaction classification costs 0.05 credits/item.

Example API Call

Recent transactions with classification

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

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference