Quickstart
Every listing works over plain HTTP. Model routes speak the OpenAI API. Payment is a 402 handshake: ask, get a signed quote, pay, retry with proof. Or sign up and pay from a balance.
Read from the API when this page was built (2026-11-19T06:07:31Z): /pay402/health answered ok at 2026-11-19T06:07:16Z; payments open; rails offered: internal_balance, bsv_tx. /v1/models listed 11 models at 2026-11-19T06:07:16Z.
1. Find something
curl -s https://gaents.com/catalogue.json | python3 -c 'import json,sys; [print(l["id"], l["kind"], l["title"]) for l in json.load(sys.stdin)["listings"]]'
Each listing has facts (value, source, retrieved_at, method), prices and call. Agents can start from /llms.txt or /.well-known/gaents.json.
2. Get a key
One click on the dashboard, or POST https://api.gaents.com/v1/accounts (see Start). The key is shown once.
3. Call a model (OpenAI SDK)
from openai import OpenAI
client = OpenAI(base_url="https://api.gaents.com/v1", api_key=GAENTS_KEY)
r = client.chat.completions.create(model="gaents/glm-flash", messages=[{"role": "user", "content": "..."}])
Model ids served at 2026-11-19T06:07:16Z: gaents/claude-haiku · gaents/claude-opus · gaents/claude-sonnet · gaents/deepseek · gaents/deepseek-flash · gaents/fable · gaents/glm-flash · gaents/gpt-oss · gaents/grok · gaents/qwen-27b · gaents/qwen-flash.
4. Pay per call without an account (HTTP 402)
curl -i -X POST https://api.gaents.com/v1/chat/completions -H 'Content-Type: application/json' -d '{...}'
# 402 Payment Required, body: accepts[] with a signed quote, price, quote_id, expiry
curl -X POST https://api.gaents.com/v1/chat/completions -H 'X-PAYMENT: <base64 proof>' -H 'Content-Type: application/json' -d '{...}'
Pay with one of the rails the API offers: internal_balance, bsv_tx (as of 2026-11-19T06:07:16Z). Discovery: https://api.gaents.com/.well-known/x402 (answered 200 at 2026-11-19T06:07:16Z).
5. From an agent (MCP)
https://api.gaents.com/mcp answered 200 at 2026-11-19T06:07:16Z. Methods: initialize, tools/list, tools/call.
6. Check it
Public boards: /v1/reliability (10 listings when read at build, 2026-11-19T06:07:31Z) and /v1/capacity (answered 200 at 2026-11-19T06:07:16Z).
Every call becomes ledger rows and a signed proof. Prove it shows how to re-check any call and the ledger's head hash yourself. Service state: Status.
7. Failover and the family that served you
Everything in this section is what https://api.gaents.com/v1/chat/completions answered to our probes at 2026-11-19T06:07:30Z (raw: /docs/api-probes.json).
The request header
Header X-Gaents-Failover, values: same-family or any. Any other value is refused before any money moves: we sent gaents-docs-probe-not-a-mode without a key and got HTTP 400 bad_failover, “X-Gaents-Failover: one of ['same-family', 'any']”.
Default when you send no header: NOT PROBED: the API does not publish it (no key naming 'failover' in /pay402/health or /v1/models).
From a browser: the API's CORS preflight for origin https://gaents.com allows X-Gaents-Failover (HTTP 204).
curl -s -D - https://api.gaents.com/v1/chat/completions -H "Authorization: Bearer $GAENTS_KEY" \
-H 'X-Gaents-Failover: same-family' -H 'Content-Type: application/json' \
-d '{"model": "gaents/glm-flash", "messages": [{"role": "user", "content": "Reply with the word OK."}], "max_tokens": 16}'
The served family
NOT PROBED: our same-family call answered HTTP 503 unavailable , so this page shows no served family.
What same-family does when the alias's own family has no live route: NOT PROBED (the API publishes no per-family live-route count, so the build cannot pick an alias in that state to show it).
8. Pay only for verified output (result jobs)
Result jobs: the caller pays only when EVERY check passes on that call's output; otherwise no charge and our cost is booked as the route's loss. (pay402's job table result_jobs.json, sha256 bef8a9a48dc62762, read 2026-11-19T06:07:32Z; the table, not an API reading.)
GET /v1/jobs at 2026-11-19T06:07:32Z listed 0 result jobs ("result": true).
In the table but not live (absent from that GET /v1/jobs answer):
site-facts-verified: A website's title, emails and phones, each checked on the live page (pay only if verified). Not live:POST https://api.gaents.com/v1/jobs/site-facts-verifiedwithout a key answered HTTP 404 unknown_job at 2026-11-19T06:07:32Z.
The verdict on a paid call's public proof: NOT PROBED (no result job is live to call).