Skip to main content

Create a trade quote

POST 
/v1/trades/quotes

Creates a trade quote between two assets for trading. Validates user membership has OTC_TRADE access and that the assets can be traded.

Request​

Body

required

Trade quote request

    fromAssetId stringrequired

    Asset identifier to trade from (UUID, type string like BTC, or ISO 4217 code)

    toAssetId stringrequired

    Asset identifier to trade to (UUID, type string like USDT, or ISO 4217 code)

    fromAmount stringrequired

    Amount of the source asset to trade

    feeAssetId stringrequired

    Asset identifier to pay fees with - must match either fromAssetId or toAssetId (UUID, type string, or ISO 4217 code)

    side stringrequired

    Possible values: [buy, sell]

    Trading side: buy to purchase the base asset, sell to sell the base asset

    direction stringrequired

    Possible values: [direct, reverse]

    Direction: direct if assets match available pair order, reverse if swapped

Responses​

Trade quote created successfully

Schema

    traceId string
    message string

    data

    object

    quoteId stringrequired

    Unique quote identifier for trade execution

    pricePerUnit stringrequired

    Price per unit of the target asset

    fee numberrequired

    Fee percentage (as decimal)

    feeAmount stringrequired

    Fee amount in the fee asset

    totalPrice stringrequired

    Total price to pay for the trade

    totalToReceive stringrequired

    Total amount to receive after fees

    expiresAt stringrequired

    Expiration timestamp for the quote

    disclaimer stringrequired

    Disclaimer about trade execution

Loading...