Convert field notes
API Reference · Convert
Guides: Convert Overview
Get Quote — POST /v1/stable/order/get-quote
| Field | required | enum / constraint | example | description |
|---|---|---|---|---|
businessType | yes | STABLE_BUY | STABLE_SELL | STABLE_TRANSFER | STABLE_SWAP | STABLE_BUY | FX type. TRANSFER=fiat→fiat; SWAP=stable→stable |
paymentMethod | yes* | VIRTUAL_ACCOUNT | BANK_TRANSFER (+ entitled values) | VIRTUAL_ACCOUNT | Must match supported pair |
sourceCurrency / targetCurrency | yes | ISO / asset codes | BRL / USDT | Currencies |
sourceAmount / targetAmount | conditional | decimal strings; SWAP requires sourceAmount | "1000.00" | Usually one side |
Success data highlights
quoteId, one-way price, fees (ourFee / payInFee / payOutFee), expireTime (epoch ms).Submit Order — POST /v1/stable/order/submit-order
| Field | required | example | description |
|---|---|---|---|
quoteId | yes | qt_123 | Unexpired quote |
merchantOrderId | recommended | m_20260730_001 | Idempotency / recon |
remarks | no | note | Free text |
orderStatus: processing | success | fail. Webhook: STABLE_ORDER_UPDATED.openapi/merchant-core.openapi.json.