Skip to main content
POST
/
v3
/
tokens
/
prices
curl -X POST "https://starknet.impulse.avnu.fi/v3/tokens/prices" \
  -H "Content-Type: application/json" \
  -d '{
    "tokens": [
      "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
      "0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
      "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d"
    ]
  }'

[
  {
    "address": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
    "decimals": 18,
    "starknetMarket": {
      "usd": 2435.50
    },
    "globalMarket": {
      "usd": 2436.12
    }
  },
  {
    "address": "0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
    "decimals": 6,
    "starknetMarket": {
      "usd": 1.0002
    },
    "globalMarket": {
      "usd": 1.0001
    }
  },
  {
    "address": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
    "decimals": 18,
    "starknetMarket": {
      "usd": 2.35
    },
    "globalMarket": {
      "usd": 2.34
    }
  }
]

​
Overview

Returns current prices for up to 50 tokens in a single request. Provides both global market prices (from CoinGecko) and Starknet-specific on-chain prices, enabling accurate price comparisons across markets.

​
Request Body

​
tokens
array
required
Array of token contract addresses (1-50 tokens)

​
Response

Returns an array of TokenPriceV3Dto objects.
​
address
string
required
Token contract address
​
decimals
integer
required
Token decimals
​
starknetMarket
object
required
On-chain Starknet market price
​
globalMarket
object
Global market price (from CoinGecko, when available)
curl -X POST "https://starknet.impulse.avnu.fi/v3/tokens/prices" \
  -H "Content-Type: application/json" \
  -d '{
    "tokens": [
      "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
      "0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
      "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d"
    ]
  }'

[
  {
    "address": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
    "decimals": 18,
    "starknetMarket": {
      "usd": 2435.50
    },
    "globalMarket": {
      "usd": 2436.12
    }
  },
  {
    "address": "0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
    "decimals": 6,
    "starknetMarket": {
      "usd": 1.0002
    },
    "globalMarket": {
      "usd": 1.0001
    }
  },
  {
    "address": "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
    "decimals": 18,
    "starknetMarket": {
      "usd": 2.35
    },
    "globalMarket": {
      "usd": 2.34
    }
  }
]

​
Price Comparison

The V3 endpoint provides both Starknet on-chain prices and global market prices. This allows you to:
  • Detect arbitrage opportunities between Starknet and centralized exchanges
  • Display the most relevant price for your use case
  • Identify price discrepancies for trading strategies