Swap REST endpoints

All paths below are relative to https://api.navoswap.com/api/v1.

GET /swap/quote

Query parameters:

  • currency_from, currency_to (required): Asset params as used by the catalog (e.g. BTC, USDTETH).
  • amount_from: For float-rate flow (amount you send).
  • amount_to: For fixed-rate flow together with fixed=true.
  • is_anonym: Optional boolean for privacy-oriented routing when supported.
  • fixed: Optional boolean; fixed-rate mode.

Response body wraps a data object with indicative amount_from, amount_to, min/max bounds, optional USD fields, and timing hints.

POST /swap/create

JSON body (CreateSwapDto):

  • currency_from, currency_to (string)
  • address_to (string): Destination address
  • amount_from or amount_to (number, optional): Depending on float vs fixed
  • receiver_memo_tag (string, optional)
  • is_anonym (boolean, optional)
  • fixed (boolean, optional)
  • source (number, optional)

Send the optional x-navoswap-api-key header so the order is attributed to your partner account. Successful responses include order_info (public order id string) for status polling.

GET /swap/status

Query: order_id. Returns latest order fields (status code, amounts, addresses, flags, creation time).

GET /swap/usd

Query: currency_from, amount_from. Server-side USD reference for the from leg; not a trade guarantee.