Skip to main content
POST
Create Marketplace Intent

Authorizations

Authorization
string
header
required

API key authentication using Bearer token

Body

application/json
sourceCurrency
string
required

The ISO currency code you are sending.

Example:

"NGN"

destinationCurrency
string
required

The currency or token you wish to receive.

Example:

"USDT"

amount
number
required

The quantity to be exchanged.

Example:

20000

rate
number
required

The proposed exchange rate.

Example:

20000

amountDirection
enum<string>
required

Indicates if the 'amount' field refers to the source or destination currency.

Available options:
source,
destination
Example:

"destination"

Response

Quote created successfully

quoteId
string<uuid>

Unique quote identifier

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

status
enum<string>

Quote status

Available options:
pending,
awaiting_payment,
completed,
expired,
cancelled
Example:

"pending"

source
string

Source currency

Example:

"NGN"

destination
string

Destination currency

Example:

"USDT"

chain
string

Blockchain network

Example:

"BASE"

amount
number

Requested amount

Example:

50000

totalSourceAmount
number

Total amount in source currency

Example:

50000

totalDestinationAmount
number

Total amount in destination currency

Example:

31.65

clientId
string<uuid>

Client identifier

mode
enum<string>

Operating mode

Available options:
live,
sandbox
Example:

"live"

ttl
integer

Time to live in seconds

Example:

300

allocationResult
object
metadata
object
chatMetadata
object

Metadata for chat-based quote negotiation