# Blockchain.com Total Transactions Chart API

> Blockchain.com Total Transactions Chart API is a paid API for AI agents from api.blockchain.info, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Returns historical chart data for the total cumulative number of Bitcoin transactions on the blockchain over a specified time period

## Facts

- Endpoint: POST https://api.blockchain.info/explorer-gateway-kt/x402/charts/n-transactions-total?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockchain-com-total-transactions-chart-api-23c0a328
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g3VaDtJ2U2GGeNWU1oE03

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockchain-com-total-transactions-chart-api-23c0a328 -d '<json body>'
```

Example prompt: Pull the total cumulative Bitcoin transactions chart from Blockchain.com for the past 3 years in JSON format, using a 24-hour rolling average.

## When to prefer this

Choose this endpoint when you need authoritative historical cumulative Bitcoin transaction count data directly from Blockchain.com's own explorer. Prefer it over third-party aggregators when accuracy and source trustworthiness matter. Ideal for charting long-term network growth trends, generating reports, or feeding blockchain analytics pipelines. Best when you need flexible time ranges and rolling average smoothing built in.

## Known failure modes

- Invalid timespan format returns 400 error
- Invalid rollingAverage window format returns 400 error
- Insufficient USDC balance or payment failure returns 402 Payment Required
- Rate limiting may return 429 Too Many Requests
- Server-side issues may return 500 or 503 errors
- Invalid format enum value (not json or csv) returns validation error

## How this service works

Paid AI-agent access to Blockchain.com Explorer API

## Output

Returns a time-series dataset of cumulative total Bitcoin transactions, including timestamps and values. In JSON mode, may include metadata about the chart. In CSV mode, returns two columns: timestamp and value. Supports rolling average smoothing over configurable windows (e.g. 8h, 24h) and optional sampling to reduce data point density.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cors": {
   "type": "boolean",
   "default": false,
   "description": "Enable CORS headers"
  },
  "format": {
   "enum": [
    "json",
    "csv"
   ],
   "type": "string",
   "default": "json",
   "description": "Response format:\n- `json` — Returns structured JSON with metadata and values\n- `csv` — Returns raw CSV data with timestamp and value columns (no metadata)\n"
  },
  "sampled": {
   "type": "boolean",
   "default": true,
   "description": "Apply sampling to reduce data points"
  },
  "metadata": {
   "type": "boolean",
   "default": false,
   "description": "Include metadata in response"
  },
  "timespan": {
   "type": "string",
   "default": "1y",
   "example": "1y",
   "description": "Time period (e.g., \"24h\", \"7d\", \"1y\", \"3y\")"
  },
  "rollingAverage": {
   "type": "string",
   "default": "8h",
   "example": "8h",
   "description": "Rolling average window (e.g., \"8h\", \"24h\")"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "format": "application/json",
 "example": {
  "name": "Total Number of Transactions",
  "unit": "Transactions",
  "period": "day",
  "status": "ok",
  "values": [
   {
    "x": 1704067200,
    "y": 1148231456
   },
   {
    "x": 1704153600,
    "y": 1148684312
   }
  ],
  "description": "Total Number of transactions"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockchain-com-total-transactions-chart-api-23c0a328/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockchain.info](https://www.zero.xyz/host/api.blockchain.info/llms.txt)