---
title: "Get a compact source-backed specialist answer to a difficult Bitcoin question"
method: POST
path: "/api/agent/v1/answer-question"
---

# Get a compact source-backed specialist answer to a difficult Bitcoin question

`POST /api/agent/v1/answer-question`

## Request

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

Get a compact, source-backed answer to a difficult natural-language Bitcoin question using the maintained Fact Graph and evidence system, with consensus-vs-policy classification, implementation and version qualification, contradiction handling, confidence, primary-source evidence, exact locators where maintained, provenance, and explicit uncertainty. Currentness-sensitive answers include persisted maintained source-watch state and fail safely when relevant authoritative evidence changed or requires review.

## Request body

- object
  - `query` string, required

## 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)