Compute State API

Machine-payable compute intelligence for AI agents.

Answers one question for AI agents and the engineers who run them: which compute can actually run this job right now for the best price. Official vendor pages only.

x402 · $0.005 USDC on Base or Solana per call. No key.

See a free example response →
Inference rows507
GPU rows96
Prices read2026-10-07 04:18:37Z
Book statefresh

Entire fleet

One live registry, every company we price. The fleet currently spans 16 companies across 11 inference feeds and 6 GPU feeds. Each feed links to the official source it reads.

16 companies 11 inference feeds 6 GPU feeds

How to call it

One HTTP request. Describe the job, get back the cheapest compute that can run it, with the arithmetic and the source page behind the number.

In four steps

  1. Send your job: either tokens (work=inference) or GPU hours (work=gpu).
  2. You get a 402 back with a payment challenge listing Base and Solana.
  3. Sign for whichever chain you hold USDC on and resend with the payload in PAYMENT-SIGNATURE.
  4. The 200 carries the answer, plus your receipt in PAYMENT-RESPONSE.

Two example calls

curl "https://compute-state-api.replit.app/v1/cheapest?work=inference\
&model_tier=cheap&est_input_tokens=2000\
&est_output_tokens=500"

curl "https://compute-state-api.replit.app/v1/cheapest?work=gpu\
&gpu_model=h100&gpu_hours=24"

Want to see the exact response shape before paying anything?

GET /v1/example →

Free vs paid

Everything you need to understand and integrate the API is free. The only thing you pay for is a live answer about your specific job.

EndpointCostWhat you get
/v1/examplefreeA fixed sample answer in exactly the paid shape, so you can build against it first.
/openapi.jsonfreeThe full spec: parameters, response fields, error codes.
/.well-known/x402freeWhere to pay and how much, in machine-readable form.
/llms.txt · /skill.mdfreePlain-text instructions so an agent can use this API without a human.
/healthzfreeWhether the price data is current enough to answer right now.
/privacy · /privacy.txtfreeWhat this service stores about a caller, for a person and for an agent.
/v1/cheapest0.005 USDCThe live answer for your job: cheapest option, the cost breakdown, alternatives, what was excluded and why.

What comes back

Not just a number — a number you can explain to whoever asks why you picked it.

A price with a date

Every rate is read from the vendor's own pricing page, not an aggregator, and stamped with when it was read. Anything older than 15 minutes is left out of the answer.

The math, shown

The total is split into the parts it was added up from — each with the published rate, its unit, and whether that rate is list, effective, or unknown.

Returned with a reason

Every SKU that matched but cannot be used is returned with the reason — retired, unpublished price, waitlist, or a rate we will not invent.

When you are charged

No body, no settle; no settle, no charge. Your query and the freshness of the price data are checked before any payment is asked for. Your payment is verified and your answer built before any money moves.

StatusWhat happenedCharged
400Bad query. Before settlement.no
402Payment required or signature rejected. Before settlement.no
503No fresh row can answer this query. Before settlement.no
404Wrong path (this API has no such route). Before settlement.no
200Verified, ranked, then settled. Body computed before money moved; sent after.yes
404Paid no-match: verified, ranked, nothing in the pinned book fit. disqualified explains what came close.yes
500Process faulted before settlement. Operator fault. You were not charged.no

You are charged only when settlement succeeds and we have an answer in hand (200 or a no-match 404). 400, 402, unpaid 503, and 500 all happen before money moves. A 500 is our crash, not a stale book — we do not settle if we cannot build the body. If the HTTP response is lost after settlement, retry the same signature; we will not charge twice.

Payment

Pay per call with USDC over x402. No account, no API key, no subscription.

A listing probe of GET /v1/cheapest with no query string is a 402, not a 400. work is required to rank. It is not required to see the challenge.

FieldValue
Protocolx402 v2, scheme exact
Price0.005 USDC per call, both chains
Baseeip155:8453
Solanasolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
Facilitatorfacilitator.payai.network

Sources

Official vendor pages and APIs, nothing else. GPU coverage is on-demand list price only across RunPod, Lambda, Fireworks, Crusoe, Nebius and Hyperstack — no spot bids, no reserved or tailored commitments and no marketplace resellers — which is why the clouds here post a rate you can buy by the hour rather than a bid. Fireworks appears twice because it sells two products, serverless tokens and rented GPUs, on two separate pages.

State suite

Four APIs, one question each. This one answers what a job costs to run right now. It is the wrong tool for seat prices, uptime, or SDK breaks.

APIQuestion it answers
Pricing State What is this vendor's seat / list ladder? live
Status State Is the vendor up? live
Changelog State Did the SDK ship a break? live
Compute State Which compute can actually run this job right now? you are here