Solidus Labs Token API API

openapi: 3.2.0
info:
  title: Token Token API API
  version: '2.0'
  description: Published by Solidus Labs as the TokenSniffer API. Assembled verbatim from the OpenAPI 3.1.0 fragments Solidus Labs publishes on each operation page of https://tokensniffer.readme.io/reference/ (llms.txt markdown rendering). No operation, parameter, schema or example was authored by API Evangelist.
  contact:
    name: TokenSniffer Support
    url: https://tokensniffer.com/contact
  x-provider: Solidus Labs
  x-product: TokenSniffer
servers:
- url: https://tokensniffer.com/api/v2/tokens
security:
- sec0: []
tags:
- name: Token API
paths:
  /{chain_id}/{address}:
    get:
      summary: Get Token
      description: Get token information, metrics, similar contracts, and Smell Test results including token score and scam status.  Available with the Pro and Enterprise plans.
      operationId: get-token-results
      parameters:
      - name: chain_id
        in: path
        description: Chain identifier
        schema:
          type: integer
          format: int32
        required: true
      - name: address
        in: path
        description: Token contract address
        schema:
          type: string
        required: true
      - name: include_metrics
        in: query
        description: Include on-chain metrics such as holders and liquidity (permissions, swap_simulation, balances, pools, score)
        schema:
          type: boolean
          default: false
      - name: include_tests
        in: query
        description: Include Smell Test results
        schema:
          type: boolean
          default: false
      - name: include_similar
        in: query
        description: Include similar contracts results
        schema:
          type: boolean
          default: false
      - name: block_until_ready
        in: query
        description: Block response until status="ready"
        schema:
          type: boolean
          default: false
      - name: X-API-Key
        in: header
        description: Your assigned API key
        required: true
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                (include_metrics=true, include_tests=true):
                  value: "{\n  \"message\": \"OK\",\n  \"status\": \"ready\",\n  \"chain_id\": 56, \n  \"address\": \"0x0671d181e36f207b22df910fb9d1f2d981a6d574\",\n  \"name\": \"ChildDoge\",\n  \"symbol\": \"ChildDoge\",\n  \"total_supply\": 123,\n  \"decimals\": 9,\n  \"created_at\": 1624455637000,\n  \"deployer_address\": \"0x123\",\n  \"is_flagged\": true,\n  \"exploits\": [\n    \"honeypot\"\n  ],\n  \"contract\": {\n      \"is_source_verified\": true,\n      \"has_mint\": true,\n      \"has_fee_modifier\": false,\n      \"has_max_transaction_amount\": false,\n      \"has_blocklist\": false,\n      \"has_proxy\": false,\n      \"has_pausable\": true\n  }, \n  \"permissions\": {\n    \"owner_address\": \"0x0671d181e36f207b22df910fb9d1f2d981a6d574\",\n    \"is_ownership_renounced\": false\n  },\n  \"swap_simulation\": {\n    \"is_sellable\": true,\n    \"buy_fee\": 1,\n    \"sell_fee\": 0\n  },\n  \"balances\": {\n    \"burn_balance\": 1234,\n    \"lock_balance\": 1234,\n    \"deployer_balance\": 1234,\n    \"owner_balance\": 123,  \n    \"top_holders\": [\n      {\n        \"address\": \"0x383a1d12a354b7cdbd95fc7a411b9a4e327c7058\",\n        \"balance\": 71767430324769.23,\n        \"is_contract\": false\n      }\n    ]\n  },\n  \"pools\": [\n    {\n      \"address\": \"0xe535e8b16fa51c45b8f36d9a07b11823522bca56\",\n      \"name\": \"Uniswap v2\",\n      \"base_address\": \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n      \"base_symbol\": \"ETH\",\n      \"total_supply\": 9472911695158690000000,\n      \"decimals\": 18,\n      \"base_reserve\": 5.004710819206843,\n      \"owner_balance\": 0,\n      \"deployer_balance\": 7401466896810723000,\n      \"burn_balance\": 219973065873940400000,\n      \"lock_balance\": 9245537162387938000000,\n      \"locks\": [\n        {\n          \"address\": \"0xe2fe530c047f2d85298b07d9333c05737f1435fb\",\n          \"name\": \"TrustSwap\",\n          \"balance\": 9245537162387938000000,\n          \"start_time\": 1673638451,\n          \"end_time\": 1673638451\n        }\n      ],\n      \"top_holders\": [\n        {\n          \"address\": \"0x383a1d12a354b7cdbd95fc7a411b9a4e327c7058\",\n          \"balance\": 71767430324769.23,\n          \"is_contract\": false\n        }\n      ]\n    }\n  ],\n  \"tests\": [\n    {\n      \"id\": \"testForInadeqateLiquidityLockedOrBurned\",\n      \"description\": \"At least 95% of liquidity locked/burned\",\n      \"result\": false,\n      \"value\": 9465510228261878000000,\n      \"value_pct\": 0.9992186703375907\n    }\n  ],\n  \"similar\": [\n    \"chainId\": \"ETH\",\n    \"address\": \"0x868d070fe968c3239de611867bbfb92233a09003\",\n    \"score\": 99\n  ],\n  \"score\": 0, \n  \"risk_level\": \"high\"\n}"
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  message: \"reason\"\n}"
      deprecated: false
      security: []
      x-source-doc: https://tokensniffer.readme.io/reference/get-token-results
      tags:
      - Token API
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: query
      name: apikey
x-evidence:
  fetched: '2026-08-05'
  method: searched
  sources:
  - https://tokensniffer.readme.io/reference/get-malicious-tokens
  - https://tokensniffer.readme.io/reference/get-token-results
  - https://tokensniffer.readme.io/reference/list-corrected-tokens
  - https://tokensniffer.readme.io/reference/list-latest-tokens
  note: Each source page embeds a "# OpenAPI definition" JSON block authored by the provider in ReadMe; those blocks were parsed and merged by shared info.title + servers[].url. Nothing added.