Skip to main content
Marketplace orders let your business buy an asset at a price it sets, and answer offers with a counter-offer. You can create, list, and withdraw orders through the API.
The marketplace is available to approved businesses only. If your business isn’t approved, every marketplace endpoint returns 403 with FEATURE_NOT_AVAILABLE_FOR_BUSINESS. Contact support@afriex.com to ask for approval.

Orders

An orderId names its side: BUY-12 is an offer and SELL-3 is a counter-offer. Use List Available Marketplace Offers to see the offers you can answer. Amounts are decimal values in the asset’s main unit, sent as strings:

Order statuses

A counter-offer never expires. It waits for Afriex to review it.

Repeating a request safely

Send a clientOrderId, your own id for the order, unique for your business. If you repeat a create with a clientOrderId you already used, the API returns 409 with DUPLICATE_REQUEST and creates nothing, so a retry never places a second order. Look the order up with List Marketplace Orders.

API key permissions

Listing and getting orders needs MARKET_PLACE.READ. Creating, counter-offering, and withdrawing needs MARKET_PLACE.MANAGE. In the dashboard, these are the Marketplace orders resource. See Permissions.

Rate limit

Creating orders and counter-offers share one limit of 60 requests per business per 60 seconds. Going over it returns 429. See Rate limits.