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
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
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.
Health
Returns operational status. Public callers see status only; owner callers (with admin secret) see detailed checks for storage, XRPL, treasury, and yield distribution.
XRP price
Returns the current XRP/USD reference price used by public calculators, plus a 24-hour change value and cache/staleness flags.
APY value tiers
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.
Card waitlist count
Returns the current Xora Card waitlist count. Card network, fees, and limits remain roadmap items until card access appears in the app.
Validator status
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.
Agent facts & multi-asset rail rates
/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.
Model Context Protocol (Streamable HTTP 2025-03-26, protocolVersion 2024-11-05) & OAuth 2.1
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).
- 6 XRP and XORA read, deposit, and onboarding tools (10 MCP tools total): xora_get_balance (XRP and XORA balances plus XRP lockup/withdrawable split; other assets are not included), xora_get_yield (XRP yield only), xora_get_transactions (recent XRP deposits and withdrawals only), xora_get_deposit_address (XRPL treasury address and required 9-digit destination tag only), xora_buy_xrp, and xora_pitch. Multi-rail balances and deposit routes for non-XRP assets live in /app.
- 4 multi-rail staged payment-intent tools: xora_prepare_payment, xora_get_payment_intent, xora_list_payment_intents, xora_cancel_payment_intent across XRP, BTC, TRX, XLM, and GRAM.
- Step-up gated execution: Agents never receive private keys or withdrawal secrets. xora_prepare_payment stages a 15-minute intent (xpay_...) that executes only after the account holder completes passkey (WebAuthn), enrolled strong-factor (TOTP), or fresh interactive step-up approval on /connect or /account/approve (?id=xpay_...).
Live platform usage counters (numbers.xora.finance)
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
- /api/agent/facts: 60 requests per minute per IP.
- /api/health and /api/status: 30 requests per minute per IP. Public response is minimal.
- /api/xrp/price: 30 requests per minute per IP.
- /api/multiasset/rates: 20 requests per minute per IP.
- /api/waitlist/count: 20 requests per minute per IP.
- /api/xrp/yield/tiers: 10 requests per minute per IP.
- /api/validator: 10 requests per minute per IP.
- Exceeded limits return HTTP 429 with {"error":"Too many requests"}. Back off and retry.
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
- Public endpoint shapes are intentionally minimal. Admin-only treasury and user statistics are not part of the public API contract.
- Major versioning: none yet. If public versioned APIs are introduced, they will be documented here before launch.
- Changes are posted on the blog and mirrored to llms.txt.
Related resources
- Embeddable XRP yield rate widget for publishers and communities.
- Compare XRP lending platforms in 2026 and crypto neobanks ranked by yield.
- Reserve your @handle on XORA Card or browse Creator Bounties.
Contact
For integration support, custom endpoints, or higher rate limits: api@xora.finance. For security issues, see security.
Direct rails: XRP · RLUSD (RLUSD deposits currently closed) · BTC · XLM · TRX · RLUSD on XRPL