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

دریافت لیست معاملات انجام شده

👋 Introduction​

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

🔗 Endpoint​

GET /api/v1/odr/fills/

⏱ Rate Limit​

اطلاعیه

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

📨 Request Example​

curl --location --request GET 'https://api.bitpin.ir/api/v1/odr/fills/' \  
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

🛠 Request Params​

ParameterDescriptionTypeRequiredExample
symbolنام بازار که معامله در آن صورت گرفتهStringخیرBTC_IRT
sideسمت معامله (مثلاً خرید یا فروش)Stringخیرbuy
offsetشناسه معاملاتی که باید کمتر از این مقدار باشدIntegerخیر65375307
limitحداکثر تعداد معاملات دریافتی (حداکثر: 100)Integerخیر100

💬 Success Response​

[
    {
        "id": 65375307,
        "symbol": "PIXFI_IRT",
        "base_amount": "63.0",
        "quote_amount": "123417",
        "price": "1959",
        "created_at": "2024-07-29T14:07:34.534824+03:30",
        "commission": "0",
        "side": "sell",
        "commission_currency": "IRT",
        "order_id": 535179385,
        "identifier": null
    },
    {
        "id": 65375268,
        "symbol": "PIXFI_IRT",
        "base_amount": "63.0",
        "quote_amount": "123228",
        "price": "1956",
        "created_at": "2024-07-29T14:06:56.095051+03:30",
        "commission": "0.0",
        "side": "buy",
        "commission_currency": "PIXFI",
        "order_id": 535178666,
        "identifier": null
    }
]

🗝️ Response Keys - کلیدهای پاسخ​

  • id: شناسه معامله.
  • symbol: نام بازاری که معامله توش انجام شده.
  • base_amount: مقدار ارز پایه که در معامله جابجا شده.
  • quote_amount: مقدار ارز مبادله‌ای که در معامله جابجا شده.
  • price: قیمت هر واحد ارز پایه در زمان معامله.
  • created_at: زمان ایجاد معامله، با توجه به منطقه زمانی.
  • commission: هزینه کارمزد معامله.
  • side: سمت معامله (خرید یا فروش).
  • commission_currency: واحد پول کارمزد.
  • order_id: شناسه سفارش مرتبط با این معامله.
  • identifier: شناسه خاص معامله (اگه وجود داشته باشه).