Arbiter-as-a-Service

Verify Evidence

Run Ring 2 arbiter evaluation on arbitrary evidence.

This is the public Arbiter-as-a-Service endpoint. External marketplaces can POST evidence payloads and receive a dual-inference verdict they can use to drive their own payment flows.

The caller must provide either:

  1. A pre-computed PHOTINT score in photint_score (if they ran their own Ring 1), OR
  2. Evidence that the arbiter's CHEAP tier can evaluate without running LLM inference.

Tier is determined by bounty_usd:

  • bounty < $1 -> CHEAP ($0 cost)
  • bounty < $10 -> STANDARD (~$0.001)
  • bounty >= $10 -> MAX (~$0.003)

Cost cap: max 10% of bounty_usd.

Returns verdict, confidence, cryptographic hashes (keccak256), and ring breakdown. Idempotent: same inputs -> same evidence_hash.

post/api/v1/arbiter/verify

Request

  • Base URL: https://api.execution.market
  • URL: https://api.execution.market/api/v1/arbiter/verify
  • Auth: API key in header Signature-Input

Request body

evidenceobject required

Evidence payload to evaluate (arbitrary dict)

bounty_usdnumber

Task bounty (drives tier routing and cost cap)

photint_scorenumber nullable

Optional caller-provided Ring 1 (PHOTINT) score

photint_confidencenumber nullable

Optional Ring 1 confidence

Response

Successful Response

verdictstring required
tierstring required
aggregate_scorenumber required
confidencenumber required
evidence_hashstring required
commitment_hashstring required
reasonstring nullable required
disagreementboolean required
cost_usdnumber required
latency_msinteger required
gradestring nullable

Letter grade: A (>=90), B (>=80), C (>=70), D (>=60), F (<60)

authenticity_scorenumber nullable

Ring 1 (PHOTINT) authenticity score (0.0-1.0)

completion_scorenumber nullable

Ring 2 semantic completion score (0.0-1.0, avg of Ring 2 providers)

summarystring nullable

Human-readable verdict message (max 500 chars)

check_detailsobject[] nullable

Individual check results with status (OK/FAIL/WARN), label, and detail

Changes

No recorded changes to this operation across all 1 revision of this API.