Skip to main content
GET
/
v1
/
token
Get a single token
curl --request GET \
  --url https://api.alyra.finance/v1/token
{
  "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "symbol": "WETH",
  "decimals": 18,
  "chainId": 1,
  "name": "Wrapped Ether",
  "coinKey": "WETH",
  "priceUSD": "3180.67",
  "logoURI": "https://github.com/trustwallet/assets/blob/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png?raw=true"
}
The Alyra API is not yet public. For details, please contact our team.

Example requests for /v1/token

Fetch token by chain ID and token address

import axios from "axios";

const response = await axios.get("https://api.alyra.finance/v1/token", {
params: { chain: "1", token: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }
});

console.log(response);

Fetch token by chain ID and symbol

import axios from "axios";

const response = await axios.get("https://api.alyra.finance/v1/token", {
params: { chain: "1", token: "WETH" }
});

console.log(response);

Fetch token by chain key and symbol

import axios from "axios";

const response = await axios.get("https://api.alyra.finance/v1/token", {
params: { chain: "eth", token: "WETH" }
});

console.log(response);

Fetch token by chain key and token address

import axios from "axios";

const response = await axios.get("https://api.alyra.finance/v1/token", {
params: { chain: "eth", token: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }
});

console.log(response);

Query Parameters

chain
string
required

Chain identifier: numeric chain ID or chain key.

Examples:

"1"

"eth"

token
string
required

Token identifier: contract address or symbol.

Examples:

"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"

"WETH"

Response

Token metadata

address
string
required

Token contract address

symbol
string
required

Token ticker symbol (e.g., WETH)

decimals
integer
required

Number of decimals used by the token

chainId
integer
required

Chain ID to which the token belongs

name
string
required

Human-readable token name

coinKey
string
required

Short identifier for the token used across chains

priceUSD
string

Token price in USD represented as a string

logoURI
string<uri>

URL of the token logo image