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