{ "item": [ { "name": "health", "description": "", "item": [ { "id": "6717b0ef-d427-4232-a559-995c7d54d89e", "name": "Service health + deployed version", "request": { "name": "Service health + deployed version", "description": { "content": "Open endpoint (no auth). Use this to verify the API is reachable\nand to discover the deployed release version + timestamp.\n", "type": "text/plain" }, "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "62478b4e-bde8-42b9-bc37-8da04641799a", "name": "Service is healthy.", "originalRequest": { "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"data\": {\n \"status\": \"ok\",\n \"version\": \"\",\n \"deployed_at\": \"\"\n },\n \"meta\": {\n \"request_id\": \"req_780cw533rzao3ozrvpsyohiy7b\",\n \"version\": \"v1\",\n \"latency_ms\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "assets", "description": "", "item": [ { "name": "classes", "description": "", "item": [ { "id": "91bc24fa-affa-4a66-8156-6e544ef7a6da", "name": "List supported asset classes and which tiers are live per class", "request": { "name": "List supported asset classes and which tiers are live per class", "description": { "content": "Open endpoint (no auth). Returns the taxonomy + per-class tier\navailability so agents can program against capability, not hardcoded\nids. `status` is `\"live\"` / `\"coming_soon\"`; `tiers_available`\nis the subset of `[\"instant\", \"audit\"]` that works today.\n", "type": "text/plain" }, "url": { "path": [ "assets", "classes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "8eddd90f-27c2-42ac-a4dd-b2d0cc8164de", "name": "Catalog.", "originalRequest": { "url": { "path": [ "assets", "classes" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"classes\": [\n {\n \"id\": 2,\n \"name\": \"equity\",\n \"status\": \"coming_soon\",\n \"tiers_available\": [\n \"audit\",\n \"audit\"\n ],\n \"asset_id_format\": \"\",\n \"examples\": [\n \"\",\n \"\"\n ],\n \"notes\": \"\"\n },\n {\n \"id\": 2,\n \"name\": \"crypto\",\n \"status\": \"coming_soon\",\n \"tiers_available\": [\n \"instant\",\n \"instant\"\n ],\n \"asset_id_format\": \"\",\n \"examples\": [\n \"\",\n \"\"\n ],\n \"notes\": \"\"\n }\n ]\n },\n \"meta\": {\n \"request_id\": \"req_8srnn57dxeqvqi7bbd0si781n0\",\n \"version\": \"v1\",\n \"latency_ms\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "attestation", "description": "", "item": [ { "name": "instant", "description": "", "item": [ { "id": "8713c5c6-c58d-4363-83c1-508accdfc04c", "name": "Request an instant-tier attestation (<2s data + provisional proof)", "request": { "name": "Request an instant-tier attestation (<2s data + provisional proof)", "description": { "content": "Fetches the data, **submits the on-chain attestation** as a\nregistered provider, and returns the data + provisional proof\n(`attestation_pda` + `write_tx_sig`) in under 2s. The audit\nrecord commits asynchronously (typically within ~30s) — poll\n`GET /v1/attestation/{pda}` to confirm finalization. Quota debits\non data delivery; a failed async commit does not double-charge.\n", "type": "text/plain" }, "url": { "path": [ "attestation", "instant" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "779bf848-9361-4745-83f9-494a01e6f451", "name": "Instant attestation.", "originalRequest": { "url": { "path": [ "attestation", "instant" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Reset", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "RateLimit-Policy", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Idempotent-Replayed", "value": "" } ], "body": "{\n \"data\": {\n \"latency_mode\": \"instant\",\n \"data\": {\n \"asset_id\": \"\",\n \"asset_class\": 6,\n \"price_micros\": \"\",\n \"volume_24h\": \"\"\n },\n \"source\": \"equity_primary\",\n \"attestation_pda\": \"\",\n \"status\": \"audit_failed\",\n \"as_of\": \"\",\n \"expected_commit_by\": \"\",\n \"write_tx_sig\": \"\"\n },\n \"meta\": {\n \"request_id\": \"req_95eujfatyemb6js9flh0gcq9t0\",\n \"version\": \"v1\",\n \"latency_ms\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dc5b051b-eb5f-409b-b1d5-0bb02d9d2815", "name": "Malformed request, invalid asset_class, or invalid asset_id.", "originalRequest": { "url": { "path": [ "attestation", "instant" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "69f16855-1836-4d41-b0e6-459c86812df9", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "attestation", "instant" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84bcab0e-cc11-4b1b-91df-053bd372eddd", "name": "Key is inactive.", "originalRequest": { "url": { "path": [ "attestation", "instant" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f143cba6-7e11-4cd8-a6a3-d1ff7756de12", "name": "Idempotency-Key replayed with a different request body.", "originalRequest": { "url": { "path": [ "attestation", "instant" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "624b659b-8545-4a42-9331-b885ef4585ce", "name": "Quota exhausted. Top up USDC or upgrade tier.", "originalRequest": { "url": { "path": [ "attestation", "instant" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" }, { "disabled": false, "description": { "content": "Seconds until the included bucket resets.", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f75b90b3-181f-485c-b3a9-74792d63a44f", "name": "A dependency (data provider, on-chain RPC, auth store) is temporarily unavailable.", "originalRequest": { "url": { "path": [ "attestation", "instant" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "audit", "description": "", "item": [ { "id": "9a33110d-ac6f-40d3-8b3e-ad9286de26b3", "name": "Request an audit-tier attestation (~20s synchronous, fully on-chain)", "request": { "name": "Request an audit-tier attestation (~20s synchronous, fully on-chain)", "description": { "content": "Synchronous, fully on-chain (~20s end-to-end). Quota debits on\ncommit success.\n\n**V1 scope:** equity only. Requesting `asset_class: 6` (crypto)\nreturns `400 tier-unavailable-for-class` with `tiers_available`\nand a pointer to the next release (G6.7b). Agents should pattern-\nmatch on the `type` URI rather than retrying.\n", "type": "text/plain" }, "url": { "path": [ "attestation", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "6b054c1b-c5d5-4fe0-97d1-32578a7560c2", "name": "Audit attestation (finalized on-chain).", "originalRequest": { "url": { "path": [ "attestation", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" } ], "body": "{\n \"data\": {\n \"latency_mode\": \"audit\",\n \"asset_class\": 2,\n \"asset_id\": \"\",\n \"asset_data\": {\n \"variant_type\": \"EquityData\",\n \"closing_price_micros\": \"\",\n \"volume_24h\": \"\",\n \"market_cap_usd_millions\": \"\",\n \"exchange_code\": \"\"\n },\n \"attestations\": [\n {\n \"provider_pubkey\": \"\",\n \"valuation_score\": \"\",\n \"confidence_score\": \"\",\n \"timestamp\": \"\",\n \"raw_snapshot_hash\": \"\"\n },\n {\n \"provider_pubkey\": \"\",\n \"valuation_score\": \"\",\n \"confidence_score\": \"\",\n \"timestamp\": \"\",\n \"raw_snapshot_hash\": \"\"\n }\n ],\n \"attestation_pda\": \"\",\n \"latest_snapshot_hash\": \"\",\n \"write_tx_sig\": \"\",\n \"fee_lamports_paid\": \"\",\n \"bump\": \"\",\n \"manual_audit_required\": \"\"\n },\n \"meta\": {\n \"request_id\": \"req_zrktroddns9v6zkvo6g6fzt4ui\",\n \"version\": \"v1\",\n \"latency_ms\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d382c9e8-4e5f-496e-96cf-41226d01c4b0", "name": "`tier-unavailable-for-class` for crypto audit requests in V1, or a\ngeneral bad-request. The `type` URI disambiguates.", "originalRequest": { "url": { "path": [ "attestation", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fc39b52d-37b0-4784-ac15-45e6731ec1be", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "attestation", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "610055b5-7349-4114-954b-8f25ba3e908d", "name": "Key is inactive.", "originalRequest": { "url": { "path": [ "attestation", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e00bae66-8a13-4b87-a10c-101320cf2049", "name": "Idempotency-Key replayed with a different request body.", "originalRequest": { "url": { "path": [ "attestation", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca1e73a0-38d6-4ec0-aed5-b481bf469a72", "name": "Quota exhausted. Top up USDC or upgrade tier.", "originalRequest": { "url": { "path": [ "attestation", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" }, { "disabled": false, "description": { "content": "Seconds until the included bucket resets.", "type": "text/plain" }, "key": "Retry-After", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Limit", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-RateLimit-Remaining", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2750f6d1-fa21-4ea3-ac9b-0699be3b0c1d", "name": "A dependency (data provider, on-chain RPC, auth store) is temporarily unavailable.", "originalRequest": { "url": { "path": [ "attestation", "audit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": { "content": "Client-chosen unique key (UUID recommended) — makes the request\nsafely retryable. Server caches the response 24h; the same key\nwith a *different* body returns `422`.\n", "type": "text/plain" }, "key": "Idempotency-Key", "value": "" }, { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"asset_class\": 2,\n \"asset_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "{pda}", "description": "", "item": [ { "id": "bd9a4435-b1d1-4cf9-a763-230293997b69", "name": "Fetch the on-chain attestation record by PDA", "request": { "name": "Fetch the on-chain attestation record by PDA", "description": { "content": "Read-only. Decodes the `AssetStateV2` PDA owned by the Axiom\nprogram and returns the typed `asset_data` variant + the\nattestation chain + the latest snapshot hash. Useful to poll\nfinalization of an instant-tier write, or to verify an audit\nrecord after the fact.\n\nDoes **not** consume quota.\n", "type": "text/plain" }, "url": { "path": [ "attestation", ":pda" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "pda", "disabled": false, "description": { "content": "(Required) Base58 Solana address of the AssetStateV2 PDA.", "type": "text/plain" } } ] }, "header": [ { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "656b8fe7-41d7-480f-9a2f-b35b5e9c1b35", "name": "Decoded AssetStateV2.", "originalRequest": { "url": { "path": [ "attestation", ":pda" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Base58 Solana address of the AssetStateV2 PDA.", "type": "text/plain" }, "type": "any", "value": "", "key": "pda" } ] }, "header": [ { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"data\": {\n \"pda\": \"\",\n \"program_id\": \"\",\n \"asset_class\": 2,\n \"asset_id\": \"\",\n \"asset_data\": {\n \"variant_type\": \"EquityData\",\n \"closing_price_micros\": \"\",\n \"volume_24h\": \"\",\n \"market_cap_usd_millions\": \"\",\n \"exchange_code\": \"\"\n },\n \"attestations\": [\n {\n \"provider_pubkey\": \"\",\n \"valuation_score\": \"\",\n \"confidence_score\": \"\",\n \"timestamp\": \"\",\n \"raw_snapshot_hash\": \"\"\n },\n {\n \"provider_pubkey\": \"\",\n \"valuation_score\": \"\",\n \"confidence_score\": \"\",\n \"timestamp\": \"\",\n \"raw_snapshot_hash\": \"\"\n }\n ],\n \"latest_snapshot_hash\": \"\",\n \"bump\": \"\",\n \"manual_audit_required\": \"\"\n },\n \"meta\": {\n \"request_id\": \"req_uhpi7coxzrd1hgumzp7n3z50e6\",\n \"version\": \"v1\",\n \"latency_ms\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b89e160b-e860-4bab-bb7d-dd61c14c01a2", "name": "Malformed request, invalid asset_class, or invalid asset_id.", "originalRequest": { "url": { "path": [ "attestation", ":pda" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Base58 Solana address of the AssetStateV2 PDA.", "type": "text/plain" }, "type": "any", "value": "", "key": "pda" } ] }, "header": [ { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ad22b799-32af-4f4c-95c0-c0266118cb22", "name": "Missing or invalid bearer token.", "originalRequest": { "url": { "path": [ "attestation", ":pda" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Base58 Solana address of the AssetStateV2 PDA.", "type": "text/plain" }, "type": "any", "value": "", "key": "pda" } ] }, "header": [ { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb343fc4-0e2f-4279-b3ac-2c7699b83ac2", "name": "No AssetStateV2 account at the given PDA.", "originalRequest": { "url": { "path": [ "attestation", ":pda" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Base58 Solana address of the AssetStateV2 PDA.", "type": "text/plain" }, "type": "any", "value": "", "key": "pda" } ] }, "header": [ { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7acb3173-5839-431c-b03c-2962a75eceb6", "name": "A dependency (data provider, on-chain RPC, auth store) is temporarily unavailable.", "originalRequest": { "url": { "path": [ "attestation", ":pda" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Base58 Solana address of the AssetStateV2 PDA.", "type": "text/plain" }, "type": "any", "value": "", "key": "pda" } ] }, "header": [ { "disabled": false, "description": { "content": "Optional client-supplied request id (honored if present, else server\nmints `req_<26-char-base32>`). Echoed in `meta.request_id` and in the\n`X-Request-ID` response header.\n", "type": "text/plain" }, "key": "X-Request-ID", "value": "req_jz5" }, { "key": "Accept", "value": "application/problem+json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/problem+json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "X-Request-ID", "value": "" } ], "body": "{\n \"type\": \"\",\n \"title\": \"\",\n \"status\": \"\",\n \"instance\": \"\",\n \"request_id\": \"\",\n \"detail\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "type": "any", "value": "{{bearerToken}}", "key": "token" } ] }, "event": [], "variable": [ { "key": "baseUrl", "value": "https://api.axiomstack.dev/v1" } ], "info": { "_postman_id": "7a8ae5b1-b49f-4a2d-bab2-5771ce750ce5", "name": "Axiom Stack Oracle API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "The Axiom Oracle delivers institutional-grade market data attestations\nwritten to Solana on every request — agents query with curl + a Bearer\ntoken and receive **`{data, meta}`** envelopes with on-chain proof\n(`attestation_pda` + `write_tx_sig`).\n\n## Tiers (V1)\n\n| Class | Name | Tiers Live | `asset_id` |\n|-------|-----------|--------------------------------------|---------------------------------------------|\n| 2 | Equity | `instant` + `audit` | Ticker, e.g. `AAPL`, `TSLA` |\n| 6 | Crypto | `instant` only (audit → G6.7b) | Symbol — `BTC`, `ETH`, `SOL`, `USDC`, `USDT` |\n\nOther classes appear in `/v1/assets/classes` as `coming_soon`.\n\n## Idempotency\nSend an `Idempotency-Key: ` header on POSTs to make the\nrequest safely retryable. The server caches the response for 24h and\nreplays it byte-for-byte on the same key. Reusing the key with a\n*different* request body returns `422 idempotency-replay-mismatch`.\n\n## Rate limits\nEach response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`,\n`X-RateLimit-Reset`, and `RateLimit-Policy` (draft-ratelimit-headers).\n`429 insufficient-quota` includes `Retry-After`.\n\n## Request IDs\nEvery response echoes an `X-Request-ID` (`req_<26-char-base32>`); the\nsame id appears in `meta.request_id` and in every error envelope's\n`request_id`. Include it in support requests.\n\n## Errors\nAll errors are RFC 7807 `application/problem+json` with stable `type`\nURIs at `https://docs.axiomstack.dev/errors/` — pattern-match on\nthe URI, not on prose.\n\n\nContact Support:\n Name: Axiom Stack Support", "type": "text/plain" } } }