GetTokenPrices

POST /rpc/Trails/GetTokenPrices

GetTokenPrices will return the live prices for a list of tokens.

cURL

curl --request POST \
  --url https://trails-api.sequence.app/rpc/Trails/GetTokenPrices \
  --header 'Content-Type: application/json' \
  --data '
{
  "tokens": [
    {
      "chainId": 123,
      "tokenAddress": "<string>",
      "tokenSymbol": "<string>"
    }
  ]
}
'

200

{
  "tokenPrices": [
    {
      "token": {
        "chainId": 123,
        "tokenAddress": "<string>",
        "tokenSymbol": "<string>"
      },
      "updatedAt": "<string>",
      "priceUsd": 123
    }
  ]
}

Overview

The GetTokenPrices endpoint retrieves current USD prices for one or more tokens. This is useful for displaying real-time token values, calculating transaction costs, and showing users estimated amounts in fiat currency.

Use Cases

• Display token values in USD in your UI
• Calculate total transaction costs in fiat
• Show users how much they’ll receive in USD
• Build portfolio value displays
• Create price alerts or notifications
• Compare token values across chains

Request Parameters

Required Fields

• tokens (Token[]): Array of token objects to get prices for

Token Object Structure

Each token object should include:

• chainId (number): The chain ID where the token exists
• tokenAddress (string): The token contract address
• tokenSymbol (string, optional): Token symbol for reference

Response

The response includes:

• tokenPrices (TokenPrice[]): Array of token price objects

TokenPrice Object Structure

Each price object contains:

• token (Token): The token information
  • chainId (number): Chain ID
  • tokenAddress (string): Token contract address
  • tokenSymbol (string): Token symbol
• priceUsd (number): Current price in USD
• updatedAt (string): Timestamp of last price update

Examples

Single Token Price

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/GetTokenPrices', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    tokens: [
      {
        chainId: 1,
        tokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC on Ethereum
        tokenSymbol: 'USDC'
      }
    ]
  })
});

const { tokenPrices } = await response.json();

console.log('USDC Price:', tokenPrices[0].priceUsd);
console.log('Updated:', tokenPrices[0].updatedAt);

Multiple Token Prices

import type { TokenPrice } from "@0xtrails/api";

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/GetTokenPrices', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        tokens: [
            {
                chainId: 1,
                tokenAddress: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2', // WETH on Ethereum
                tokenSymbol: 'WETH'
            },
            {
                chainId: 1,
                tokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC on Ethereum
                tokenSymbol: 'USDC'
            },
            {
                chainId: 137,
                tokenAddress: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174', // USDC on Polygon
                tokenSymbol: 'USDC'
            }
        ]
    })
});

const { tokenPrices } = await response.json();

tokenPrices.forEach((price: TokenPrice) => {
    console.log(`${price.token.tokenSymbol} on Chain ${price.token.chainId}:`,
        `$${price.priceUsd}`);
});

Calculate Transaction Cost

import type { TokenPrice } from "@0xtrails/api";

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/GetTokenPrices', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        tokens: [
            {
                chainId: 1,
                tokenAddress: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2', // WETH on Ethereum
                tokenSymbol: 'WETH'
            },
            {
                chainId: 1,
                tokenAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC on Ethereum
                tokenSymbol: 'USDC'
            },
            {
                chainId: 137,
                tokenAddress: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174', // USDC on Polygon
                tokenSymbol: 'USDC'
            }
        ]
    })
});

const { tokenPrices } = await response.json();

tokenPrices.forEach((price: TokenPrice) => {
    console.log(`${price.token.tokenSymbol} on Chain ${price.token.chainId}:`,
        `$${price.priceUsd}`);
});

Common Token Addresses

Ethereum (chainId: 1)

• WETH: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
• USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
• USDT: 0xdAC17F958D2ee523a2206206994597C13D831ec7
• DAI: 0x6B175474E89094C44Da98b954EedeAC495271d0F

Polygon (chainId: 137)

• WMATIC: 0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270
• USDC: 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
• USDT: 0xc2132D05D31c914a87C6611C10748AEb04B58e8F

Base (chainId: 8453)

• WETH: 0x4200000000000000000000000000000000000006
• USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Arbitrum (chainId: 42161)

• WETH: 0x82aF49447D8a07e3bd95BD0d56f35241523fBab1
• USDC: 0xaf88d065e77c8cC2239327C5EDb3A432268e5831

Notes

• Not all tokens have price data available
• The updatedAt timestamp indicates when the price was last refreshed
• Prices are returned in USD

Next Steps

QuoteIntent

Use token prices to display quote values in USD

GetIntent

Calculate total transaction costs with token prices

Body

application/json

tokens · object[] · required

[]Token

Show child attributes

Response

200

application/json

OK

tokenPrices · object[] · required

[]TokenPrice

Show child attributes