---
title: "Retrieve ERC-20 token metadata"
method: GET
path: "/tokens/{address}"
tags: ["Tokens"]
---

# Retrieve ERC-20 token metadata

`GET /tokens/{address}`

## Query parameters

- `chainId` integer

## Response `200`

Token metadata (`found: false` if unknown).

- TokenMetadataResponse
  - `found` boolean, required
  - `address` string — Lowercase or checksummed hex EOA / contract address.
  - `chainId` integer — Numeric chain ID (e.g. 11155111 for Sepolia, 8453 for Base). On chain-aware trigger/node configs this is required and must be a configured chain; on query/filter params it is optional.
  - `name` string
  - `symbol` string
  - `decimals` integer
  - `source` 'whitelist' | 'rpc' | 'cache'

## Other responses

- `401` — Missing or invalid bearer token.

---

[API](https://skmtc.net/avaprotocol/apis/ava-protocol-avs-api.md) · [All operations](https://skmtc.net/avaprotocol/apis/ava-protocol-avs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avaprotocol/ava-protocol-avs-api/versions/231d563f2c9f/schema)