---
title: "Find one token by chain and address or symbol"
method: GET
path: "/v1/token"
tags: ["V1"]
---

# Find one token by chain and address or symbol

`GET /v1/token`

Returns metadata for a single token on a specific chain. The token query parameter can be a token address or symbol.

## Query parameters

- `chain` string, required
- `token` string, required

## Headers

- `x-api-key` string

## Response `200`

Token metadata response.

- TokenDto
  - `address` string, required
  - `symbol` string, required
  - `decimals` number, required
  - `chainId` number, required
  - `name` string, required
  - `coinKey` string, required
  - `priceUSD` string — Cached USD price as a decimal string, when available.
  - `priceUpdatedAt` string — Timestamp of the cached token price, when available.
  - `priceSource` string — Price source used for the cached token price, when available.
  - `priceStale` boolean — Whether the cached token price is outside Delora's freshness window.
  - `priceTier` 'hot' | 'cold' — Price refresh tier. `hot` tokens are prioritized for fresher cached prices; `cold` tokens refresh less aggressively.
  - `logoURI` string

## Other responses

- `400` — Invalid request parameters.
- `404` — Token was not found.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/deloraprotocol/apis/delora-api.md) · [All operations](https://skmtc.net/deloraprotocol/apis/delora-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deloraprotocol/delora-api/versions/99a03dcc3e3b/schema)