# Blockstream on Onekey

> 11 endpoints for Blockstream (11 stable, 0 beta), 1 to 5 credits each. Category: Finance & markets. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.

Page: https://onekey.dev/platforms/blockstream
Reference (Markdown): https://onekey.dev/docs/api/blockstream.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 11 mapped Blockstream endpoints return each:

- `entity.id` (string): 8
- `entity.date` (ISO 8601 date): 6
- `package.version` (string): 3
- plus 25 platform-specific fields under `ext.`

## Endpoints

### blockstream.address

Address funded/spent totals and tx counts.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/blockstream/address?address=1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `address` (string, required): Bitcoin address
- Fields returned: `entity.id`, `ext.txCount`, `ext.fundedTxoCount`, `ext.fundedSats`, `ext.spentSats`, `ext.mempoolTxCount`
- Reference: https://onekey.dev/docs/api/blockstream/address.md

### blockstream.address_txs

Latest transactions for an address (first page).
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/blockstream/address_txs?address=1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `address` (string, required): Bitcoin address
- Fields returned: `entity.id`, `package.version`, `entity.date`, `ext.fee`, `ext.size`, `ext.weight`, `ext.confirmed`, `ext.blockHeight`
- Reference: https://onekey.dev/docs/api/blockstream/address_txs.md

### blockstream.block

Bitcoin block by hash.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/blockstream/block?hash=000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `hash` (string, required): Block hash (64 hex)
- Fields returned: `entity.id`, `entity.date`, `ext.height`, `ext.txCount`, `ext.size`, `ext.weight`, `ext.difficulty`, `ext.nonce`, `ext.merkleRoot`, `ext.previousBlockHash`
- Reference: https://onekey.dev/docs/api/blockstream/block.md

### blockstream.block_txs

First page (25) of transactions in a block.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/blockstream/block_txs?hash=000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `hash` (string, required): Block hash (64 hex)
- Fields returned: `entity.id`, `package.version`, `entity.date`, `ext.fee`, `ext.size`, `ext.weight`, `ext.confirmed`, `ext.blockHeight`
- Reference: https://onekey.dev/docs/api/blockstream/block_txs.md

### blockstream.fee_estimates

Fee-rate estimates (sat/vB) by confirmation target.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/blockstream/fee_estimates` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `ext.nextBlock`, `ext.blocks3`, `ext.blocks6`, `ext.blocks25`, `ext.blocks144`, `ext.blocks1008`
- Reference: https://onekey.dev/docs/api/blockstream/fee_estimates.md

### blockstream.mempool

Mempool summary (tx count, vsize, total fees).
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/blockstream/mempool` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `ext.count`, `ext.vsize`, `ext.totalFeeSats`
- Reference: https://onekey.dev/docs/api/blockstream/mempool.md

### blockstream.mempool_recent

Most recent transactions entering the mempool.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/blockstream/mempool_recent` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `ext.fee`, `ext.vsize`, `ext.valueSats`
- Reference: https://onekey.dev/docs/api/blockstream/mempool_recent.md

### blockstream.recent_blocks

The 10 most recent Bitcoin blocks.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/blockstream/recent_blocks` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.date`, `ext.height`, `ext.txCount`, `ext.size`, `ext.weight`, `ext.difficulty`, `ext.nonce`, `ext.merkleRoot`, `ext.previousBlockHash`
- Reference: https://onekey.dev/docs/api/blockstream/recent_blocks.md

### blockstream.tip_height

Current Bitcoin chain tip height.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/blockstream/tip_height` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `ext.height`
- Reference: https://onekey.dev/docs/api/blockstream/tip_height.md

### blockstream.tx

Bitcoin transaction summary by txid.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/blockstream/tx?txid=4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `txid` (string, required): Transaction id (64 hex)
- Fields returned: `entity.id`, `package.version`, `entity.date`, `ext.fee`, `ext.size`, `ext.weight`, `ext.confirmed`, `ext.blockHeight`
- Reference: https://onekey.dev/docs/api/blockstream/tx.md

### blockstream.tx_status

Confirmation status of a transaction.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/blockstream/tx_status?txid=4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `txid` (string, required): Transaction id (64 hex)
- Fields returned: `entity.id`, `entity.date`, `ext.confirmed`, `ext.blockHeight`
- Reference: https://onekey.dev/docs/api/blockstream/tx_status.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/blockstream/address?address=1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" \
  -H "x-api-key: YOUR_API_KEY"
```