Xora public API

Read-only endpoints for platform status, health, XRP price, APY value tiers, TRX pilot context, 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

XORA also exposes authenticated MCP tools for ChatGPT and Claude Desktop. For the user-facing setup flow, see 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. The trx object is non-user-specific: it describes 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" }

Rate limits

/api/health — 30 requests per minute per IP. Designed for uptime monitors. Public response is minimal.
/api/xrp/price — 30 requests per minute per IP.
/api/xrp/yield/tiers — 10 requests per minute per IP.
/api/waitlist/count — 20 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.

Contact

For integration support, custom endpoints, or higher rate limits: api@xora.finance. For security issues, see security.

XORA · Public API Last updated 2026-06-29