Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Pricing API Documentation

Overview

The Pricing API provides token prices across multiple chains. The sushi package also exposes wrapper functions for this API — getPrice and getPrices — under the sushi/evm export.

Endpoints

  • GET /price/v1/{chainId}: Returns a map of token address → price (in USD) for the specified chainId.
  • GET /price/v1/{chainId}/{address}: Returns a single token price (in USD) for address on the specified chainId.

Example

// Fetch prices for many tokens (address → number)
const chainId = 1
const PRICES_API_URL = new URL('https://api.sushi.com/price/v1/' + chainId)
 
console.log(PRICES_API_URL.toString())
const pricesRes = await fetch(PRICES_API_URL.toString())
const prices = await pricesRes.json() as Record<string, number>
console.log(prices)
 
// Fetch price for a single token
const address = '0x6b3595068778dd592e39a122f4f5a5cf09c90fe2' // SUSHI on mainnet
const PRICE_API_URL = new URL(`https://api.sushi.com/price/v1/${chainId}/${address}`)
 
console.log(PRICE_API_URL.toString())
const priceRes = await fetch(PRICE_API_URL.toString())
const price = await priceRes.json() as number
console.log(price)

Response

  • Multiple prices (/price/v1/{chainId}): object mapping token address to numeric USD price.
  • Single price (/price/v1/{chainId}/{address}): a single numeric USD price.

Examples:

// GET /price/v1/1
{
  "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": 2523.45,
  "0x6b3595068778dd592e39a122f4f5a5cf09c90fe2": 1.12
}
 
// GET /price/v1/1/0x6b3595068778dd592e39a122f4f5a5cf09c90fe2
1.12