Get Token Price

GET/prices/{chain_id}

Returns current USD prices for one or more tokens on any supported chain. Request multiple tokens in a single call by separating addresses with commas.

Parameters

chain_idreqinteger

EVM-compatible chain ID (path parameter).

tokenreqstring

Token contract address. Use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for the native token. Separate multiple addresses with commas.

Request

curl 'https://api.nordstern.finance/prices/8453?token=0x4200000000000000000000000000000000000006,0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' \
  -H "Referer: https://yourdomain.com"

const tokens = [
  "0x4200000000000000000000000000000000000006",
  "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
];

const response = await fetch(
  `https://api.nordstern.finance/prices/8453?token=${tokens.join(",")}`,
  { headers: { "Referer": "https://yourdomain.com" } }
);
const prices = await response.json();
console.log(prices);

import requests

url = "https://api.nordstern.finance/prices/8453"
params = {
    "token": ",".join([
        "0x4200000000000000000000000000000000000006",
        "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    ])
}
headers = {"Referer": "https://yourdomain.com"}
response = requests.get(url, params=params, headers=headers)
print(response.json())

A flat JSON object keyed by token address. Each value is a number representing the current USD price. Unrecognised addresses return null rather than an error. Always check for null before using a price in calculations.

[tokenAddress]number | null

USD price of the token. null if the token is not recognised on this chain.

{
  "0x4200000000000000000000000000000000000006": 4511.529379233013,
  "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913": 1.0
}

Note:

Prices reflect on-chain liquidity at request time. A 5–15 second client-side cache is safe for most UIs and cuts request volume toward any abuse thresholds.

Errors

Code	Meaning
`400`	Missing token parameter, or chain_id is not a number. The plain-text response body describes the issue.
`404`	Chain ID not supported.

Parameters

Request

Response

Errors

On this page