> ## 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 Tokens

> Fetch paginated list of tokens with optional filtering

## Overview

Returns a paginated list of tokens available on Starknet with optional filtering by tags or search query. This endpoint is used by wallets, DEXs, and dApps across the Starknet ecosystem to display verified token information.

## Query Parameters

<ParamField query="search" type="string">
  Search filter for tokens by name, symbol, or address
</ParamField>

<ParamField query="tag" type="array">
  Filter by tags: `Unknown`, `Verified`, `Community`, `Unruggable`, `AVNU`
</ParamField>

<ParamField query="page" type="integer" default="0">
  Zero-based page index
</ParamField>

<ParamField query="size" type="integer" default="20">
  Page size
</ParamField>

<ParamField query="sort" type="array">
  Sorting criteria in format "property,(asc|desc)"
</ParamField>

## Response

<ResponseField name="content" type="array" required>
  Array of token objects

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

    <ResponseField name="name" type="string" required>
      Token name (e.g., "Ether", "USD Coin")
    </ResponseField>

    <ResponseField name="symbol" type="string" required>
      Token symbol (e.g., "ETH", "USDC")
    </ResponseField>

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

    <ResponseField name="logoUri" type="string">
      URL to token logo image (nullable)
    </ResponseField>

    <ResponseField name="lastDailyVolumeUsd" type="number" required>
      Last 24h trading volume in USD
    </ResponseField>

    <ResponseField name="extensions" type="object" required>
      Additional token metadata
    </ResponseField>

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

<ResponseField name="size" type="integer" required>
  Page size
</ResponseField>

<ResponseField name="number" type="integer" required>
  Current page number (zero-based)
</ResponseField>

<ResponseField name="totalElements" type="integer" required>
  Total number of tokens
</ResponseField>

<ResponseField name="totalPages" type="integer" required>
  Total pages available
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://starknet.api.avnu.fi/v1/starknet/tokens?page=0&size=20"
  ```

  ```typescript TypeScript theme={null}
  const params = new URLSearchParams({
    page: '0',
    size: '20'
  });

  const response = await fetch(
    `https://starknet.api.avnu.fi/v1/starknet/tokens?${params}`
  );

  const data = await response.json();
  console.log(`Found ${data.totalElements} tokens`);
  console.log(`Page ${data.number + 1} of ${data.totalPages}`);

  data.content.forEach(token => {
    console.log(`${token.symbol}: ${token.name}`);
  });
  ```

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

  params = {
      'page': 0,
      'size': 20
  }

  response = requests.get(
      'https://starknet.api.avnu.fi/v1/starknet/tokens',
      params=params
  )

  data = response.json()
  tokens = data['content']

  print(f"Found {data['totalElements']} tokens")
  print(f"Page {data['number'] + 1} of {data['totalPages']}")

  for token in tokens:
      print(f"{token['symbol']}: {token['name']}")
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "content": [
      {
        "name": "Ether",
        "address": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
        "symbol": "ETH",
        "decimals": 18,
        "logoUri": "https://assets.avnu.fi/tokens/eth.svg",
        "lastDailyVolumeUsd": 12847392,
        "extensions": {},
        "tags": ["Verified"]
      },
      {
        "name": "USD Coin",
        "address": "0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
        "symbol": "USDC",
        "decimals": 6,
        "logoUri": "https://assets.avnu.fi/tokens/usdc.svg",
        "lastDailyVolumeUsd": 8234561,
        "extensions": {},
        "tags": ["Verified"]
      }
    ],
    "size": 20,
    "number": 0,
    "totalElements": 156,
    "totalPages": 8
  }
  ```
</ResponseExample>

## Token Tags

* **Verified** - Manually verified by avnu team
* **Community** - Community-approved tokens
* **Unruggable** - Tokens from Unruggable platform
* **AVNU** - avnu ecosystem tokens
* **Unknown** - Unverified tokens