Setup · api

REST API keys

One key per connection. Test keys quote only; live keys prepare, create, report, sign.

Open live demo →

1. 1

   Create keys in the dashboard

   Label e.g. acme-swap-prod. Scope to swap, bridge, cafe, token, or nft so a leaked swap key cannot create bridge orders.

2. 2

   Send the header

   X-Api-Key: rpk_live_…
   # or
   Authorization: Bearer rpk_live_…

3. 3

   Server-side SDK

   Pass apiKey only on the server.

   import { createClient } from '@riddlewallet/partners'
   const riddle = createClient({
     partner: 'acme',
     apiKey: process.env.RIDDLE_PARTNER_KEY,
   })
   await riddle.api.swapPrepare({ chain: 'xrpl', amountMinor: '1000000' })

4. 4

   Monitor

   GET https://partners.riddlewallet.com/api/v1/monitor
   X-Api-Key: rpk_live_YOUR_KEY