Skip to main content
POST
Create an RFQ (scope: taker)

Authorizations

Authorization
string
header
required

An API key (hk_live_… / hk_test_…) with read/taker/maker scopes. read is read-only: every write except webhooks needs taker or maker (403 otherwise), and either of those can read too. Creating RFQs and listing tokens need taker; quoting needs maker.

Headers

Idempotency-Key
string

Client-chosen unique key; retries with the same key replay the first response (24h).

Body

application/json
direction
enum<string>
required
Available options:
sell_base,
buy_base
baseAssetId
string
required

asset uuid — list them with GET /v1/assets

baseAmount
string
required

base units (integer string)

quoteAssetId
string
required

asset uuid — list them with GET /v1/assets

ttlSeconds
integer
required
visibility
enum<string>
Available options:
public,
private
askAmount
string

a private order's price, base units, at most 8 decimals (fewer when the asset has fewer)

targetAddress
string

Response

created

rfq
object