1. CRX
  2. API reference
  3. Maker
  4. Request a maker test trade

Request a maker test trade

POST/test-requests

Opens a 100 USD test RFQ on USD/MXN for a funded, approved maker account. The request lasts 3 hours. CRX accepts a quote within 10 basis points of reference_rate and opens a real position. Repeat the call to get the active RFQ, or to renew it after it expires unaccepted. No new RFQ in the request's final minute. One new request per maker per UTC day; renewals do not count. A request refused for collateral not yet counted (403 forbidden) does not count either: deposit, then request again. Returns 429 while another test RFQ is in progress.

Authentication

  • x-crx-address x-crx-ts x-crx-sig
  • x-crx-address x-crx-signer x-crx-ts x-crx-sig
  • x-crx-session

Request body

FieldTypeDescription
chainstring

A chains[].key from GET /health, such as ethereum. Defaults to the host's chain.

Responses

200

The test RFQ, as the maker sees it.

Test RFQ, as the maker sees it, for a real 100 USD trade.

FieldTypeDescription
rfq_id requiredstring
chain requiredstring ethereum
pair requiredstring USDMXN
side requiredinteger -1

-1: the maker sells USD against MXN.

notional requiredstring 100

100 USD.

premium_bps requiredinteger 0
expiry requiredintegerminimum 0

Settlement time: request_expires_at plus 2 hours. Unchanged on renewal.

request_expires_at requiredintegerminimum 0

Test request deadline: 3 hours after the request opens. Unchanged on renewal.

closes_at requiredintegerminimum 0

End of this RFQ: within 120 seconds of its creation, and no later than request_expires_at. No accept after this time.

quote_expiry_max requiredinteger

Latest quote expiry, in Unix time (seconds). Use the value returned for this RFQ.

taker_ref requiredstring
status requiredstring open quoted accepted opened settled expired cancelled
test_request requiredboolean true
reference_rate requiredstring

Reference rate, in MXN per USD. A quote more than 10 basis points away is refused.

400

bad_request: send only chain with the value ethereum.

401

unauthorized: a header is missing or malformed, x-crx-ts is out of range, the call was already used, the signature does not match, or the caller lacks access.

code unauthorized

403

not_whitelisted, forbidden or seat_cannot_sign: the account cannot make test requests, or its counted free collateral does not cover the test trade (forbidden; the request does not count).

404

unknown_rfq: test requests are unavailable.

429

rate_limited: the daily limit is reached, or a test request is in progress. Retry after Retry-After.

HeaderTypeDescription
Retry-Afterinteger

Seconds until the next request is accepted.

503

mark_unavailable: the reference price is unavailable.

default

Request refused; code and message give the reason.