LucenDEX API Reference

Non-custodial, deterministic routing for XRPL decentralized exchange.

Partner APIIN DEVELOPMENT

B2B integration for production workloads with authentication, rate limiting, and usage-based billing.

Key Features
  • Ed25519 request signing for authentication
  • Deterministic quote generation with QuoteHash binding
  • Rate limits: 100-10,000 req/min based on plan
  • Usage metering and billing endpoints
  • System health monitoring
  • SLA guarantees
Base URL (Planned)

Future Production: https://api.lucendex.com (Not yet live)

Authentication

All endpoints require Ed25519 signature with headers:

  • X-Partner-Id: Your partner UUID
  • X-Request-Id: Unique request UUID (replay protection)
  • X-Timestamp: RFC3339 timestamp (max 60s drift)
  • X-Signature: base64(Ed25519.Sign(canonical_request))
View API Preview Express Interest

Public APICOMING IN M3

Open-access endpoints for market data and demo quotes without authentication.

Planned Features
  • No authentication required
  • Global rate limit: 100 req/min per IP
  • Trading pairs with liquidity metrics
  • Orderbook data
  • Demo quote generation
Use Cases

Testing, exploration, and demo applications. For production workloads, use the Partner API.

View Public API Plans

Core Concepts

Quote → Sign → Submit Workflow

  1. Request Quote: Call POST /partner/v1/quote with token pair and amount
  2. Receive QuoteHash: Backend returns deterministic route with QuoteHash
  3. Sign Transaction: Client wallet signs XRPL transaction with QuoteHash in memo
  4. Submit to XRPL: Client submits signed transaction directly to rippled (or via optional relay)
  5. Attribution: Indexer observes transaction on-chain, attributes to partner via QuoteHash

Non-Custodial Design

Backend never sees private keys or seed phrases. All transaction signing happens client-side in the user's wallet (GemWallet, Xumm, etc.). The QuoteHash ensures deterministic execution while maintaining full user custody.

Revenue Model

B2B usage-based billing. Partners pay monthly based on executed volume tracked via QuoteHash in XRPL transaction memos. Router fee (basis points) is included in the QuoteHash to ensure tamper-evident billing.

Getting Started

Getting Started

  1. Contact us to create partner account
  2. Receive partner UUID and Ed25519 keypair
  3. Integrate Partner API endpoints
  4. Go live with SLA coverage

Contact Us