Blockchain API
Ethereum and EVM Chain Data API for Balances, Tokens and Transactions
The same five lookups work on every EVM chain. Replace {chain} in the path with one of these:
{chain} |
Network | Native coin |
|---|---|---|
eth |
Ethereum | ETH |
polygon |
Polygon | POL |
bnb |
BNB Smart Chain | BNB |
arbitrum |
Arbitrum One | ETH |
base |
Base | ETH |
optimism |
OP Mainnet | ETH |
Addresses and contracts are 0x followed by 40 hex characters. Transaction hashes are 0x followed by 64. Amounts are decimal strings in whole coins or tokens (not wei), so they never lose precision.
#Address Balance
GET /{chain}/address/{address}, 1 credit.
curl https://blockchainapi.qoest.com/eth/address/0x2222222222222222222222222222222222222222 \
-H "Authorization: Bearer your-token"
{
"chain": "eth",
"address": "0x2222222222222222222222222222222222222222",
"symbol": "ETH",
"balance": "2.5",
"balance_usd": "8250.00",
"sent_transaction_count": 26,
"price_usd": 3300
}
sent_transaction_count is the address's nonce: the number of transactions it has sent.
#Transactions and Token Transfers
GET /{chain}/address/{address}/transactions, 1 credit.
| Parameter | Type | Default | Notes |
|---|---|---|---|
type |
string | normal |
normal for native coin transactions, token for ERC-20 transfers. |
page |
integer | 1 |
25 per page, newest first, up to page 400. |
curl "https://blockchainapi.qoest.com/eth/address/0x2222222222222222222222222222222222222222/transactions?type=token" \
-H "Authorization: Bearer your-token"
{
"chain": "eth",
"address": "0x2222222222222222222222222222222222222222",
"type": "token",
"page": 1,
"transactions": [
{
"hash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060",
"direction": "in",
"from": "0x1111111111111111111111111111111111111111",
"to": "0x2222222222222222222222222222222222222222",
"block_height": 21000001,
"time": "2026-01-01T12:00:00Z",
"fee": "0.000312",
"amount": "250",
"token": {
"name": "Tether USD",
"symbol": "USDT",
"decimals": 6,
"contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
}
}
],
"next_page": null
}
With type=normal, each item has amount in the native coin, symbol, amount_usd, status (success or failed) and method (the contract function called, or null) instead of token. next_page is null on the last page.
#Token Balances
GET /{chain}/address/{address}/tokens, 2 credits.
Checks the chain's most used tokens and returns the ones the address holds:
| Chain | Tokens checked |
|---|---|
eth |
USDT, USDC, DAI, WETH, WBTC, LINK |
polygon |
USDT, USDC, DAI, WETH |
bnb |
USDT, USDC |
arbitrum |
USDT, USDC, ARB |
base |
USDC |
optimism |
USDT, USDC, OP |
To check other tokens, pass up to 5 contract addresses in contracts, separated by commas. Those are always returned, even with a zero balance.
curl "https://blockchainapi.qoest.com/eth/address/0x2222222222222222222222222222222222222222/tokens?contracts=0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE" \
-H "Authorization: Bearer your-token"
{
"chain": "eth",
"address": "0x2222222222222222222222222222222222222222",
"tokens": [
{
"symbol": "USDT",
"contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"decimals": 6,
"balance": "1500",
"balance_usd": "1500.00"
},
{
"symbol": "SHIB",
"contract": "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
"decimals": 18,
"balance": "0",
"balance_usd": "0.00"
}
],
"checked": ["USDT", "USDC", "DAI", "WETH", "WBTC", "LINK", "SHIB"]
}
balance_usd is null when no price is available for the token.
#Transaction
GET /{chain}/tx/{hash}, 1 credit.
curl https://blockchainapi.qoest.com/eth/tx/0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060 \
-H "Authorization: Bearer your-token"
{
"chain": "eth",
"hash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060",
"status": "success",
"confirmations": 12,
"block_height": 21000000,
"from": "0x2222222222222222222222222222222222222222",
"to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"amount": "0",
"symbol": "ETH",
"amount_usd": "0.00",
"fee": "0.0013",
"fee_usd": "4.29",
"nonce": 5,
"token_transfers": [
{
"contract": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"symbol": "USDT",
"from": "0x2222222222222222222222222222222222222222",
"to": "0x1111111111111111111111111111111111111111",
"amount": "250",
"raw_amount": "250000000"
}
]
}
statusispending,successorfailed. Pending transactions have0confirmations and anullfee.token_transferslists the ERC-20 transfers in the transaction.symbolandamountare filled in for the tokens in the table above. For others they arenull, andraw_amountis the amount before decimals.
#Gas Prices
GET /{chain}/gas, 1 credit.
curl https://blockchainapi.qoest.com/eth/gas \
-H "Authorization: Bearer your-token"
{
"chain": "eth",
"unit": "gwei",
"slow": 0.9,
"normal": 1.1,
"fast": 1.6,
"base_fee": 0.8721,
"source": "oracle"
}
Where a gas oracle is available, source is oracle and you get slow, normal and fast prices. Otherwise source is node, normal is the node's current gas price and slow, fast and base_fee are null.
#Errors
A malformed address, hash or contract returns 422. An unknown transaction or chain returns 404, and a provider failure returns 503. None of these cost credits. See Overview.