---
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.

## Changes

- **2026-07-26** `fa9617c7c0a9` — 6 warning
  - added the new `AMOUNT_TOO_LOW` enum value to the `code` response property for the response status `400`
  - added the new `AMOUNT_TOO_LOW` enum value to the `code` response property for the response status `404`
  - added the new `AMOUNT_TOO_LOW` enum value to the `code` response property for the response status `429`
  - added the new `SLIPPAGE_EXCEEDED` enum value to the `code` response property for the response status `400`
  - …2 more
- **2026-06-22** `85b3d9b4fd84` — 4 info
  - added the optional property `priceSource` to the response with the `200` status
  - added the optional property `priceStale` to the response with the `200` status
  - added the optional property `priceTier` to the response with the `200` status
  - added the optional property `priceUpdatedAt` to the response with the `200` status

[Change history](https://skmtc.dev/deloraprotocol/apis/delora-api/changes/v1/token/get.md)

---

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