Skip to main content

Overview

Fetch exchangeable tokens from avnu with optional filtering by tags and search. The SDK handles pagination and response parsing automatically.

SDK Method

fetchTokens(
  request?: GetTokensRequest,
  options?: AvnuOptions
): Promise<Page<Token>>

Parameters

request
GetTokensRequest
Optional request parameters
options
AvnuOptions
Optional SDK configuration

Returns

Returns Promise<Page<Token>> - Paginated response with token list.
interface Page<Token> {
  content: Token[];
  totalPages: number;
  totalElements: number;
  size: number;
  number: number;
}

type TokenTag = 'Unknown' | 'Verified' | 'Community' | 'Unruggable' | 'AVNU';

interface Token {
  address: string;
  name: string;
  symbol: string;
  decimals: number;
  logoUri: string | null;
  lastDailyVolumeUsd: number;
  extensions: { [key: string]: string };
  tags: TokenTag[];
}

Examples

import { fetchTokens } from '@avnu/avnu-sdk';

// Get first 100 tokens
const result = await fetchTokens();

console.log(`Total tokens: ${result.totalElements}`);
console.log(`Tokens on this page: ${result.content.length}`);

result.content.forEach(token => {
  console.log(`${token.symbol}: ${token.name}`);
  console.log(`  Address: ${token.address}`);
  console.log(`  Tags: ${token.tags.join(', ')}`);
});

Token Tags

Available tags to filter tokens:
TagDescription
VerifiedManually verified by avnu team
CommunityCommunity-approved (3+ avnu Working Group approvals)
UnruggableUnruggable memecoin
AVNUavnu team verified token
UnknownToken without verification status