Polkadot

Polkadot Bifrost API

The Bifrost API from Polkadot — 2 operation(s) for bifrost.

GitHub OpenAPI

Operations 2

POST /api/scan/liquidstaking/operations LiquidStaking operation record list
POST /api/scan/tokengateway/transfers List Bifrost TokenGateway transfers

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-bifrost-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-bifrost-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-bifrost-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 Bifrost API
  version: '1.0'
servers:
- url: https://https://www.subscan.io/
tags:
- name: Bifrost
paths:
  /api/scan/liquidstaking/operations:
    post:
      description: This API is only available for bifrost/bifrost-kusama network.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                properties:
                  code:
                    type: integer
                  data:
                    properties:
                      count:
                        type: integer
                      list:
                        items:
                          $ref: '#/components/schemas/internal_pluginv2_pallets_liquidStaking.OperationRecordJson'
                        type: array
                    type: object
                  message:
                    type: string
                type: object
      summary: LiquidStaking operation record list
      tags:
      - Bifrost
      x-synonyms:
      - liquidstaking
      - operation
      - record
      - bifrost
      - scan
      - operations
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_pluginv2_pallets_liquidStaking.operationParams'
        description: params
        required: true
  /api/scan/tokengateway/transfers:
    post:
      description: Returns paginated Bifrost TokenGateway transfer records for one address from the dedicated TokenGateway table. Supports filtering by transfer status, source and destination accounts, source and destination chains, block time range, scaled amount range, and asset unique ID. Results are ordered by newest block timestamp first, then by descending row id. The address must be a valid Substrate or EVM address that can be normalized into the indexed account format.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                properties:
                  code:
                    type: integer
                  data:
                    $ref: '#/components/schemas/subscan_internal_model.BifrostTokenGatewayTransferListJSON'
                  message:
                    type: string
                type: object
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                properties:
                  code:
                    type: integer
                  message:
                    type: string
                type: object
      summary: List Bifrost TokenGateway transfers
      tags:
      - Bifrost
      x-synonyms:
      - tokengateway
      - hyperbridge
      - cross-chain
      - transfers
      - bifrost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_pluginv2_customizeds_bifrost_tokengateway.TransfersParams'
        description: address, pagination, and optional TokenGateway filters
        required: true
components:
  schemas:
    subscan_internal_model.RegistrationJudgementJson:
      properties:
        index:
          type: integer
        judgement:
          type: string
      type: object
    subscan_internal_model.SampleIdentity:
      properties:
        display:
          type: string
        identity:
          type: boolean
        judgements:
          items:
            $ref: '#/components/schemas/subscan_internal_model.RegistrationJudgementJson'
          type: array
        parent:
          $ref: '#/components/schemas/subscan_internal_model.AccountParentJson'
      type: object
    internal_pluginv2_pallets_liquidStaking.OperationRecordJson:
      properties:
        account:
          $ref: '#/components/schemas/subscan_internal_model.AccountDisplay'
        block_num:
          type: integer
        block_timestamp:
          type: integer
        event_id:
          type: string
        event_index:
          type: string
        extrinsic_index:
          type: string
        id:
          type: integer
        module_id:
          type: string
        param:
          items:
            $ref: '#/components/schemas/subscan_internal_model.EventParam'
          type: array
      type: object
    subscan_internal_model.AccountParentJson:
      properties:
        address:
          type: string
        display:
          type: string
        identity:
          type: boolean
        sub_symbol:
          type: string
      type: object
    subscan_internal_model.EvmAccountDisplay:
      properties:
        contract_name:
          type: string
        verify_source:
          type: string
      type: object
    subscan_internal_model.BifrostTokenGatewayAssetJSON:
      properties:
        amount:
          type: string
        decimals:
          type: integer
        symbol:
          type: string
        unique_id:
          type: string
      type: object
    subscan_internal_model.BifrostTokenGatewayTransferJSON:
      properties:
        asset:
          $ref: '#/components/schemas/subscan_internal_model.BifrostTokenGatewayAssetJSON'
        block_num:
          type: integer
        block_timestamp:
          type: integer
        cross_chain_status:
          type: integer
        dest_account:
          $ref: '#/components/schemas/subscan_internal_model.AccountDisplay'
        dest_chain:
          type: string
        event_index:
          type: string
        event_type:
          type: string
        extrinsic_index:
          type: string
        id:
          type: integer
        source_account:
          $ref: '#/components/schemas/subscan_internal_model.AccountDisplay'
        source_chain:
          type: string
        status:
          $ref: '#/components/schemas/subscan_internal_model.BifrostTokenGatewayStatus'
      type: object
    internal_pluginv2_pallets_liquidStaking.operationParams:
      properties:
        address:
          type: string
        module:
          items:
            type: string
          type: array
        page:
          description: Page number, starting from 0
          example: 0
          minimum: 0
          type: integer
        row:
          description: Data size per page
          example: 10
          maximum: 100
          minimum: 1
          type: integer
      type: object
    subscan_internal_model.AccountDisplay:
      properties:
        account_index:
          type: string
        address:
          description: Current network account
          type: string
        display:
          type: string
        evm_address:
          type: string
        evm_contract:
          $ref: '#/components/schemas/subscan_internal_model.EvmAccountDisplay'
        identity:
          type: boolean
        judgements:
          items:
            $ref: '#/components/schemas/subscan_internal_model.RegistrationJudgementJson'
          type: array
        merkle:
          $ref: '#/components/schemas/subscan_internal_model.MerkleTag'
        parent:
          allOf:
          - $ref: '#/components/schemas/subscan_internal_model.AccountParentJson'
          description: Parent account
        people:
          $ref: '#/components/schemas/subscan_internal_model.SampleIdentity'
      type: object
    internal_pluginv2_customizeds_bifrost_tokengateway.TransfersParams:
      properties:
        address:
          type: string
        after_id:
          type: integer
        amount_scale_max:
          type: string
        amount_scale_min:
          type: string
        asset_unique_id:
          type: string
        either_chain:
          description: either_chain is an optional filter that applies to both source and destination chain fields when from_chain and to_chain are not provided, allowing for flexible querying of transfers involving a specific chain regardless of direction.
          type: string
        from:
          type: string
        from_chain:
          type: string
        page:
          minimum: 0
          type: integer
        row:
          maximum: 100
          minimum: 1
          type: integer
        status:
          allOf:
          - $ref: '#/components/schemas/subscan_internal_model.BifrostTokenGatewayStatus'
          enum:
          - pending
          - success
          - failed
          - timeout
        time_end:
          minimum: 1
          type: integer
        time_start:
          minimum: 1
          type: integer
        to:
          type: string
        to_chain:
          type: string
      required:
      - row
      type: object
    subscan_internal_model.MerkleTag:
      properties:
        address_type:
          type: string
        tag_name:
          type: string
        tag_subtype:
          type: string
        tag_type:
          type: string
      type: object
    subscan_internal_model.EventParam:
      properties:
        name:
          type: string
        raw_value:
          items:
            type: integer
          type: array
        type:
          type: string
        type_name:
          type: string
        value: {}
      type: object
    subscan_internal_model.BifrostTokenGatewayStatus:
      enum:
      - pending
      - success
      - failed
      - timeout
      type: string
      x-enum-varnames:
      - BifrostTokenGatewayStatusPending
      - BifrostTokenGatewayStatusSuccess
      - BifrostTokenGatewayStatusFailed
      - BifrostTokenGatewayStatusTimeout
    subscan_internal_model.BifrostTokenGatewayTransferListJSON:
      properties:
        count:
          type: integer
        list:
          items:
            $ref: '#/components/schemas/subscan_internal_model.BifrostTokenGatewayTransferJSON'
          type: array
      type: object