Curl + Bearer in 5 minutes

REST endpoints at api.axiomstack.dev/v1/* return verifiable on-chain attestations. Equity (real-time + audit) and crypto (real-time instant tier; audit ships next sprint) live today; other asset classes follow.

1. 1. Issue an API key

   In the dashboard → Keys. Copy the axm_live_… token; treat it like a password. Set it as an env var:

   copy

   export AXIOM_API_KEY="axm_live_…"

2. 2. Smoke-test

   No auth needed for /health:

   copy

   curl https://api.axiomstack.dev/v1/health

3. 3. Get an attestation — equity

   copy

   curl -X POST https://api.axiomstack.dev/v1/attestation/instant \
     -H "Authorization: Bearer $AXIOM_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"asset_class": 2, "asset_id": "AAPL"}'

   Returns {data, meta} with price + volume + attestation_pda (the on-chain record) + write_tx_sig in under 2 seconds.

4. 4. …or crypto

   copy

   curl -X POST https://api.axiomstack.dev/v1/attestation/instant \
     -H "Authorization: Bearer $AXIOM_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"asset_class": 6, "asset_id": "BTC"}'

   Whitelist: BTC, ETH, SOL, USDC, USDT.

Agents with a Solana wallet can pay per call in USDC — no API key, no signup, no human-mediated Stripe top-up. Coexists with Bearer auth on the same endpoint; we prefer Bearer when both are present (predictable enterprise margin) and fall through to x402 for spot agent traffic.

Hit any priced endpoint without auth to see the payment requirements:

curl -X POST https://api.axiomstack.dev/v1/attestation/instant \
  -H "Content-Type: application/json" \
  -d '{"asset_class": 6, "asset_id": "BTC"}'

# → HTTP 402 Payment Required
# Response body (V1-compat) + PAYMENT-REQUIRED response header (V2):
# {
#   "x402Version": 1,
#   "accepts": [{
#     "scheme": "exact",
#     "network": "solana-devnet",
#     "asset": "<USDC mint>",
#     "maxAmountRequired": "20000",          # $0.02 in 6-decimal atomic units
#     "payTo": "6pPcyDr…",                   # treasury OWNER, not ATA
#     "resource": "https://api.axiomstack.dev/v1/attestation/instant",
#     "extra": { "feePayer": "<facilitator pubkey>", "decimals": 6, "symbol": "USDC" }
#   }],
#   "error": "X-PAYMENT header is required"
# }

Sign a Solana transferChecked instruction with the facilitator as fee payer, Base64-encode the payload, and resend with the payment header:

# After signing (use @x402/svm + x402-fetch on Node, or solders on Python):
curl -X POST https://api.axiomstack.dev/v1/attestation/instant \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64(PaymentPayload)>" \
  -d '{"asset_class": 6, "asset_id": "BTC"}'

# → HTTP 200 with the attestation + PAYMENT-RESPONSE header
# Response envelope includes meta.payment.tx_hash for explorer lookup.

SDKs + MCP server

Three packages at 0.5.0. Pick the one that matches your stack. SDKs are thin typed wrappers over the REST API — RFC 7807 errors map to typed exceptions, idempotency keys are first-class, 429s auto-retry once with Retry-After.

All SDKs include x402 (Bearer + agent-autonomous payment) + AP2 mandate passthrough + MPP-charge typed exceptions, plus the standalone pay() + discover() primitives, in 0.5.0.

npm install @axiom-stack/sdk

import { AxiomClient } from "@axiom-stack/sdk";

const client = new AxiomClient({ apiKey: process.env.AXIOM_API_KEY });
const res = await client.attestInstant({ assetClass: 2, assetId: "AAPL" });
console.log(res.data.price_micros, res.attestation_pda);

pip install axiom-stack

import os
from axiom_stack import AxiomClient

client = AxiomClient(api_key=os.environ["AXIOM_API_KEY"])
res = client.attest_instant(asset_class=2, asset_id="AAPL")
print(res.data.price_micros, res.attestation_pda)

{
  "mcpServers": {
    "axiom-stack": {
      "command": "npx",
      "args": ["-y", "@axiom-stack/mcp-server"],
      "env": { "AXIOM_API_KEY": "axm_live_…" }
    }
  }
}

Postman + OpenAPI

Import the Postman collection or hit the OpenAPI 3.1 spec directly for code generation, IDE autocomplete, or your favorite client framework.

• ⤓ axiom-oracle.postman_collection.json(Postman v2.1; set the AXIOM_API_KEY environment variable)
• ⤓ openapi.json(OpenAPI 3.1) · also live at api.axiomstack.dev/v1/openapi.json

API reference