Create a new request

post

https://api.centiiv.io/requests

Create a new conversion request. Supports both offramp (stablecoin → fiat) and onramp (fiat → stablecoin) operations.

Optional Headers:

X-Platform: Identify the application/platform making the request (e.g., "mobile-app", "web-dashboard", "api-integration")
X-Application: Alternative to X-Platform for application identification
X-Application-Name: Alternative to X-Platform for application identification

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⭐
NEW: Custom LP Routing
You can now filter and control which liquidity providers fulfill your order based on rate bounds, uptime, reliability, or preferred LP IDs. See Custom LP routing for details.

Body Params

fromAsset

string

enum

required

Source asset - can be stablecoin (for offramp) or fiat (for onramp)

toAsset

string

enum

required

Destination asset - can be fiat (for offramp) or stablecoin (for onramp)

amount

number

required

≥ 0.01

Amount to convert in the source asset

description

string

length ≤ 500

Optional description for this offramp/onramp request

beneficiary

Beneficiary information (REQUIRED for offramp requests - stablecoin to fiat)

refundAddress

string

Blockchain address to receive refunds if transaction fails (for offramp)

sender

object

Sender/depositor information (optional for onramp requests - fiat to stablecoin)

depositor

object

Depositor details for mobile-money onramps. REQUIRED for KES onramp requests (fiat → stablecoin) — the deposit is pulled from the payer mobile-money account (MPESA), so the account + holder name are required for compliance. Ignored for other currencies.

destinationAddress

string

Blockchain address to receive stablecoins (REQUIRED for onramp requests)

destinationMemoType

string

enum

Optional Stellar memo type for destinationAddress (onramp only). Defaults to "text" when destinationMemo is set without a type.

Allowed:

destinationMemo

string

Optional Stellar memo for destinationAddress (onramp only). Used when the user wallet is an exchange/custodial account that requires a memo. text: ≤28 UTF-8 bytes; id: decimal uint64 string. When set, USDC is routed via a temporary wallet and forwarded to destinationAddress with this memo.

targetNodeId

string

Optional: target a specific registered LP node to handle this request. Works for both offramp and onramp. If omitted, a node is auto-selected based on liquidity and rail support.

routing

object

Optional custom LP routing criteria. When provided, the selecting LP must satisfy every given criterion (rate range, minimum uptime, minimum reliability) and any preferred LPs are checked first, in order. If nothing matches and fallback is true (default), normal round-robin selection proceeds; when fallback is false, the request is rejected with an error. Ignored when targetNodeId is set.

metadata

object

Additional metadata for the request

network

string

enum

Defaults to STELLAR

Blockchain network to use for the transaction

Headers

idempotency-key

string

Optional idempotency key supplied by aggregators to make request creation retry-safe (used to dedupe retries).

x-environment

string

enum

Environment to use for the request

Allowed:

Responses

401

Unauthorized - Invalid or missing token

NEW: Custom LP Routing

201Request created successfully

400Invalid request data