---
title: "Build a query-specific historical Bitcoin timeline"
method: POST
path: "/api/agent/v1/timeline"
---

# Build a query-specific historical Bitcoin timeline

`POST /api/agent/v1/timeline`

## Request

- Base URL: `https://californiabitcoin.org`
- URL: `https://californiabitcoin.org/api/agent/v1/timeline`
- Auth: none declared

Build a query-specific chronological Bitcoin research timeline that distinguishes event dates, source dates, effective dates, source-level support, exact locators, and maintained re-verification boundaries.

## Request body

- object
  - `query` string, required
  - `fromYear` integer
  - `toYear` integer
  - `limit` integer

## Response `200`

Structured deterministic California Bitcoin knowledge result

- object
  - `operation` string, required
  - `productId` string, nullable
  - `access` 'free' | 'paid', required
  - `price` object, required
    - `currency` string
    - `amountCents` integer
  - `result` object, required
  - `paymentReceipt` object

## Other responses

- `400`: Invalid input
- `402`: Payment Required. MPP uses WWW-Authenticate; x402 v2 HTTP uses PAYMENT-REQUIRED. Retry with the matching payment credential or proof.
- `503`: Payment or knowledge provider temporarily unavailable

---

[API](https://skmtc.dev/californiabitcoin/apis/california-bitcoin-agent-commerce-api.md) · [All operations](https://skmtc.dev/californiabitcoin/apis/california-bitcoin-agent-commerce-api/llms.txt) · [OpenAPI document](https://skmtc.dev/californiabitcoin/apis/california-bitcoin-agent-commerce-api/revisions/13683fe699bc?raw)