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"
    }
  ]
}
  • status is pending, success or failed. Pending transactions have 0 confirmations and a null fee.
  • token_transfers lists the ERC-20 transfers in the transaction. symbol and amount are filled in for the tokens in the table above. For others they are null, and raw_amount is 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.