Tokens API - Feeds - Goldsky Docs

GET https://edge.goldsky.com/data/feeds/tokens

Returns the metadata and current USD price of up to 100 tokens across chains in one request. Each item carries the token’s symbol, name, decimals, logo, and price. Use it to price a token list, show a token picker, or add symbols and USD prices to rows you already store, such as transfers from your own indexer. Unlike Balances and Transfers, this endpoint doesn’t take a wallet. It takes only the tokens parameter.

Parameters

string

required

Comma-separated chain:token_address pairs, up to 100, such as ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,base:0x0000000000000000000000000000000000000000.

chain is a supported chain value. The same aliases work, such as mainnet for ethereum, and values are case-insensitive.
token_address is 0x followed by 40 hex characters, in any case. Use the zero address, 0x0000000000000000000000000000000000000000, for the chain’s native token, such as ETH on Base.
Pairs that name the same token, such as mainnet:0xA0b8… and ethereum:0xa0b8…, are returned once.
Any chain value outside supported chains returns 400 BAD_REQUEST.

Response

object[]

One entry per distinct token, in the order you requested them. A token Goldsky knows nothing about is still listed, with its metadata and price set to null, so you can match each entry to your request by chain and token_address.

Show properties

string

Chain value, such as ethereum. See supported chains. An alias you sent comes back as its chain value, so mainnet comes back as ethereum.

string

evm.

string

Token contract address, in lowercase. The zero address for the chain’s native token.

string | null

Token symbol.

string | null

Token name.

integer | null

Token decimals.

string | null

URL of the token logo.

number | null

Current token price in USD, priced the same way as a Balances row. Major stablecoins are priced at 1.0. null when Goldsky has no price source for the token or no recent price.

string | null

When Goldsky recorded price_usd. The API only serves prices recorded in the last 4 hours. A token with no recent price comes back with price_usd set to null.A null here next to a price_usd means a major stablecoin priced at 1.0. Leave those tokens out of any staleness filter.

The response has no pagination object. Every token you asked for comes back in one response.

How the data behaves

Prices are current. You can’t ask for a token’s price at a past time. To get the USD value of a past transfer, use Transfers, which prices each transfer at the time it happened.
Prices move between requests. Prices update on their own schedule, so two requests seconds apart can return different prices for the same token. Responses carry Cache-Control: public, max-age=2.
Metadata can fill in later. A token Goldsky hasn’t seen yet comes back with null fields, which can fill in on a later request.

Errors

This endpoint returns the same errors as the other feeds, except INVALID_CURSOR, CONFLICTING_FILTERS, and NATIVE_BALANCE_UNAVAILABLE, which don’t apply. A malformed tokens value returns 400 BAD_REQUEST, and error.message says what is wrong:

Request	`error.message`
No `tokens`	`tokens` is required: pass a comma-separated list of `chain:token_address` pairs.
A pair without a `:`, such as `tokens=base`	`tokens` entry is not a `chain:token_address` pair: base.
A pair with a malformed address, such as `tokens=base:0x12`	`tokens` entry has no EVM token address: base:0x12. Expected `chain:0x` + 40 hex digits.
An unsupported chain, such as `avalanche`	Unsupported chain in `tokens`: avalanche. Supported: ethereum, base, arbitrum_one, optimism, polygon, bsc, robinhood, arc.
Several unsupported chains, such as `avalanche,bnb`	Unsupported chains in `tokens`: avalanche, bnb. Supported: ethereum, base, arbitrum_one, optimism, polygon, bsc, robinhood, arc.
A pair without a chain, such as `tokens=:0x12`	`tokens` entry has no chain: :0x12.
More than 100 pairs	At most 100 values may be passed in `tokens`; got 101.

Billing

One request is billed as one request, however many tokens it looks up, so a request for 100 tokens costs the same as a request for one. See Feeds pricing.

Example

Look up USDC on Ethereum, ETH on Base, USDC on Base, and an address that isn’t a token:

curl -H "X-API-Key: $GOLDSKY_FEEDS_API_KEY" \
  "https://edge.goldsky.com/data/feeds/tokens?tokens=ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,base:0x0000000000000000000000000000000000000000,base:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913,ethereum:0x000000000000000000000000000000000000dEaD"

The tokens come back in request order. Both USDC entries have a price_usd with no last_priced_at, because they’re priced at 1.0, and the last address comes back with null fields:

{
  "data": [
    {
      "chain": "ethereum",
      "chain_family": "evm",
      "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "token_symbol": "USDC",
      "token_name": "USD Coin",
      "token_decimals": 6,
      "token_logo_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602",
      "price_usd": 1.0,
      "last_priced_at": null
    },
    {
      "chain": "base",
      "chain_family": "evm",
      "token_address": "0x0000000000000000000000000000000000000000",
      "token_symbol": "ETH",
      "token_name": "Ether",
      "token_decimals": 18,
      "token_logo_url": "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628",
      "price_usd": 2325.8505102107843,
      "last_priced_at": "2026-10-27T00:27:00.000Z"
    },
    {
      "chain": "base",
      "chain_family": "evm",
      "token_address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "token_symbol": "USDC",
      "token_name": "USD Coin",
      "token_decimals": 6,
      "token_logo_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602",
      "price_usd": 1.0,
      "last_priced_at": null
    },
    {
      "chain": "ethereum",
      "chain_family": "evm",
      "token_address": "0x000000000000000000000000000000000000dead",
      "token_symbol": null,
      "token_name": null,
      "token_decimals": null,
      "token_logo_url": null,
      "price_usd": null,
      "last_priced_at": null
    }
  ]
}

​Parameters

​Response

​How the data behaves

​Errors

​Billing

​Example

Parameters

Response

How the data behaves

Errors

Billing

Example