crypto

Live native + ERC-20 token balances for an EVM address...

Live native + ERC-20 token balances for an EVM address (Base, Ethereum, Polygon, Arbitrum, Optimism; keyless). Returns the native-coin balance and, for any ERC-20 contract addresses you pass, the symbol, decimals, raw and human-formatted balance — fetched in one multicall. For wallet dashboards, treasury checks, and agent payment/settlement flows.

get/api/crypto/balances

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/crypto/balances
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

addressstring required

EVM address to read.

chain'base' | 'ethereum' | 'polygon' | 'arbitrum' | 'optimism'

Default base.

tokensstring

Comma-separated ERC-20 contract addresses (max 20).

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.