API documentation

Create a scoped key in your account and send it as a Bearer token (the X-API-Key header is also accepted). The plaintext key is shown only once at creation — store it securely; only a hash is kept on our side.

curl -H "Authorization: Bearer ask_xxxxxxxx_..." \
  https://nexusmarket.one/api/v1/balance

Each key is limited to the scopes you grant it. An endpoint returns 403 if the key lacks its required scope.

Each key has its own token-bucket limit (default 100 requests per minute). When exceeded, the response is 429 with a Retry-After header indicating how many seconds to wait.

Send an optional Idempotency-Key header on a purchase so a retry can't charge your wallet twice: a repeat with the same key and body replays the original response; the same key with a different body returns 409.

curl -X POST https://nexusmarket.one/api/v1/purchase \
  -H "Authorization: Bearer ask_xxxxxxxx_..." \
  -H "Idempotency-Key: order-2026-06-11-0001" \
  -H "Content-Type: application/json" \
  -d '{"productId":"clxyz...","quantity":2}'

Errors

Every error uses a consistent envelope with a stable machine-readable code, a human message, and optional per-field validation details.

{
  "ok": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Wallet balance is insufficient for this purchase"
  }
}