LiquidSwap Docs
  • Welcome to LiquidSwap
    • Key Features
  • Using The LiquidSwap Dapp
    • Swapping
    • Revoke Approvals
  • API
    • Using The API
      • Find Pools
      • Route Finding
      • Token List
      • Token Balances
      • Interacting with the Smart Contract
Powered by GitBook
On this page
  1. API
  2. Using The API

Token List

Token List

Returns a list of all tracked tokens with their metadata.

Endpoint: GET /tokens

Parameters:

Name
Type
Description
Required

search

string

Filter tokens by address, name, or symbol

No

limit

number

Maximum number of tokens to return

No

metadata

boolean

When "false", returns only addresses

No

Note: Tokens are always sorted by 24-hour transfer count in descending order (highest first).

Example Requests:

GET https://api.liqd.ag/tokens
GET https://api.liqd.ag/tokens?limit=10
GET https://api.liqd.ag/tokens?search=HYPE
GET https://api.liqd.ag/tokens?metadata=false
GET https://api.liqd.ag/tokens?limit=5&search=USD

Example Response (with metadata):

{
  "success": true,
  "data": {
    "tokens": [
      {
        "address": "0x47bb061C0204Af921F43DC73C7D7768d2672DdEE",
        "name": "Token One",
        "symbol": "TOKEN1",
        "decimals": 18,
        "transfers24h": 1250
      },
      {
        "address": "0xF26A8ab118f4C46A2D3C0C5cF4bf446008efBf8c",
        "name": "Token Two",
        "symbol": "TOKEN2",
        "decimals": 18,
        "transfers24h": 950
      }
    ],
    "count": 2,
    "limitedCount": 2,
    "searchApplied": false,
    "limitApplied": false,
    "serviceStatus": "running",
    "lastProcessedBlock": "12345678"
  }
}

Example Response (addresses only):

{
  "success": true,
  "data": {
    "addresses": [
      "0x47bb061C0204Af921F43DC73C7D7768d2672DdEE",
      "0xF26A8ab118f4C46A2D3C0C5cF4bf446008efBf8c"
    ],
    "count": 2,
    "limitedCount": 2,
    "searchApplied": false,
    "limitApplied": false,
    "serviceStatus": "running",
    "lastProcessedBlock": "12345678"
  }
}
PreviousRoute FindingNextToken Balances

Last updated 1 month ago