Skip to main content
GET
/
v2
/
token
/
list
curl -X 'GET' \
  'https://api.unlocks.app/v2/token/list' \
  -H 'x-api-key: $YOUR_API_KEY'
{
    "metadata": {
        "queryDate": "2025-02-10T07:43:15Z"
    },
    "status": true,
    "data": [
        {
            "id": "1inch",
            "name": "1inch",
            "symbol": "1INCH",
            "listedMethod": "INTERNAL",
            "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"
        }
    ]
}
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 MethodDefinition
INTERNALThis token is listed and verified and cross checked across multiple sources by tokenomist
AIThis token has been listed using LLM assisted with single source.
EXTERNALThis token is listed directly by the project team. It is first-party data and comes solely from the project’s own source.

Response

metadata
object
status
boolean
Request status
data
object[]
curl -X 'GET' \
  'https://api.unlocks.app/v2/token/list' \
  -H 'x-api-key: $YOUR_API_KEY'
{
    "metadata": {
        "queryDate": "2025-02-10T07:43:15Z"
    },
    "status": true,
    "data": [
        {
            "id": "1inch",
            "name": "1inch",
            "symbol": "1INCH",
            "listedMethod": "INTERNAL",
            "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"
        }
    ]
}