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…

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)

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.

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

201Request created successfully

400Invalid request data