Tokenomist
  • Tokenomist
    • 👋Introduction
    • ⭐Main Page
    • 🔎Token Page
      • 📐Cliff, Linear, and Emission
      • 🔒TBD Locked
      • 🎯Precision & Assumption
  • Tokenomist Pro
    • 👑Tokenomist Pro
    • ↗️Token Emission
    • 📊Standard Allocation
    • 🏆Pro Chart
      • 💲Price Analysis
      • 🫳Post Unlocks Analysis
    • 📅Unlock Events
    • 🗝️ETH Unlocks
  • API Documents
    • 💻Introduction
    • API Endpoints
      • 📔Token List API
        • Token List API v1
        • Token List API v2
      • 📈Emission API
        • Emission API v1
        • Emission API v2
        • Emission API v3
      • 📈Allocations API
        • Allocations API v1
        • Allocations API v2
      • 📈Unlock Events API
        • Unlock Events API v1
        • Unlock Events API v2
        • Unlock Events API v3
      • 📈Daily Emission API
        • Daily Emission API v1
        • Daily Emission API v2
    • CSV Export
  • About us
    • 🔭Who we are
    • 📬Contact
    • 📢Press/ Media Kit
    • 👥Team
  • Miscellaneous
    • 📖Tokenomist Methodologies
    • ❗Disclaimer
    • ⚠️Data Update Policy
    • 📜Token Listing Criteria
    • ❓FAQ
    • 🔗Official Links
Powered by GitBook
On this page
  • Getting Started
  • Endpoints: Token List
  1. API Documents
  2. API Endpoints
  3. Token List API

Token List API v2

Overview

Start here to get a list of all tokenID to use for calling following API's. You can then use the required tokenID to call each endpoint.

⬆️ v2 update: Provides more tokens that are listed with AI method. Add more field about listing method, see below for field description

Listing Method
Definition

Human

This token is listed and verified and cross checked across multiple sources by tokenomist

AI

This token has been listed using LLM assisted with single source.

Getting Started

Base URL

https://api.unlocks.app

Authentication

Provide your api key in the x-api-key header.

GET https://api.unlocks.app/v2/token/list
HEADER: x-api-key: <YOUR_API_KEY>

Endpoints: Token List

Parameters

No parameters required.

Example:

curl -X 'GET' \
  'https://api.unlocks.app/v2/token/list' \
  -H 'x-api-key: $YOUR_API_KEY'

Response

{
    "metadata": {
        "queryDate": "2025-02-10T07:43:15Z"
    },
    "status": true,
    "data": [
        {
            "id": "1inch",
            "name": "1inch",
            "symbol": "1INCH",
            "listedMethod": "Human",
            "circulatingSupply": 1399213268.376045,
            "marketCap": 363579807,
            "maxSupply": 1499999999.997,
            "totalLockedAmount": 1748578.7999999523,
            "tbdLockedAmount": 0,
            "unlockedAmount": 1386314857.9699986,
            "untrackedAmount": 111936563.22700143,
            "hasStandardAllocation": false,
            "websiteUrl": "https://token.unlocks.app/1inch",
            "lastUpdatedDate": "2024-06-13T07:13:05Z"
        },
        {
            "id": "a3s",
            "name": "A3S",
            "symbol": "AA",
            "listedMethod": "AI",
            "circulatingSupply": 240195062.5232677,
            "marketCap": 8638466,
            "maxSupply": 1000000000,
            "totalLockedAmount": 66150000.000000015,
            "tbdLockedAmount": 900000000,
            "unlockedAmount": 33850000,
            "untrackedAmount": 0,
            "hasStandardAllocation": true,
            "websiteUrl": "https://token.unlocks.app/a3s",
            "lastUpdatedDate": "2024-11-25T03:06:24Z"
        }
    ]
}

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

Return Fields Explanation

Fields
Data Type
Description

id

string

Identifier to call for a dataset

name

string

Token Name

symbol

string

Token Symbol

listedMethod

string

Human/AI

circulatingSupply

number

Circulating supply of the token provided by external source (Will be null if no data present)

marketCap

number

Market cap of the token provided by external source (Will be null if no data present)

maxSupply

number

Max. Supply (Will be null if no data is present)

totalLockedAmount

number

Total current locked token amount

tbdLockedAmount

number

Total current TBD locked token amount

unlockedAmount

number

Total current unlocked token amount

untrackedAmount

number

Total current untracked token amount

hasStandardAllocation

boolean

Data set identifier for standard allocation dataset

websiteUrl

string

Link to Tokenomist token page

lastUpdatedDate

timestamp

Last updated date of token

PreviousToken List API v1NextEmission API

Last updated 18 days ago

📔