Skip to main content
POST
Convert between wallets

Authorizations

Authorization
string
header
required

Secret API key from Dashboard → Developers: kp_sandbox_… for Sandbox, kp_live_… for Production. Server-side only.

Headers

Idempotency-Key
string

Unique key (a UUID is ideal) for this operation. Retrying with the same key returns the original result instead of creating a duplicate.

Maximum string length: 128

Body

application/json
from
enum<string>
required

ISO currency code (fiat) or stablecoin ticker.

Available options:
XOF,
XAF,
NGN,
GHS,
CDF,
EUR,
USD,
USDC,
USDT
to
enum<string>
required

ISO currency code (fiat) or stablecoin ticker.

Available options:
XOF,
XAF,
NGN,
GHS,
CDF,
EUR,
USD,
USDC,
USDT
amount
string
required

Decimal amount with up to 8 fractional digits, e.g. "1500" or "1500.75"

Pattern: ^\d+(\.\d{1,8})?$
reference
string

Your own reference for this conversion. Generated (tx_…) when omitted.

Maximum string length: 64

Response

Success

ok
enum<boolean>
required
Available options:
true
data
object
required