Polkadot

Polkadot Event API

The Event API from Polkadot — 3 operation(s) for event.

GitHub OpenAPI

Operations 3

POST /api/scan/event Get event by index
POST /api/scan/event/params Get event parameters by index
POST /api/v2/scan/events List events

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-event-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-event-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-event-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 Event API
  version: '1.0'
servers:
- url: https://https://www.subscan.io/
tags:
- name: Event
paths:
  /api/scan/event:
    post:
      description: Returns event details for a specific event index.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      $ref: '#/components/schemas/subscan_internal_model.ChainEvent'
                  type: object
      summary: Get event by index
      tags:
      - Event
      x-synonyms:
      - event
      - index
      - scan
      - log
      - on-chain event
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.eventInfoParams'
        description: params
        required: true
  /api/scan/event/params:
    post:
      description: Returns parsed parameter payloads for up to 100 event indexes.
      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.ChainEventParams'
                      type: array
                  type: object
      summary: Get event parameters by index
      tags:
      - Event
      x-synonyms:
      - event
      - parameters
      - index
      - scan
      - params
      - log
      - on-chain event
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.eventParamsParams'
        description: params
        required: true
  /api/v2/scan/events:
    post:
      description: Returns paginated events with module/event filters, block constraints, and optional address matching.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        events:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.ChainEventV2Json'
                          type: array
                      type: object
                  type: object
      summary: List events
      tags:
      - Event
      x-synonyms:
      - events
      - event
      - scan
      - logs
      - on-chain events
      - log
      - on-chain event
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.eventsParams'
        description: params
        required: true
components:
  schemas:
    subscan_internal_model.ChainEvent:
      properties:
        block_num:
          type: integer
        es_params:
          items:
            type: string
          type: array
        event_id:
          type: string
        event_idx:
          type: integer
        event_index:
          type: string
        extrinsic_hash:
          type: string
        extrinsic_idx:
          type: integer
        extrinsic_module:
          type: string
        finalized:
          type: boolean
        id:
          type: integer
        module_id:
          type: string
        params:
          items:
            $ref: '#/components/schemas/subscan_internal_model.EventParam'
          type: array
        params_raw:
          type: string
        phase:
          type: integer
      type: object
    internal_server_http.eventParamsParams:
      properties:
        event_index:
          items:
            type: string
          type: array
      required:
      - event_index
      type: object
    internal_server_http.eventsParams:
      properties:
        address:
          type: string
        after_id:
          type: integer
        block_num:
          minimum: 0
          type: integer
        block_range:
          type: string
        event_id:
          type: string
        extrinsic_index:
          type: string
        finalized:
          type: boolean
        focus:
          type: string
        module:
          type: string
        module_event:
          items:
            $ref: '#/components/schemas/internal_server_http.moduleEventFilterParams'
          type: array
        order:
          enum:
          - asc
          - desc
          type: string
        page:
          description: Page number, starting from 0
          example: 0
          minimum: 0
          type: integer
        phase:
          enum:
          - 0
          - 1
          - 2
          type: integer
        row:
          description: Data size per page
          example: 10
          maximum: 100
          minimum: 1
          type: integer
      type: object
    internal_server_http.moduleEventFilterParams:
      properties:
        event_id:
          type: string
        module:
          type: string
      type: object
    subscan_internal_model.ChainEventV2Json:
      properties:
        block_timestamp:
          type: integer
        event_id:
          type: string
        event_index:
          type: string
        extrinsic_hash:
          type: string
        extrinsic_index:
          type: string
        finalized:
          type: boolean
        id:
          type: integer
        module_id:
          type: string
        phase:
          type: integer
      type: object
    internal_server_http.eventInfoParams:
      properties:
        event_index:
          type: string
      required:
      - event_index
      type: object
    subscan_internal_model.ChainEventParams:
      properties:
        event_index:
          type: string
        params:
          items:
            $ref: '#/components/schemas/subscan_internal_model.EventParam'
          type: array
        params_decode: {}
      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
    internal_server_http.J:
      properties:
        code:
          example: 0
          type: integer
        data: {}
        generated_at:
          example: 1699600641
          type: integer
        message:
          example: Success
          type: string
      type: object