The Calyx API lets any agent — or developer — create a wallet, lock escrow before a job, rent a GPU, and receive a cryptographically signed compute receipt. Four endpoints. No sales call required.
Calyx is a GPU compute marketplace built for the agentic economy. Unlike existing platforms designed for humans clicking a UI, Calyx is API-first — every action an agent needs to take is a single HTTP request.
The core flow is:
Every request requires an API key in the X-API-Key header. You receive your key when you join the waitlist and are approved for API access.
Every agent gets its own wallet with programmable spend controls. A human owner creates the top-level wallet and allocates budget to child agent wallets. Agents can only spend from their own wallet — they cannot access the parent.
Wallet policies you can set per agent:
| Policy | Type | Description |
|---|---|---|
| spend_cap_per_job | float | Maximum FLOPS an agent can lock for a single job. Enforced before escrow. |
| approval_threshold | float | Jobs above this amount require human approval before proceeding. |
| allowed_gpu_types | string[] | Whitelist of GPU models the agent is allowed to rent. e.g. ["RTX 4090", "A100"] |
| spend_cap_per_hour | float | Maximum FLOPS the agent can spend in a rolling 60-minute window. |
Create a new wallet for a human owner or an agent. Agent wallets must reference a parent human wallet.
| Parameter | Type | Description |
|---|---|---|
| owner_type required | string | "human" or "agent" |
| owner_id required | string | Your internal ID for this owner — user ID, agent name, etc. |
| parent_wallet_id | string | Required for agent wallets. The human wallet that funds this agent. |
| spend_cap_per_job | float | Max FLOPS per single job. Null = no cap. |
| allowed_gpu_types | string[] | GPU allowlist. Null = all GPUs allowed. |
| approval_threshold | float | Human approval required above this spend. Null = no gate. |
Returns wallet metadata and live balance computed from the ledger. Balance is never stored — always calculated as the sum of all ledger entries.
Lock FLOPS into escrow before a job starts. This is the escrow step — it checks all wallet policies and deducts from your balance. The funds are held until the job settles.
Returns 402 if balance is insufficient. Returns 403 if spend cap, approval threshold, or GPU allowlist is violated.
| Parameter | Type | Description |
|---|---|---|
| job_id required | string | Your unique ID for this job. Used to link escrow to settlement. |
| amount required | float | FLOPS to lock. Must be ≤ spend_cap_per_job if set. |
| gpu_type | string | GPU being rented. Checked against allowed_gpu_types if set. |
Called when a job completes. Releases escrow, deducts the 15% platform fee, credits the host wallet, and generates a signed compute receipt. All four steps happen atomically — either all succeed or none do.
| Parameter | Type | Description |
|---|---|---|
| job_id required | string | Must match the job_id used in the spend call. |
| gross_amount required | float | Total FLOPS earned before fee. Platform takes 15%, host gets 85%. |
| output_hash required | string | sha256 of the job's output artifact. Goes into the signed receipt. |
| gpu_model required | string | The GPU that ran the job. Recorded in the receipt. |
| duration_seconds required | int | How long the job ran. Recorded in the receipt. |
This is the complete flow from an agent's perspective using the Python SDK (coming Q3 2026). The same flow works with raw HTTP calls today.
FLOPS are Calyx's internal credit unit. 1 FLOPS = $0.01 USD. We use FLOPS internally so agents can transact at zero cost without touching a payment processor on every micro-transaction.
Credits circulate between agents at zero cost and instant settlement. Only when someone cashes out to real money (bank transfer, Stripe) does external payment infrastructure get involved. This is what makes agent-to-agent micro-transactions economically viable.
Every balance in Calyx is computed from an append-only ledger — a table of credit movements that can never be edited or deleted. Your balance is always SUM(amount) across all your ledger entries.
This means there is no stored balance field that can drift out of sync, no way to silently lose credits, and a permanent audit trail for every dollar your agent ever spent.
When a job completes, Calyx generates a signed compute receipt — a JSON document signed with Calyx's ed25519 private key. The receipt contains the output hash, GPU model, duration, and cost. Anyone with Calyx's public key can verify it independently.
This means your agent can prove to any third party — including its human owner — exactly what compute it purchased and what output it produced, without trusting Calyx's word for it.
Join the waitlist for API access. First 50 developers get $20 in free FLOPS.