> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avnu.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Market Data

> Retrieve market data for all popular tokens on Starknet

## Overview

Returns market data for the most popular tokens on Starknet, including price, market cap, TVL, volume, and price changes. Essential for building market overview dashboards and token discovery features.

## Response

Returns an array of `TokenMarketData` objects.

<ResponseField name="address" type="string" required>
  Token contract address (hex format)
</ResponseField>

<ResponseField name="name" type="string" required>
  Token name
</ResponseField>

<ResponseField name="symbol" type="string" required>
  Token symbol
</ResponseField>

<ResponseField name="decimals" type="integer" required>
  Token decimals
</ResponseField>

<ResponseField name="logoUri" type="string">
  Token logo URL (nullable)
</ResponseField>

<ResponseField name="verified" type="boolean" required>
  Whether the token is verified
</ResponseField>

<ResponseField name="coingeckoId" type="string">
  CoinGecko identifier (nullable)
</ResponseField>

<ResponseField name="tags" type="array" required>
  Token tags: `Unknown`, `Verified`, `Community`, `Unruggable`, `AVNU`
</ResponseField>

<ResponseField name="linePriceFeedInUsd" type="array" required>
  Recent price history for sparkline charts

  <Expandable title="DataPoint">
    <ResponseField name="date" type="string" required>
      ISO 8601 timestamp
    </ResponseField>

    <ResponseField name="value" type="number" required>
      Price in USD
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="starknet" type="object" required>
  Starknet-specific market data

  <Expandable title="StarknetMarket">
    <ResponseField name="usd" type="number" required>
      Current price in USD
    </ResponseField>

    <ResponseField name="usdTvl" type="number" required>
      Total Value Locked on Starknet in USD
    </ResponseField>

    <ResponseField name="usdPriceChange1h" type="number" required>
      Price change in last 1 hour (USD)
    </ResponseField>

    <ResponseField name="usdPriceChangePercentage1h" type="number">
      Price change percentage in last 1 hour (nullable)
    </ResponseField>

    <ResponseField name="usdPriceChange24h" type="number" required>
      Price change in last 24 hours (USD)
    </ResponseField>

    <ResponseField name="usdPriceChangePercentage24h" type="number">
      Price change percentage in last 24 hours (nullable)
    </ResponseField>

    <ResponseField name="usdPriceChange7d" type="number" required>
      Price change in last 7 days (USD)
    </ResponseField>

    <ResponseField name="usdPriceChangePercentage7d" type="number">
      Price change percentage in last 7 days (nullable)
    </ResponseField>

    <ResponseField name="usdVolume24h" type="number" required>
      24h volume on Starknet in USD
    </ResponseField>

    <ResponseField name="usdTradingVolume24h" type="number" required>
      24h trading volume on Starknet in USD
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="global" type="object">
  Global market data from external sources (nullable)

  <Expandable title="GlobalMarket">
    <ResponseField name="usd" type="number" required>
      Global price in USD
    </ResponseField>

    <ResponseField name="usdMarketCap" type="number" required>
      Market capitalization in USD
    </ResponseField>

    <ResponseField name="usdFdv" type="number" required>
      Fully diluted valuation in USD
    </ResponseField>

    <ResponseField name="usdMarketCapChange24h" type="number" required>
      Market cap change in 24h (USD)
    </ResponseField>

    <ResponseField name="usdMarketCapChangePercentage24h" type="number" required>
      Market cap change percentage in 24h
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://starknet.impulse.avnu.fi/v3/tokens"
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch('https://starknet.impulse.avnu.fi/v3/tokens');
  const tokens = await response.json();

  console.log(`Found ${tokens.length} tokens`);

  // Display top 5 by market cap
  tokens
    .filter(t => t.global?.usdMarketCap)
    .sort((a, b) => (b.global?.usdMarketCap || 0) - (a.global?.usdMarketCap || 0))
    .slice(0, 5)
    .forEach((token, i) => {
      const change = token.starknet.usdPriceChangePercentage24h?.toFixed(2) ?? 'N/A';
      console.log(`${i + 1}. ${token.symbol}: $${token.starknet.usd} (${change}%)`);
    });
  ```

  ```python Python theme={null}
  import requests

  response = requests.get('https://starknet.impulse.avnu.fi/v3/tokens')
  tokens = response.json()

  print(f"Found {len(tokens)} tokens")

  # Display top gainers (24h)
  gainers = sorted(
      tokens,
      key=lambda t: t['starknet'].get('usdPriceChangePercentage24h') or 0,
      reverse=True
  )

  for token in gainers[:5]:
      change = token['starknet'].get('usdPriceChangePercentage24h', 0)
      print(f"{token['symbol']}: ${token['starknet']['usd']:.2f} (+{change:.2f}%)")
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  [
    {
      "address": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
      "name": "Ether",
      "symbol": "ETH",
      "decimals": 18,
      "logoUri": "https://assets.avnu.fi/tokens/eth.svg",
      "verified": true,
      "coingeckoId": "ethereum",
      "tags": ["Verified"],
      "linePriceFeedInUsd": [
        { "date": "2024-02-13T00:00:00Z", "value": 2420.50 },
        { "date": "2024-02-14T00:00:00Z", "value": 2435.75 }
      ],
      "starknet": {
        "usd": 2435.75,
        "usdTvl": 45000000,
        "usdPriceChange1h": 5.25,
        "usdPriceChangePercentage1h": 0.22,
        "usdPriceChange24h": 45.50,
        "usdPriceChangePercentage24h": 1.90,
        "usdPriceChange7d": 120.30,
        "usdPriceChangePercentage7d": 5.20,
        "usdVolume24h": 12500000,
        "usdTradingVolume24h": 8500000
      },
      "global": {
        "usd": 2435.75,
        "usdMarketCap": 292500000000,
        "usdFdv": 292500000000,
        "usdMarketCapChange24h": 5400000000,
        "usdMarketCapChangePercentage24h": 1.88
      }
    }
  ]
  ```
</ResponseExample>