Skip to content
API Documentation

Xora public API

Read-only endpoints for platform status, health, XRP price, APY value tiers, TRX pilot context, multi-asset rail flags (XRP, BTC, XLM, TRX, RLUSD on XRPL, plus GRAM on TON where enabled and announced in-app), MCP discovery, card waitlist count, and validator status. Treasury, TVL, wallet, and user-balance statistics are private and require admin access.

Base URL

https://xora.finance/api

AI app integration, MCP & Web Bot Auth

XORA exposes a Streamable HTTP Model Context Protocol (2025-03-26, wire protocolVersion: "2024-11-05") server at https://xora.finance/api/mcp for ChatGPT Connectors, Claude Connectors, and MCP clients. Users can copy the one-click MCP connector URL and stage or approve transfers on the live passkey approval sheet at xora.finance/connect, manage scoped xora_sk_ bearer keys at /account/api-keys, and read the full setup walkthrough in how to buy XRP from ChatGPT or Claude.

Endpoints

Platform status

GET /api/status public · 30 req/min/IP

Returns public runtime capability context for integrations. Privileged status checks also expose the non-user-specific trx object (trxDepositEnabled, trxWithdrawEnabled, trxYieldEnabled) describing the native TRX on Tron pilot, not any account balance or treasury amount.

{ "status": "ok", "trx": { "network": "mainnet", "depositEnabled": true, "withdrawEnabled": true, "yieldEnabled": true, "apyRate": 0.28, "nativeOnly": true, "memoRequired": false, "trc20Credited": false, "variable": true, "guaranteed": false } }

Health

GET /api/health public · 30 req/min/IP

Returns operational status. Public callers see status only; owner callers (with admin secret) see detailed checks for storage, XRPL, treasury, and yield distribution.

{ "status": "healthy", "timestamp": "2026-05-28T09:00:20.672Z" }

XRP price

GET /api/xrp/price public · 30 req/min/IP

Returns the current XRP/USD reference price used by public calculators, plus a 24-hour change value and cache/staleness flags.

{ "usd": 1.29, "change24h": -0.42, "cached": true, "stale": false }

APY value tiers

GET /api/xrp/yield/tiers public · 10 req/min/IP

Returns the published XORA APY value tier structure. XRP tiers separate native XRP yield from estimated XORA reward value; the native TRX on Tron pilot can display 28% APY when enabled in-app. XORA token quantity remains separate from APY value.

{ "tiers": [ { "range": "0-1,000 XRP", "xrpApyRate": 0.15, "xoraValueApyRate": 0.07, "headlineApyRate": 0.22, "label": "22% APY value" } ], "network": "mainnet" }

Card waitlist count

GET /api/waitlist/count public · 20 req/min/IP

Returns the current Xora Card waitlist count. Card network, fees, and limits remain roadmap items until card access appears in the app.

{ "count": 128 }

Validator status

GET /api/validator public · 10 req/min/IP

Returns XORA's XRPL validator identity and cached node status. XRPL validators do not pay XRP rewards; this endpoint is for network and monitoring transparency.

{ "pubkey": "n9Mx7JgbyGNnmH5xp7cozKyzvZeYQpkj9RkY8RQc3SkzuaFTiwR9", "network": "mainnet", "domain": "xora.finance", "status": "active" }

Agent facts & multi-asset rail rates

GET /api/agent/facts public · 60 req/min/IP · Accept-Signature
GET /api/multiasset/rates public · 20 req/min/IP

/api/agent/facts returns machine-readable runtime configuration flags (deposits_open, withdrawals_open, yield_paying), target APY splits, explicit non-claims (not_true, including that the XORA Card has not been issued), and agent_protocol metadata across XRP, BTC, XLM, TRX, and RLUSD on XRPL (plus GRAM on TON in /api/multiasset/rates once enabled and announced in-app). Rates are variable, not guaranteed, and subject to account, treasury, reconciliation, and risk controls with no fixed lock-up.

{ "source": "https://xora.finance/api/agent/facts", "rails": { "XRP": { "deposits_open": true, "withdrawals_open": true, "yield_paying": true, "headline_apy_rate": 0.22 } }, "agent_protocol": { "mcp_endpoint": "https://xora.finance/api/mcp", "web_bot_auth": { "rfc9421": true, "tag": "web-bot-auth" }, "payment_intents": { "supported_assets": ["XRP", "BTC", "TRX", "XLM", "GRAM"], "review_url": "https://xora.finance/account/approve" } } }

Model Context Protocol (Streamable HTTP 2025-03-26, protocolVersion 2024-11-05) & OAuth 2.1

GET /.well-known/mcp.json public · MCP discovery · Accept-Signature
GET /api/mcp public · capability probe · Accept-Signature
POST /api/mcp Bearer auth · JSON-RPC 2.0

Authenticated Streamable HTTP MCP endpoint (2025-03-26 transport specification, wire protocolVersion: "2024-11-05") supporting ChatGPT and Claude Connectors via OAuth 2.1 + PKCE + Dynamic Client Registration (/.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server) as well as scoped xora_sk_ bearer tokens (with an optional per-payment USD cap, or a per-payment XRP cap that restricts xora_prepare_payment to XRP) created at /connect or /account/api-keys. XORA publishes Accept-Signature on /api/mcp, /.well-known/mcp.json, /.well-known/oauth-protected-resource, /.well-known/oauth-authorization-server, and /api/agent/facts, verifying incoming RFC 9421 Web Bot Auth HTTP Message Signatures (Signature-Agent Ed25519 and rsa-pss-sha512 keys from trusted agent origins chatgpt.com, openai.com, claude.ai, and anthropic.com).

Live platform usage counters (numbers.xora.finance)

GET https://numbers.xora.finance/api/numbers public · usage activity counters

Powers numbers.xora.finance with live non-financial platform usage activity counters (accounts opened, deposits, withdrawals, yield credits, and countries). It does not report TVL, reserves, or treasury balances.

Rate limits

CORS

Documented read-only endpoints set Access-Control-Allow-Origin: *. Browser-side aggregators can fetch directly without a proxy. Authenticated, admin, and write endpoints stay restricted to Xora origins.

Stability and changelog

Related resources

Contact

XORA · Public API Last updated 2026-11-15