Developers

Money-moving APIs deserve boring contracts.

Typed errors, idempotency, expected revisions, and receipts. Sandbox by default; production credentials are gated.

01 / START

Three commands to a decision.

The sandbox uses fixture exchanges and simulated providers. No media is purchased.

shterminal

# authenticate a scoped sandbox key
export ADBID_TOKEN=ilk_sandbox_…
adbid whoami --json

# run a decision against fixtures
adbid decisions bid --campaign camp_88f1   --warrant w_7f3a --floor-micros 1200 --json

# verify the receipt
adbid receipts get rec_01JEX --json

02 / SURFACES

Pick a surface.

All of them call the same services, with the same policy and receipts.

HTTP

REST / OpenAPI

95 operations with typed errors, idempotency keys, and revision preconditions.

Open →

AGENT

MCP

53-tool catalog, resources, prompts, and tasks on a negotiated transport.

Open →

GRAPH

GraphQL

Read models with depth and cost limits; mutations route through approvals.

Open →

SHELL

CLI

Operator and pipeline use with schema-versioned JSON.

Open →

EVENT

Webhooks

Signed events with replay protection and bounded retries.

Open →

BROWSER

WebMCP

Context-scoped browser tools over authenticated actions.

Open →

03 / CONTRACT

What never changes.

These rules apply to every client, including agents.

Rule	Meaning
Idempotency	A retried write returns the prior receipt; it does not apply twice.
Preconditions	Writes carry an expected revision; mismatch is a conflict.
Receipts	Every financial side effect returns a durable, unique receipt.
Errors	Problem details with code, message, request_id, and retry guidance.
No self-approval	An agent cannot approve its own warrant or preview.

Copy the agent contract.

The onboarding document explains auth, scopes, sandbox, transport negotiation, and safe examples.

Agent onboarding All docs