World Chain Onchain Data API

Get token balances and transactions for World Chain. 23 endpoints supported. Testnet supported.

Overview

World Chain is a blockchain designed for humans, offering features like free gas fees, native mobile distribution through mini-apps, simplified crypto transactions and Sybil resistance via World ID.

GoldRush offers the most comprehensive World Chain 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 World Chain 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	world-mainnet
Chain ID	480
Network Type	Frontier Chain
Support Level	frontier
Block Explorer	World Chain Mainnet Explorer
Official Website	World Chain Website
Native Gas Token	ETH

Testnet

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

API Usage

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

Chain Name

• world-mainnet (mainnet)
• world-sepolia-testnet (testnet)

Example API Calls

Chain Name (Mainnet)

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

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

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

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "world-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 World Chain
• Get token balances for address on World Chain
• Get native token balance for address on World Chain
• Get historical portfolio value over time on World Chain
• Get ERC20 token transfers for address on World Chain

Pricing API

• Get historical token prices on World Chain

Security API

• Get token approvals for address on World Chain

Transactions API

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

Block Explorer API

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

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference