Documentation

Build with Riddle Partners

Drop-in widgets and a REST API for Swap, Bridge, and Cafe — plus programmable buy buttons and your own swap UI, signed in Riddle Wallet. Mainnet only. Wallet is never iframed. Xaman keys stay on the server.

Live demo

demo.riddlewallet.com — partner riddle-demo, real embeds.

5-minute setup

Signup, allowlist origin, mount a widget.

Buy buttons & custom UI

Your checkout. Our wallet popup.

REST catalog

Quote, prepare, sign session, wallets, monitor.

Quick start

<script src="https://partners.riddlewallet.com/riddlepartners.js"></script>
<div data-riddle-embed data-product="swap" data-partner="acme"></div>
<button data-riddle-buy data-partner="acme" data-chain="xrpl" data-to="r…" data-amount="1">
  Buy
</button>

Auth: X-Api-Key: rpk_live_… (server). Quote smoke: rpk_test_demo_riddle_partners_quote_smoke_key01

Platform fees: swap 0.85%, bridge 1.20%, cafe 1%. Growth share 30% of platform fee.