World Chain Onchain Data API

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

API Usage

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

Chain Name

• world-mainnet (mainnet)

Example API Calls

Chain Name (Mainnet)

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

Foundational API Support

This chain supports 23 GoldRush Foundational APIs:

Wallet API

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

Pricing API

• Historical Token Price API on World Chain

Security API

• Token Approvals API on World Chain

Transactions API

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

Block Explorer API

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

Internal Transactions (with-internal)

World Chain 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/world-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions_v3/?with-internal=true&key=<GOLDRUSH_API_KEY>"

Transaction Classification (with-classification)

World Chain 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/world-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions_v3/?with-classification=true&key=<GOLDRUSH_API_KEY>"

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference