پرش به مطلب اصلی

سفارش لیمیت (Limit Order)

👋 Introduction​

سفارش لیمیت این امکان رو بهت می‌ده که خرید یا فروش ارز دیجیتال خودت رو با قیمتی که خودت تعیین می‌کنی انجام بدی.
این نوع سفارش فقط وقتی اجرا می‌شه که قیمت بازار به قیمت تعیین‌شده توسط تو برسه.

مثلا فرض کن می‌خوای 100 واحد تتر (USDT) رو با قیمت 62000 تومان بخری. برای این کار از سفارش لیمیت استفاده می‌کنی.

🔗 Endpoint​

POST /api/v1/odr/orders/

⏱ Rate Limit​

اطلاعیه

حداکثر تعداد درخواست‌های مجاز برای ثبت سفارش برابر با 5400 درخواست در ساعت هست.

📨 Request​

curl --location --request POST 'https://api.bitpin.ir/api/v1/odr/orders/' \  
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \  
--header 'Content-Type: application/json' \  
--data '{
    "symbol": "USDT_IRT",
    "type": "limit",
    "side": "buy",
    "price": 62000,
    "base_amount": 100
}'

🛠 Request Params​

ParameterDescriptionTypeRequiredExample
symbolنام بازار (مثل USDT_IRT)StringبلهUSDT_IRT
typeنوع سفارش (limit)Stringبلهlimit
sideساید سفارش (buy یا sell)Stringبلهbuy
priceقیمت پیشنهادی برای خرید یا فروشIntegerبله62000
base_amountمقدار رمزارز برای خرید یا فروشIntegerبله100

💬 Success Response​

{
        "symbol": "USDT_IRT",  
        "type": "limit",  
        "side": "buy",  
        "base_amount": "100",  
        "quote_amount": "6200000",  
        "price": "62000",  
        "stop_price": null,  
        "oco_target_price": null,  
        "identifier": "716848bc-3f15-4b28-b113-0ce8dc621eff",  
        "state": "active",  
        "created_at": "2024-06-15T10:00:00.000000+03:30",  
        "closed_at": null,  
        "dealed_base_amount": "0",  
        "dealed_quote_amount": "0",  
        "req_to_cancel": false,  
        "commission": "0.5"  
}

Additional Notes​

  • حتماً مطمئن شو که symbol و type رو درست انتخاب کردی، چون اینا تعیین می‌کنن که سفارش‌ت تو کدوم بازار و به چه نوعی ثبت بشه.
  • identifier خیلی مفیده اگه بخوای سفارش‌هات رو پیگیری کنی یا از ثبت سفارش‌های تکراری جلوگیری کنی.
  • اگه قیمت بازار به حد تعیین‌شده نرسه، سفارش‌ت فعال باقی می‌مونه تا وقتی که یا قیمت به حد برسه یا خودت سفارش رو لغو کنی.