Linea Onchain Data API

Get token balances and transactions for Linea. 24 endpoints supported. Testnet supported.

Overview

Linea is a type 2 zero knowledge Ethereum Virtual Machine that replicates an Ethereum environment by using rollups.

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

Testnet

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

API Usage

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

Chain Name

• linea-mainnet (mainnet)
• linea-sepolia-testnet (testnet)

Example API Calls

Chain Name (Mainnet)

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

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

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

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

Foundational API Support

This chain supports 24 GoldRush Foundational APIs:

Wallet API

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

NFT API

• Get NFTs for address on Linea

Pricing API

• Get historical token prices on Linea

Security API

• Get token approvals for address on Linea

Transactions API

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

Block Explorer API

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

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference