بازار اسپات (حرفه ای)

فرمت نماد

نماد معاملاتی در تمام API های اسپات به شکل BASE-QUOTE و با خط تیره است؛ مثل BTC-USDT، ETH-USDT یا USDT-IRT. فهرست نمادهای معتبر را از فیلد symbol در پاسخ لیست نمادهای معاملاتی دریافت کنید.

اگر نماد ارسالی معتبر نباشد، پاسخ با کد HTTP 400 و خطای «نماد نامعتبر است» برمی‌گردد.

لیست نمادهای معاملاتی

برای دریافت لیست نمادهای معاملاتی و پارامترهای آنها از این درخواست استفاده کنید:

درخواست

GET /api/v1/spot/public/pairs

پاسخ نمونه

[
  {
    "symbol": "BTC-USDT",
    "base": "BTC",
    "quote": "USDT",
    "priceTick": 0.01,
    "quantityTick": 0.00001,
    "minNotional": 10.0,
    "maxNotional": 1000000.0,
    "orderTypes": "LIMIT,MARKET,STOP_LIMIT,STOP_MARKET",
    "isTrade": true,
    "isCancelOrder": true
  }
]

تیکر تمام نمادها

برای دریافت اطلاعات تیکر تمام نمادهای معاملاتی:

درخواست

GET /api/v1/spot/public/tickers

پاسخ نمونه

{
  "tickers": [
    {
      "symbol": "BTC-USDT",
      "lastPrice": "50000.00",
      "openPrice": "49500.00",
      "highPrice": "50200.00",
      "lowPrice": "49000.00",
      "volume": "1250.5",
      "quoteVolume": "62525000.0",
      "priceChange": "500.00",
      "priceChangePercent": "1.01",
      "weightedAvgPrice": "49875.25",
      "updateTime": "1672531200000"
    }
  ]
}

تیکر یک نماد

برای دریافت اطلاعات تیکر یک نماد مشخص:

درخواست

GET /api/v1/spot/public/ticker/{symbol}

پارامترها

نام	نوع	اجباری	توضیحات
symbol	string	بله	نماد معاملاتی

پاسخ نمونه

{
  "symbol": "BTC-USDT",
  "lastPrice": "50000.00",
  "openPrice": "49500.00",
  "highPrice": "50200.00",
  "lowPrice": "49000.00",
  "volume": "1250.5",
  "quoteVolume": "62525000.0",
  "priceChange": "500.00",
  "priceChangePercent": "1.01",
  "weightedAvgPrice": "49875.25",
  "updateTime": "1672531200000"
}

دفتر سفارشات

برای دریافت دفتر سفارشات (bids و asks) یک نماد:

درخواست

GET /api/v1/spot/public/books

پارامترها

نام	نوع	اجباری	توضیحات
symbol	string	بله	نماد معاملاتی
limit	integer	خیر	تعداد سطوح (پیش‌فرض: 100، مقادیر معتبر: 5, 10, 20, 50, 100)

نمونه درخواست

GET /api/v1/spot/public/books?symbol=BTC-USDT&limit=20

پاسخ نمونه

هر سطح به شکل [قیمت, مقدار] است. bids سفارشات خرید (از بیشترین قیمت) و asks سفارشات فروش (از کمترین قیمت) هستند.

{
  "id": 1789473487146,
  "bids": [
    [85994.36, 0.00263],
    [85989.17, 0.02022]
  ],
  "asks": [
    [86001.26, 0.01802],
    [86010.73, 0.04284]
  ]
}

پاسخ خطا (نماد نامعتبر)

{
  "code": 118,
  "error": "نماد نامعتبر است"
}

معاملات اخیر

برای دریافت معاملات اخیر یک نماد:

درخواست

GET /api/v1/spot/public/trades

پارامترها

نام	نوع	اجباری	توضیحات
symbol	string	بله	نماد معاملاتی
limit	integer	خیر	تعداد معاملات (پیش‌فرض: 500، حداکثر: 1000)

پاسخ نمونه

[
  {
    "id": 28457,
    "price": "50000.00",
    "qty": "0.1",
    "quoteQty": "5000.00",
    "time": 1672531200000,
    "isBuyerMaker": true
  }
]

داده کندل

برای دریافت داده کندل یک نماد در بازه زمانی مشخص:

درخواست

GET /api/v1/spot/public/candles

پارامترها

نام	نوع	اجباری	توضیحات
symbol	string	بله	نماد معاملاتی
interval	string	بله	بازه زمانی (مثل: 1m, 5m, 15m, 1h, 4h, 1d)
startTime	integer	بله	زمان شروع به میلی‌ثانیه
endTime	integer	بله	زمان پایان به میلی‌ثانیه
limit	integer	خیر	تعداد کندل (پیش‌فرض: 100، حداکثر: 500)
offset	integer	خیر	آفست (پیش‌فرض: 0)

نمونه درخواست

GET /api/v1/spot/public/candles?symbol=BTC-USDT&interval=1h&startTime=1672531200000&endTime=1672617600000

API های معاملات اسپات

احراز هویت

برای استفاده از این API ها، استفاده از x-signature در header الزامی است.

x-timestamp: 1757927712000
x-api-key: YOUR_API_KEY 
x-signature: YOUR_SIGNATURE_HASH

ثبت سفارش جدید

برای ایجاد سفارش جدید:

درخواست

POST /hapi/v1/spot/order

پارامترهای ورودی

نام	نوع	اجباری	توضیحات
symbol	string	بله	نماد معاملاتی
side	string	بله	جهت سفارش (BUY/SELL)
type	string	بله	نوع سفارش (LIMIT/MARKET/STOP_LIMIT/STOP_MARKET/TAKE_PROFIT_LIMIT/TAKE_PROFIT_MARKET)
qt	number	بله	مقدار سفارش (در سفارشات market مقدار به USDT می باشد)
price	number	خیر	قیمت (برای سفارشات LIMIT)
stopPrice	number	خیر	قیمت توقف (برای سفارشات STOP)
clientOrderId	string	خیر	شناسه سفارش کاربر

نمونه درخواست

{
  "symbol": "BTC-USDT",
  "side": "BUY",
  "type": "LIMIT",
  "qt": 0.001,
  "price": 45000.0,
  "clientOrderId": "my_order_123"
}

پاسخ نمونه

{
  "id": 12345,
  "symbol": "BTC-USDT",
  "side": "BUY",
  "type": "LIMIT",
  "quantity": 0.001,
  "price": 45000.0,
  "filled": 0.0,
  "avgPrice": 0.0,
  "status": "CREATED",
  "clientOrderId": "my_order_123",
  "createdAt": 1672531200000
}

لغو سفارش

برای لغو یک سفارش موجود:

درخواست

POST /hapi/v1/spot/cancel

پارامترهای ورودی

نام	نوع	اجباری	توضیحات
orderId	integer	بله	شناسه سفارش
symbol	string	بله	نماد معاملاتی

نمونه درخواست

{
  "orderId": 12345,
  "symbol": "BTC-USDT"
}

پاسخ نمونه

{
  "id": 12345,
  "symbol": "BTC-USDT",
  "side": "BUY",
  "type": "LIMIT",
  "quantity": 0.001,
  "price": 45000.0,
  "filled": 0.0,
  "avgPrice": 0.0,
  "status": "CANCELED",
  "clientOrderId": "my_order_123",
  "createdAt": 1672531200000
}

لغو سفارشات با نماد

برای لغو همه سفارشات باز یک نماد:

درخواست

POST /hapi/v1/spot/cancel_all

پارامترهای ورودی

نام	نوع	اجباری	توضیحات
symbol	string	بله	نماد معاملاتی

نمونه درخواست

{
  "symbol": "BTC-USDT"
}

پاسخ نمونه

[
  {
    "id": 12345,
    "symbol": "BTC-USDT",
    "side": "BUY",
    "type": "LIMIT",
    "quantity": 0.001,
    "price": 45000.0,
    "filled": 0.0,
    "avgPrice": 0.0,
    "status": "CANCELED",
    "clientOrderId": "my_order_123",
    "createdAt": 1672531200000
  }
]

سفارشات باز

برای دریافت لیست سفارشات باز:

درخواست

GET /hapi/v1/spot/order/open

پارامترهای ورودی

نام	نوع	اجباری	توضیحات
symbol	string	خیر	نماد معاملاتی

نمونه درخواست

GET /hapi/v1/spot/order/open?symbol=BTC-USDT

پاسخ نمونه

[
  {
    "id": 12345,
    "symbol": "BTC-USDT",
    "side": "BUY",
    "type": "LIMIT",
    "quantity": 0.001,
    "price": 45000.0,
    "filled": 0.0,
    "avgPrice": 0.0,
    "status": "NEW",
    "clientOrderId": "my_order_123",
    "createdAt": 1672531200000
  }
]

تاریخچه سفارشات

برای دریافت تاریخچه سفارشات:

درخواست

GET /hapi/v1/spot/order/history

پارامترهای ورودی

نام	نوع	اجباری	توضیحات
symbol	string	خیر	نماد معاملاتی
side	string	خیر	جهت سفارش (BUY/SELL)
type	string	خیر	نوع سفارش
startTime	integer	خیر	زمان شروع به میلی‌ثانیه
endTime	integer	خیر	زمان پایان به میلی‌ثانیه
limit	integer	خیر	تعداد نتایج (پیش‌فرض: 500، حداکثر: 1000)
offset	integer	خیر	آفست (پیش‌فرض: 0)

نمونه درخواست

GET /hapi/v1/spot/order/history?symbol=BTC-USDT&limit=100

معاملات کاربر

برای دریافت تاریخچه معاملات:

درخواست

GET /hapi/v1/spot/order/trades

پارامترهای ورودی

نام	نوع	اجباری	توضیحات
symbol	string	خیر	نماد معاملاتی
order_id	integer	خیر	شناسه سفارش
limit	integer	خیر	تعداد نتایج (پیش‌فرض: 500، حداکثر: 1000)
offset	integer	خیر	آفست (پیش‌فرض: 0)

پاسخ نمونه

[
  {
    "id": 789,
    "symbol": "BTC-USDT",
    "order_id": 12345,
    "price": "45000.00",
    "qty": "0.001",
    "fee": "0.045",
    "fee_asset": "USDT",
    "role": "taker",
    "time": 1672531200000
  }
]

کیف پول

دریافت اطلاعات کاربر:

درخواست

GET /hapi/v1/spot/wallet

پاسخ نمونه

{
  "wallets": [
    {
      "asset": "SOL",
      "balance": "0.00000072",
      "frozen": "0"
    }
  ]
}