Optimism

Overview

GoldRush offers the most comprehensive Optimism 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 Optimism 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	optimism-mainnet
Chain ID	10
Network Type	Foundational Chain
Support Level	foundational
Block Explorer	Optimistic Etherscan
Official Website	Optimism Website
Native Gas Token	ETH

Testnet

Property	Value
Chain Name	optimism-sepolia
Chain ID	11155420
Purpose	Development and testing network
Support Level	foundational
Block Explorer	OP Sepolia Explorer
Official Website	Optimism Sepolia Testnet Website
Native Gas Token	ETH

API Usage

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

Chain Name

• optimism-mainnet (mainnet)

• optimism-sepolia (testnet)

Example API Calls

Chain Name (Mainnet)

curl -X GET "https://api.covalenthq.com/v1/optimism-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY"

SDK Usage

TypeScript SDK (Mainnet)

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

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

Foundational API Support

This chain supports 39 GoldRush Foundational APIs:

Wallet API

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

NFT API

• Get NFTs for address
• Check ownership in NFT collection
• Check ownership in NFT collection for specific token

Pricing API

• Get pool spot prices
• Get historical token prices

Activity Feed API

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

Block Explorer API

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

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference