KORVAL
API v1 · BUILT FOR ROBINHOOD CHAIN

The spend-control API for AI agents.

One call before every payment. Budgets, approvals, anomaly detection and a tamper-proof ledger, decided at the edge.

KORVAL LEDGER
SHA-256 CHAIN
LEDGER ENTRIES
—
API CALLS · 24H
—
01 · QUICKSTART

Wrap your payment
in two calls.

01
Get a key

Create a workspace. Each agent gets its own scoped key.

02
POST /v1/check

Before paying: allowed, denied or pending, with the reason and an anomaly score.

03
POST /v1/spend

After paying: chained into the ledger, signed receipt returned.

02 · FEATURES

Everything between your agent and its wallet.

Korval sits in the payment path of your agent's code and answers in milliseconds.

01

Policies

Budgets, allowlists, caps and human approvals.

02

Automations

IF/THEN rules on spend, balance and anomalies.

03

Anomaly scoring

z-scores on amount and velocity, per vendor.

04

Policy simulator

Backtest policy.json on real history.

05

Hash-chained ledger

Verify the full history in one click.

06

Signed receipts

Proof a spend was authorized.

07

Webhooks

Denials, approvals, anomalies, pushed to you.

08

Live console

Stream, ledger, request log, playground.

03 · SPEC

Built like infrastructure.

Plain HTTP, verifiable cryptography, no SDK required.

Protocol

HTTPS + JSON. Any language, any agent framework.

Auth

Workspace keys, plus scoped agent keys (ak_…) that can only act as one agent.

Writes

Idempotency keys. A retry never charges twice.

Decisions

Budgets, allowlists, daily caps, approvals, anomaly holds.

Ledger

SHA-256 hash chain. Any edit breaks the chain.

Receipts

HMAC-SHA256 signed. Public verify endpoint.

Webhooks

Signed with t= / v1= HMAC headers.

Runtime

Edge workers + SQLite. Global, always on.

Funds

None held. Your agents pay. Korval decides and records.

04 · TOKEN

$KORVAL

Hold to unlock more agents and automations. Part of protocol fees buys back $KORVAL.

$KORVAL
ROBINHOOD CHAIN