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

# Overview

> Community-verified token data for all Starknet ERC20 tokens

## The Most Comprehensive Token API on Starknet

Access real-time data on every tradable ERC20 token with community verification, enriched metadata, and safety scores.

<CardGroup cols={3}>
  <Card title="Community Verified" icon="shield-check">
    7-member avnu Working Group reviews every token
  </Card>

  <Card title="Real-Time Data" icon="bolt">
    Every new token indexed the moment it appears on-chain
  </Card>

  <Card title="Rich Metadata" icon="database">
    Logos, tags, verification status, and more
  </Card>
</CardGroup>

## Quick Start

<CodeGroup>
  ```typescript Fetch All Tokens theme={null}
  import { fetchTokens } from '@avnu/avnu-sdk';

  const page = await fetchTokens({
    page: 0,
    size: 100
  });

  page.content.forEach(token => {
    console.log({
      name: token.name,
      symbol: token.symbol,
      address: token.address,
      verified: token.tags.includes('Community') || token.tags.includes('AVNU'),
      logo: token.logoUri,
    });
  });
  ```
</CodeGroup>

## Token Tags

A token can include tags:

* **Verified** - Tokens that include the tag `Community` or `AVNU`
* **Unknown** - Untagged tokens that user must import to swap on app.avnu.fi. Tokens would either be Verified or Unknown.
* **Community** - Tokens that are verified by the avnu community
* **avnu** - Tokens that are verified by the avnu team
* **Unruggable** - Unruggable memecoin [https://www.unruggable.meme/](https://www.unruggable.meme/)

<Info>
  **Duplicate Handling:** If multiple tokens share the same name or symbol, they are all displayed by default. However, if one of these tokens is `Verified`, only the verified version will be returned, and all `Unknown` duplicates will be hidden. This policy helps prevent confusion and protects users from potential scams or impersonations.
</Info>

### Sorting

Tokens are sorted by `lastDailyVolumeUsd` desc (non verified tokens don't have lastDailyVolumeUsd), `Verified`, tokens with `logoUri`, `Unruggable` and by name asc.

## Verify Your Token

<Card title="Submit Your Token for Verification" icon="shield-check" href="https://community.avnu.fi">
  Get your token reviewed by the avnu Working Group →
</Card>

### What is the avnu Working Group?

The **avnu Working Group** is a group of 7 trusted community members who review token submissions to ensure user safety. Tokens need **3+ approvals** to receive the `Community` verification tag.

### Two Verification Paths

1. **Community Verification** - Submit at [community.avnu.fi](https://community.avnu.fi)
   * Requires minimum \$20K TVL and \$2K daily volume
   * Reviewed by avnu Working Group members
   * Typically approved within 24-48 hours
   * Receives `Community` tag

2. **avnu Verification** - For major launches
   * Contact the avnu team on [Telegram](https://t.me/avnu_developers) for expedited verification
   * Direct review by avnu team
   * Ideal for high-profile token launches needing immediate support
   * Receives `AVNU` tag

<Info>
  Big launch coming up? The avnu team can manually verify tokens for major projects. Reach out on [Telegram](https://t.me/avnu_developers) for priority review.
</Info>

## Performance Optimization

<Tip>
  Use `If-None-Match` and `etag` headers to check if resources have changed. The server returns `304 Not Modified` if unchanged, saving bandwidth and improving load times.
</Tip>

## Rate Limits

**Public API:** 300 requests per 5 minutes (free, no API key required)

Need higher rate limits? Contact us on [Telegram](https://t.me/avnu_developers) for custom limits available to integration partners.

## FAQ

<AccordionGroup>
  <Accordion title="How often is the token list updated?" icon="clock">
    Real-time. New tokens and approvals appear within minutes.
  </Accordion>

  <Accordion title="Do I need an API key?" icon="key">
    No. The Token List API is completely free and public.
  </Accordion>

  <Accordion title="What's the difference between tags?" icon="badge-check">
    **AVNU:** Tokens verified by the avnu team
    **Community:** Tokens verified by the avnu community
    **Unruggable:** Unruggable memecoins from unruggable.meme

    Tokens with `AVNU` or `Community` tags are considered "Verified"
  </Accordion>

  <Accordion title="Can I request features?" icon="plus">
    Yes! Join [Telegram](https://t.me/avnu_developers) to suggest improvements.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={3}>
  <Card title="Swap API" icon="arrow-right-arrow-left" href="/docs/swap/index">
    Trade verified tokens with best execution
  </Card>

  <Card title="Community Platform" icon="users" href="https://community.avnu.fi">
    Submit and review tokens
  </Card>

  <Card title="API Reference" icon="code" href="/api/tokens">
    Complete endpoint documentation
  </Card>
</CardGroup>