# Blockchair — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Query Bitcoin blockchain data in real-time to check address balances, review transaction details, explore block information, and monitor network statistics. Track cryptocurrency news and compare data across multiple blockchain networks all in one place.

**Category:** Web3 & Onchain | **Website:** [blockchair.com/](https://blockchair.com/) | **Docs:** [parse.bot/marketplace/44ba3ee2-0489-4f11-9172-e26755aade6e/blockchair-com-api](https://parse.bot/marketplace/44ba3ee2-0489-4f11-9172-e26755aade6e/blockchair-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/blockchair/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get all chains stats

Retrieve statistics for all supported blockchains in a single call. Returns an object keyed by chain name (bitcoin, bitcoin-cash, ethereum, litecoin, dogecoin, dash, ripple, groestlcoin, stellar, monero, cardano, zcash, ecash, cross-chain) with each chain's current stats flattened. Each chain entry contains pricing, block, and transaction data specific to that chain's structure.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/blockchair/get-all-chains-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get bitcoin stats

Retrieve current Bitcoin blockchain statistics including block height, transaction counts, mempool data, mining difficulty, hashrate, market price, and suggested transaction fees. Returns a single snapshot of the Bitcoin network state — no parameters, one round-trip.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/blockchair/get-bitcoin-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get news

Retrieve aggregated cryptocurrency news from multiple sources. Returns the latest articles sorted by publication time descending, in multiple languages. Each article includes title, source, link, publication time, tags, and a description excerpt.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of news items to return. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/blockchair/get-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.