Get top pools.
Removed. Use /pools/search instead.
Migration
GET /networks/{network}/pools/search.Response
Monthly credit allowance exhausted. Retrying will not help, because the body names the available next step per tier: register (anonymous), upgrade (free key), or buy a credit pack / enable overage / raise your spend cap (Pro). resets_at is when the allowance rolls over (calendar month or billing period, UTC). Deliberately carries no Retry-After header.
Structured body carried by every 402 and 429 emitted by the billing gate. The shape is constant across scenarios; only fields describing an available action appear. message is always a top-level string, so clients parsing the legacy {"message": ...} shape keep working.
Machine-readable discriminator matching the status code.
payment_required, rate_limited The billing tier the request was evaluated against.
anonymous, free_registered, pro Human-readable message naming the next action.
Credit counters for the current period. One credit is one request. plan and packs are split out for Pro keys only. limit is plan + packs; usage served through overage can exceed it.
Overage state, present on Pro 402 bodies. Money amounts are decimal strings, never floats.
When the monthly allowance rolls over (UTC). 402 only.
Seconds to wait before retrying. 429 only.
Early-adopter offer, present on the free-tier 402 only.
Next-step URLs. Keys vary by scenario: register, upgrade, packs, portal, usage, docs. Absent until the customer-facing pages go live.