Merchant API: first request in 5 minutes

Four steps from key creation to working webhooks. All examples are ready-to-run curl commands against the production API; the full method reference lives in the docs.

1. Create an API key

In your EIDEX dashboard open the API keys section and create a pair: API Key (UUID) and Secret Key (64 hex). The key activates after admin approval — usually within one business day.

2. Check balances

Your first call — GET /balances: verify authentication works and you can see merchant accounts.

curl -s https://eidex.io/api/merchant/v1/balances \
  -H "X-API-Key: <your-api-key>" \
  -H "X-API-Secret: <your-api-secret>"

3. Fetch tickers

GET /tickers returns live pair rates — enough to display prices in your exchanger.

curl -s https://eidex.io/api/merchant/v1/tickers \
  -H "X-API-Key: <your-api-key>" \
  -H "X-API-Secret: <your-api-secret>"

4. Set up webhooks

Subscribe to deposit and withdrawal events — more reliable and faster than polling the API in a loop.

curl -s -X POST https://eidex.io/api/merchant/v1/webhooks \
  -H "X-API-Key: <your-api-key>" \
  -H "X-API-Secret: <your-api-secret>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-exchanger.example/webhook","events":["deposit.confirmed","withdraw.completed"]}'