Polkadot

Polkadot Tokens API

The Tokens API from Polkadot — 8 operation(s) for tokens.

GitHub OpenAPI

Operations 8

POST /api/scan/search/tokens Search tokens by name, symbol, or unique ID
GET /api/scan/token List tokens by symbol
GET /api/scan/token/price List token prices
GET /api/scan/token/unique_id List tokens by unique ID
POST /api/v2/scan/token/native Get native token
GET /api/v2/scan/token/providers List token providers
POST /api/v2/scan/token/search Search tokens (v2)
POST /api/v2/scan/tokens List tokens (v2)

Documentation

📖
Documentation
https://support.subscan.io/
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/polkadot/refs/heads/main/rate-limits/subscan.yml
📖
Documentation
https://docs.polkadot.com/chain-interactions/query-data/query-rest/
📖
Documentation
https://github.com/paritytech/polkadot-rest-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/polkadot/refs/heads/main/openapi/polkadot-tokens-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/paritytech/substrate-api-sidecar
📦
GitHubRepository
https://github.com/paritytech/polkadot-rest-api

Other Resources

🔗
PostmanCollection
https://documenter.getpostman.com/view/1618960/TVCe1oRU
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/polkadot/refs/heads/main/plans/subscan.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/polkadot/refs/heads/main/finops/subscan.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/polkadot-tokens-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

polkadot-tokens-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: bruce.sun@itering.io
    name: API Support
    url: http://www.swagger.io/support
  description: This is a subscan API server.
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: http://swagger.io/terms/
  title: Subscan Tokens API
  version: '1.0'
servers:
- url: https://https://www.subscan.io/
tags:
- name: Tokens
paths:
  /api/scan/search/tokens:
    post:
      description: Searches token metadata by a free-form token key such as token name, ticker symbol, or unique ID.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.TokenSearchJson'
                          type: array
                      type: object
                  type: object
      summary: Search tokens by name, symbol, or unique ID
      tags:
      - Tokens
      x-synonyms:
      - search
      - token
      - name/symbol
      - id
      - tokens
      - scan
      - lookup
      - find
      - query
      - asset
      - coin
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.searchTokenParams'
        description: params
        required: true
  /api/scan/token:
    get:
      description: Returns network token symbols and token metadata keyed by symbol.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        detail:
                          additionalProperties:
                            $ref: '#/components/schemas/subscan_internal_service_scan_token.Token'
                          type: object
                        token:
                          items:
                            type: string
                          type: array
                      type: object
                  type: object
      summary: List tokens by symbol
      tags:
      - Tokens
      x-synonyms:
      - tokens
      - symbol
      - scan
      - token
      - asset
      - coin
  /api/scan/token/price:
    get:
      description: Returns the latest price list for available tokens.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/subscan_internal_model.AssetTokenPriceJson'
                      type: array
                  type: object
      summary: List token prices
      tags:
      - Tokens
      x-synonyms:
      - token
      - prices
      - tokens
      - scan
      - price
      - asset
      - coin
      - rate
      - valuation
  /api/scan/token/unique_id:
    get:
      description: Returns network token symbols, unique IDs, and token metadata keyed by unique_id.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        detail:
                          additionalProperties:
                            $ref: '#/components/schemas/subscan_internal_service_scan_token.Token'
                          type: object
                        token:
                          items:
                            type: string
                          type: array
                        unique_id:
                          items:
                            type: string
                          type: array
                      type: object
                  type: object
      summary: List tokens by unique ID
      tags:
      - Tokens
      x-synonyms:
      - tokens
      - unique
      - id
      - scan
      - token
      - asset
      - coin
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.TokenUniqueIDParams'
        description: params
        required: true
  /api/v2/scan/token/native:
    post:
      description: Returns the native token and provider information for the current network.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        provider:
                          type: string
                        token:
                          $ref: '#/components/schemas/internal_server_http.tokenJson'
                      type: object
                  type: object
      summary: Get native token
      tags:
      - Tokens
      x-synonyms:
      - native
      - token
      - tokens
      - scan
      - asset
      - coin
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.tokenNativeParam'
        description: param
        required: true
  /api/v2/scan/token/providers:
    get:
      description: Returns active token providers and their capabilities.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        providers:
                          items:
                            $ref: '#/components/schemas/internal_server_http.providerActiveJson'
                          type: array
                      type: object
                  type: object
      summary: List token providers
      tags:
      - Tokens
      x-synonyms:
      - token
      - providers
      - tokens
      - scan
      - asset
      - coin
  /api/v2/scan/token/search:
    post:
      description: Returns tokens grouped by provider for the requested unique IDs.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      additionalProperties:
                        items:
                          $ref: '#/components/schemas/internal_server_http.tokenJson'
                        type: array
                      type: object
                  type: object
      summary: Search tokens (v2)
      tags:
      - Tokens
      x-synonyms:
      - search
      - tokens
      - scan
      - token
      - lookup
      - find
      - query
      - asset
      - coin
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.tokensSearchParam'
        description: param
        required: true
  /api/v2/scan/tokens:
    post:
      description: Returns paginated tokens from the selected provider with optional search, ordering, and extended fields.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        provider:
                          type: string
                        tokens:
                          items:
                            $ref: '#/components/schemas/internal_server_http.tokenJson'
                          type: array
                      type: object
                  type: object
      summary: List tokens (v2)
      tags:
      - Tokens
      x-synonyms:
      - tokens
      - scan
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.tokensV2Param'
        description: param
        required: true
components:
  schemas:
    internal_server_http.tokensSearchParam:
      properties:
        include_extends:
          type: boolean
        unique_ids:
          items:
            type: string
          type: array
      type: object
    internal_server_http.providerActiveJson:
      properties:
        can_legacy:
          type: boolean
        id:
          type: string
        is_primary:
          type: boolean
        name:
          type: string
      type: object
    internal_server_http.tokenJson:
      properties:
        category:
          type: string
        currency_id:
          type: string
        decimals:
          type: integer
        extends:
          $ref: '#/components/schemas/internal_server_http.tokenExtendsJson'
        is_native:
          type: boolean
        market_cap:
          type: string
        metadata: {}
        name:
          type: string
        price:
          type: string
        symbol:
          type: string
        total_issuance:
          type: string
        transfer_count:
          type: integer
        unique_id:
          type: string
      type: object
    subscan_internal_model.AssetTokenPriceJson:
      properties:
        price:
          type: string
        price_change:
          type: string
        unique_id:
          type: string
      type: object
    internal_server_http.tokenNativeParam:
      properties:
        include_extends:
          type: boolean
      type: object
    subscan_internal_service_scan_token.Token:
      properties:
        asset_type:
          $ref: '#/components/schemas/subscan_internal_service_scan_token.AssetType'
        available_balance:
          type: string
        bonded_locked_balance:
          type: string
        conviction_lock_balance:
          type: string
        democracy_locked_balance:
          type: string
        display_name:
          type: string
        election_locked_balance:
          type: string
        external_data:
          $ref: '#/components/schemas/subscan_internal_service_scan_token.ExternalDataSource'
        free_balance:
          type: string
        inflation:
          type: string
        locked_balance:
          type: string
        nominator_bonded:
          type: string
        price:
          type: string
        price_change:
          type: string
        reserved_balance:
          type: string
        symbol:
          type: string
        token_decimals:
          type: integer
        total_issuance:
          type: string
        treasury_balance:
          type: string
        unbonded_locked_balance:
          type: string
        unique_id:
          type: string
        validator_bonded:
          type: string
        vesting_balance:
          type: string
      type: object
    subscan_internal_service_scan_token.ExternalDataSource:
      properties:
        authorization_source:
          type: string
        circulating_supply:
          type: string
        source:
          type: string
      type: object
    internal_server_http.tokensV2Param:
      properties:
        include_extends:
          type: boolean
        order:
          enum:
          - asc
          - desc
          type: string
        order_field:
          enum:
          - currency_id
          - symbol
          - holders
          - token_id
          type: string
        page:
          description: Page number, starting from 0
          example: 0
          minimum: 0
          type: integer
        provider:
          type: string
        row:
          description: Data size per page
          example: 10
          maximum: 100
          minimum: 1
          type: integer
        search:
          description: symbol
          maxLength: 256
          minLength: 1
          type: string
      type: object
    internal_server_http.TokenUniqueIDParams:
      properties:
        new_algorithm:
          description: use new algorithm sum(free - max(0, frozen - reserve))
          type: boolean
      type: object
    internal_server_http.tokenExtendsJson:
      properties:
        holders:
          type: integer
      type: object
    subscan_internal_service_scan_token.AssetType:
      enum:
      - native
      - builtin
      type: string
      x-enum-varnames:
      - TypeNative
      - TypeBuiltin
    internal_server_http.searchTokenParams:
      properties:
        key:
          type: string
      required:
      - key
      type: object
    subscan_internal_model.TokenSearchJson:
      properties:
        category:
          type: string
        contract:
          type: string
        currency_id:
          type: string
        price:
          type: string
        symbol:
          type: string
        unique_id:
          type: string
      type: object
    internal_server_http.J:
      properties:
        code:
          example: 0
          type: integer
        data: {}
        generated_at:
          example: 1699600641
          type: integer
        message:
          example: Success
          type: string
      type: object