Axiom Stack Themra — Developer Documentation
Themra delivers verifiable real-world-asset (RWA) data on-chain for AI agents and protocols on Solana. You request an attestation; Themra fetches the data, writes a Master-Broker-signed record to a Solana account (PDA), and returns it — so the data carries an on-chain authenticity + integrity anchor your agent can verify independently.
Devnet private beta. Everything described here runs on Solana devnet. API keys are issued manually during the beta. Mainnet is gated on a professional security audit. See Roadmap & limitations for the full, honest list.
How it works
- Authenticate with a bearer API key (
axm_live_…), issued by Axiom Stack. - Buy quota by paying USDC to the
/v1/topupendpoint (x402), or use your tier's included monthly allotment. - Request an attestation through the hosted MCP server (
mcp.axiomstack.dev/mcp) — theaxiom_request_attestationtool. The Themra operator settles the on-chain fee server-side; your usage is metered against your quota. - Verify the returned attestation against the Master Broker signer and the on-chain PDA.
What you can attest today
- Equities (
asset_class=2) — e.g.TSLA,NVDA. Live now (real-time equity feed). - Real estate (
asset_class=1) — temporarily unavailable on the live request path while the data write-back is being repaired; returning in the next release.
Fixed-income / treasury-yield and crypto pricing are on the roadmap; the on-chain program accepts additional classes, but the live request path currently serves equities.
Start here
- Sign up for API access — create an account + get your API key (Free tier: 10 attestations/month).
- Quickstart — your first verified attestation in ~5 minutes (Python).
- Authentication — bearer keys.
- Buy quota (USDC top-up) — the x402 payment flow.
- MCP tools & REST API — full reference.
Good to know
- Latency: the default audit tier is ~20 seconds (measured) — audit-grade, fully on-chain (request → listener → provider fetch → on-chain write → poll). An instant tier (equity) returns data + a provisional proof in under 2 s with the audit commit landing async (~30 s). The ~400 ms figure often cited for Solana is transaction finality, not the full attestation roundtrip.
- Hash-only data model: the authoritative integrity anchor is
raw_snapshot_hash(SHA-256 of the raw vendor JSON). Treat the on-chain record as the authenticity + integrity anchor; the full payload comes back in the attestation response.