Linea Onchain Data API

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

API Usage

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

Chain Name

• linea-mainnet (mainnet)

Example API Calls

Chain Name (Mainnet)

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

Foundational API Support

This chain supports 24 GoldRush Foundational APIs:

Wallet API

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

NFT API

• NFT Wallet API on Linea

Pricing API

• Historical Token Price API on Linea

Security API

• Token Approvals API on Linea

Transactions API

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

Block Explorer API

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

Internal Transactions (with-internal)

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

Transaction Classification (with-classification)

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

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference