Merchant API: yêu cầu đầu tiên trong 5 phút

Bốn bước từ lúc tạo khóa đến khi webhook hoạt động. Tất cả ví dụ đều là lệnh curl chạy được ngay với API môi trường production; tham chiếu đầy đủ các phương thức nằm trong tài liệu.

1. Tạo khóa API

Trong bảng điều khiển EIDEX, mở mục khóa API và tạo một cặp: API Key (UUID) và Secret Key (64 ký tự hex). Khóa được kích hoạt sau khi quản trị viên phê duyệt — thường trong vòng một ngày làm việc.

2. Kiểm tra số dư

Lệnh gọi đầu tiên của bạn — GET /balances: xác nhận việc xác thực hoạt động và bạn thấy được các tài khoản thương nhân.

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

3. Lấy dữ liệu ticker

GET /tickers trả về tỷ giá theo thời gian thực của các cặp — đủ để hiển thị giá trong điểm đổi tiền của bạn.

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

4. Thiết lập webhook

Đăng ký nhận sự kiện nạp tiền và rút tiền — đáng tin cậy và nhanh hơn việc gọi API lặp liên tục.

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"]}'