API reference

Base URL: https://api-production-c74b9.up.railway.app (this site's current API). Inference is OpenAI-compatible; everything else is plain JSON.

Authentication

• Inference takes an API key: Authorization: Bearer ik_… or x-api-key: ik_…. Without either, it takes an x402 payment instead (below).
• Account routes (keys, balance, usage, seller) take the session token from sign-in as Authorization: Bearer <session>. Sessions last 24h. Balance and usage also accept your API key.
• Public routes (models, prices, marketplace, stats, rails) need no auth and are cacheable.

Money

All amounts are integers in millionths of a unit (fields ending in Micro), serialised as decimal strings. On the testnet the unit is ITC, which counts as one test dollar and has no monetary value: "1500000" = 1.50 ITC. Prices are in the same micro-units per 1M tokens, quoted in $ so they compare with list prices, and are all-in (seller price + platform fee) unless a field says otherwise. Percentages are numbers with two decimals; a discount is rounded down so it is never overstated.

Inference

curl https://api-production-c74b9.up.railway.app/v1/chat/completions \
  -H "Authorization: Bearer $INFERIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen/qwen-2.5-14b-instruct","messages":[{"role":"user","content":"Hello"}]}'

Response headers on every inference call:

Errors

Errors use OpenAI's shape. Notable codes: 402 insufficient_funds (with a key; without one, a 402 is an x402 offer), 404 model_not_found, 503 no_available_offers (with retry-after), 429 rate_limit_exceeded (per client IP, with retry-after; sign-in and dev routes have a stricter budget), 401 for a missing or bad key.

{
  "error": {
    "message": "Your available balance on whitechain does not cover the worst-case cost of this request.",
    "type": "insufficient_funds",
    "code": "insufficient_funds"
  }
}

x402: pay per request, no key

Standard x402 v2, exact scheme, settled into the escrow and credited to the payer. The walkthrough and client code are on Pay per request with x402.

Marketplace (public)

GET /api/marketplace
{
  "feeBps": 500,
  "markets": [{
    "modelId": "qwen/qwen-2.5-14b-instruct",
    "name": "Qwen: Qwen2.5 14B Instruct",
    "openWeight": true,
    "licenseId": "apache-2.0",
    "listInputPerM": "100000",        // µUSD per 1M tokens ($0.10)
    "listOutputPerM": "200000",
    "bestInputPerM": "84000",         // all-in, healthy offers only
    "bestOutputPerM": "168000",
    "bestDiscountPct": 16,
    "sellers": 3, "healthySellers": 2,
    "requests24h": 1840, "volume24hMicro": "2214551",
    "uptime24hPct": 99.2, "ttftP50Ms": 310
  }]
}

GET /api/markets/qwen%2Fqwen-2.5-14b-instruct
{
  "modelId": "qwen/qwen-2.5-14b-instruct",
  "summary": { ...same shape as a marketplace row... },
  "levels": [
    { "inputPerM": "84000", "outputPerM": "168000", "offers": 2, "healthyOffers": 2, "capacityMicro": "18000000" },
    { "inputPerM": "95000", "outputPerM": "190000", "offers": 1, "healthyOffers": 0, "capacityMicro": null }
  ]
}

Sign-in

Keys

Buyer

Seller