openapi: 3.0.1
info:
title: Blockchair Address Dashboards Block Dashboards API
description: The Blockchair API provides unified, multi-blockchain access to on-chain data across 40+ blockchains. It exposes per-chain dashboards (address, transaction, block), raw node data, network statistics, a SQL-like database query interface (blocks, transactions, outputs, addresses), and transaction broadcasting. Requests are authenticated with an optional `key` query parameter; up to 1440 requests per day are allowed without a key for personal or testing use.
termsOfService: https://blockchair.com/api/docs
contact:
name: Blockchair Support
url: https://github.com/Blockchair/Blockchair.Support
version: 2.0.80
servers:
- url: https://api.blockchair.com
description: Blockchair production API
security:
- apiKey: []
tags:
- name: Block Dashboards
description: Parsed block dashboards.
paths:
/{chain}/dashboards/block/{id}:
get:
operationId: getBlockDashboard
tags:
- Block Dashboards
summary: Get a block dashboard
description: Returns a parsed view of a single block, identified by height or hash, including header fields and transaction references.
parameters:
- $ref: '#/components/parameters/chain'
- name: id
in: path
required: true
description: Block height or block hash.
schema:
type: string
- $ref: '#/components/parameters/key'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/DashboardResponse'
/{chain}/dashboards/blocks/{ids}:
get:
operationId: getBlocksDashboard
tags:
- Block Dashboards
summary: Get a multi-block dashboard
description: Returns parsed views for a comma-separated set of block heights.
parameters:
- $ref: '#/components/parameters/chain'
- name: ids
in: path
required: true
description: Comma-separated list of block heights.
schema:
type: string
- $ref: '#/components/parameters/key'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/DashboardResponse'
components:
parameters:
chain:
name: chain
in: path
required: true
description: Blockchain slug (e.g. bitcoin, ethereum, litecoin, dogecoin).
schema:
type: string
example: bitcoin
key:
name: key
in: query
required: false
description: API key.
schema:
type: string
schemas:
DashboardResponse:
type: object
properties:
data:
type: object
description: Dashboard payload keyed by the requested address, transaction hash, or block id.
context:
$ref: '#/components/schemas/Context'
Context:
type: object
description: Metadata describing the request, cost, and server state.
properties:
code:
type: integer
example: 200
source:
type: string
results:
type: integer
state:
type: integer
description: Current best block height of the chain.
cache:
type: object
api:
type: object
properties:
version:
type: string
last_major_update:
type: string
next_major_update:
type: string
request_cost:
type: number
description: Number of API request units this call consumed.
time:
type: number
securitySchemes:
apiKey:
type: apiKey
in: query
name: key
description: Optional API key passed as the `key` query parameter. Up to 1440 requests per day are allowed without a key for personal/testing use.