riddlePARTNERS

Swap API (mainnet)

Quotes and fee_extra prepare for XRPL, Solana (Jupiter), EVM (LI.FI), and XLM (Riddle Wallet). Prepare returns unsigned sign payloads for every matching wallet.

Widget setup (script, iframe, origin allowlist): Setup Swap widget.

# Quote (public demo key — read-only smoke)
GET /api/v1/swap/quote?chain=solana&fromToken=…&toToken=…&amountMinor=1000000
X-Api-Key: rpk_test_demo_riddle_partners_quote_smoke_key01

# Tokens
GET /api/v1/swap/tokens?chain=solana
X-Api-Key: rpk_test_demo_riddle_partners_quote_smoke_key01

# Prepare fee payment + swap shell (requires rpk_live_…)
POST /api/v1/swap/prepare
X-Api-Key: rpk_live_…
{
  "chain": "xrpl",
  "amountMinor": "1000000",
  "fromToken": "XRP",
  "toToken": "USD.issuer",
  "partnerBps": 0
}

# Report mainnet fee tx for partner accrual (requires rpk_live_…)
POST /api/v1/swap/report
X-Api-Key: rpk_live_…
{
  "chain": "xrpl",
  "amountMinor": "1000000",
  "feeTxHash": "…",
  "sourceTxHash": "…"
}