Skip to main content
POST

Authorizations

x-api-key
string
header
required

An API key (chance_sk_live_…) from https://harness.chance.cc/keys.

Body

application/json
intent
string
required

The rules the action must satisfy: mandate, limits, thesis. Must be non-empty after trimming.

Example:

"Only buy favorites priced at or above 95c. No longshots. Max $10 per market."

action
required

The proposed action. A string is judged as written (mode: semantic). An object is classified by a venue adapter when one matches (mode: structured); an unmatched object is judged as JSON (mode: semantic).

Example:

"Buy YES on the Will-X-win market at 21c for $10."

venue
string

Venue adapter to use. Ids: hyperliquid, limitless, polymarket, dimes, myriad, orderly, derive, lifi, meow, liquid, robinhood, x402, agentcards, uniswap, solana, starknet, alchemy. The value is lowercased, stripped of punctuation and matched against ids, aliases (hl, poly, evm, eth, base, sol, rh, lyra, ...) and id prefixes. An unknown value is ignored and object actions fall back to structural detection.

Example:

"hyperliquid"

context
object

Facts for the judge, shown as JSON under CONTEXT. context.reference is handled separately.

preset
string
default:generic

Judge prompt. Omit it; generic is the documented value and the fallback for any unknown value.

Response

Verdict produced.

id
string

Verification id (UUID).

requestHash
string

Per-run identifier (0x, 32 bytes). Not a hash of the payload.

status
enum<string>
Available options:
COMPLETED
verdict
enum<string> | null

Execute only on ALLOW. BLOCK, ESCALATE and null mean do not execute.

Available options:
ALLOW,
BLOCK,
ESCALATE,
null
reasoning
string | null

The judge's decisive reason.

mode
enum<string>
Available options:
structured,
semantic
venue
string | null

Adapter id used, or null.

actionFamily
string | null

order, margin, withdrawal, transfer, staking, vault, position, swap, payment, subaccount, permission or unknown. Null without a venue.

actionType
string | null

The venue's own action name as submitted, when the classifier found one.

proof
object
creditsRemaining
integer