Quick start
Four steps from zero to your first sale.
Get your key
In the VEXORIX store bot: Profile → API Access. Ask for access if you don't have it yet. The key is shown once — save it.
Top up your wallet
Orders are paid from your bot wallet (USDT). Check it any time with GET /me.
List the products
GET /products gives prices and live stock. Show them in your own bot with your own margin.
Place orders
When your customer pays you, call POST /orders and send them items[].content.
Authentication
Send your key in a header with every request. All three forms are accepted:
Code examples
Pick an action and a language — copy, replace YOUR_API_KEY, done.
Endpoints
Click an endpoint to open it. Every one has a live Try it box that uses your key.
Errors
Always the same shape. Branch on error.code — it never changes. message is plain English.
| HTTP | code | What it means |
|---|
out_of_stock and insufficient_stock messages are written for end customers — you can show them to your own buyer as they are. Nothing is charged on any error.Safe ordering & retries
Networks fail. Make sure a retry can never buy twice.
Send your own order number as external_order_id (8–64 chars: letters, digits, . _ : -) or as an Idempotency-Key header. The same value always returns the same order and is charged only once — even if your first request timed out.
- A repeat returns HTTP 200 with header
Idempotent-Replay: true(a new order is 201). - Lost the response? Look the order up with
GET /orders?external_order_id=…. - Got a timeout and no order? Retry with the same
external_order_id— never generate a new one for the same customer order.
X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. On 429 wait Retry-After seconds.Profit calculator
You pay the VEXORIX price, you sell at your own price. Play with the numbers.
Good practice
Check before you sell
Call GET /stock or POST /quote before taking your customer's money. Stock is shared with the store and other resellers, so it can drop at any time.
Always use external_order_id
One per customer order. Retries become safe and you can always find the order again.
Back off on 429 / 503
Wait retry_after_seconds and try again. Don't hammer the API.
Store the codes
Save items[].content on your side right away, then deliver. You can also re-read any order later.