API overview - Chance

The Chance API is a single, synchronous endpoint: submit an intent and an action, get back a verdict and its provable receipt.

Base URL

https://harness.chance.cc

Authentication

Every request is authenticated with your API key in the x-api-key header. See Authentication.

curl https://harness.chance.cc/api/v1/intent \
  -H "x-api-key: $CHANCE_API_KEY"

The verdict response

Every verification — whether you just created it or are fetching an old one — returns the same shape:

{
  "id": "…",
  "requestHash": "0x…",
  "status": "COMPLETED",
  "verdict": "ALLOW | BLOCK | ESCALATE",
  "reasoning": "…",
  "proof": {
    "transcriptRoot": "0x…",
    "signature": "0x…",
    "judge": "0x…",
    "attested": true,
    "anchorTx": "0x…",
    "transcriptUri": "https://…"
  },
  "creditsRemaining": 49
}

verdict drives your control flow — execute only on ALLOW.
reasoning is the plain-English justification, safe to log and surface.
proof is the receipt — see Provable verdicts.

Errors

Status	Meaning
`400`	Missing `intent` or `action`.
`401`	Missing, invalid, or revoked API key.
`402`	Out of credits.

Use the Endpoints pages to try requests live with your own key.

​Base URL

​Authentication

​The verdict response

​Errors

Base URL

Authentication

The verdict response

Errors