Felo API PlatformFelo API Platform
همه endpointهای Polymarket
v0.2.0-beta
OpenAPI 3.1.0

دریافت فعالیت کیف پول Polymarket

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

Polymarket

​

Prediction-market discovery and market data.

Polymarket عملیات

دریافت فعالیت کیف پول Polymarket

​

فعالیت بازار پیش‌بینی را واکشی کنید. بازار را با مقادیر condition-ID فیلتر کنید، از start و end برای بازه زمانی و از limit و offset برای صفحه‌بندی استفاده کنید. انتخابگرهای دیگر شامل eventId، type، side، sortBy و sortDirection است. پاسخ موفق یک آرایه سطح بالا از رکوردهای فعالیت است.

مرجع قیمت‌گذاری

  • اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
  • برآورد درخواست مرجع: 0.012 دلار آمریکا.

فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

پارامترهای پرس‌وجو
  • end
    نوع: integer
    حداقل:  
    0

    مهر زمانی کران بالا (ثانیه) برای پنجره فعالیت. برای پیش‌فرض (زمان کنونی) آن را حذف کنید؛ ردیف‌های جدیدتر از end حذف می‌شوند.

  • eventId
    نوع: array integer[]
    حداقل:  
    1

    فهرست جداشده با کاما از شناسه‌های رویداد. ناسازگار با market.

  • excludeDepositsWithdrawals
    نوع: boolean

    رکوردهای واریز و برداشت را حذف می‌کند. پیش‌فرض true حتی وقتی type آن رکوردها را درخواست می‌کند اعمال می‌شود، بنابراین برای دریافت واریزها و برداشت‌ها باید false بفرستید.

  • limit
    نوع: integer
    حداقل:  
    0
    حداکثر:  
    500

    اندازه صفحه. مقادیر بیش از حداکثر به 500 محدود می‌شوند.

  • market
    نوع: array string[]

    فهرست جداشده با کاما از شناسه‌های شرط. ناسازگار با eventId.

  • offset
    نوع: integer
    حداقل:  
    0
    حداکثر:  
    5000

    شاخص شروع برای صفحه‌بندی. درخواست‌های فراتر از سقف با 400 رد می‌شوند (هرگز بی‌صدا محدود نمی‌شوند). برای خواندن تاریخچه عمیق‌تر از offset 5000، درون پنجره‌های start/end صفحه‌بندی کنید — هر پنجره بودجه offset خودش را دارد.

  • side
    نوع: string فهرست مقادیر
    مقادیر
    • BUY
    • SELL
  • sortBy
    نوع: string فهرست مقادیر
    مقادیر
    • TIMESTAMP
    • TOKENS
    • CASH
  • sortDirection
    نوع: string فهرست مقادیر

    DESC (پیش‌فرض) جدیدترین ردیف‌ها را اول برمی‌گرداند؛ ASC قدیمی‌ترین‌ها را. هر دو ترتیب پایدارند — همان کوئری در هر limit/offset همان ردیف‌ها را برمی‌گرداند، بنابراین صفحه‌ها بدون شکاف یا تکرار به هم می‌رسند.

    مقادیر
    • ASC
    • DESC
  • start
    نوع: integer
    حداقل:  
    0

    مهر زمانی کران پایین (ثانیه) برای پنجره فعالیت. برای پنجره پیش‌فرض (حدود 3 سال اخیر) آن را حذف کنید یا 0 بفرستید؛ برای بازیابی تاریخچه کامل یک مهر زمانی مثبت (مثلاً 1) بفرستید. با sortDirection=ASC، حذف start از ابتدای تاریخچه حساب می‌خواند (بدون پنجره پیش‌فرض).

  • type
    نوع: array string[] فهرست مقادیر

    فهرست جداشده با کاما از انواع فعالیت برای گنجاندن. رکوردهای DEPOSIT و WITHDRAWAL نیز به excludeDepositsWithdrawals=false نیاز دارند.

    مقادیر
    • TRADE
    • SPLIT
    • MERGE
    • REDEEM
    • REWARD
  • user
    نوع: string
    الزامی

    نشانی پروفایل کاربر (با پیشوند 0x، 40 کاراکتر هگز)

پاسخ‌ها
  • 200
    نوع: array object[] · Response65D835437A58_Activity[]

    موفقیت

    • asset
      نوع: string

      شناسه توکنی که این ردیف به آن اشاره دارد. در ردیف‌های REDEEM با توکنی پر می‌شود که آن ردیف تسویه می‌کند. وقتی ردیف مخصوص توکن نباشد، خالی است.

    • bio
      نوع: string
    • conditionId
      نوع: string · Response65D835437A58_Hash64

      رشته 64 رقم هگز با پیشوند 0x

    • eventSlug
      نوع: string
    • icon
      نوع: string

      اثر هنری بازار. وقتی بازار آیکون اختصاصی ندارد، به تصویر بازار و سپس به آیکون و تصویر رویداد والد برمی‌گردد. در ردیف‌های CONVERSION خالی است.

    • isCombo
      نوع: boolean

      وقتی این ردیف بخشی از یک موقعیت ترکیبی (چندبازاری) باشد، درست است. فقط یک پرچم — جزئیات ترکیب در اینجا جاسازی نمی‌شود. conditionId ردیف برابر combo_condition_id ترکیب است؛ آن را از طریق market_id به /v1/activity/combos یا /v1/positions/combos بفرستید تا پایه‌ها و جزئیات را بگیرید. در ردیف‌های غیرترکیبی حذف می‌شود.

    • name
      نوع: string
    • outcome
      نوع: string
    • outcomeIndex
      نوع: integer

      اندیس صفرمحور نتیجه این ردیف در آرایه outcomes بازار، به‌طوری که outcome همیشه برابر outcomes[outcomeIndex] است. در ردیف‌های REDEEM نتیجه‌ای را مشخص می‌کند که ردیف تسویه می‌کند، نه نتیجه برنده بازار را. 999 یعنی نتیجه قابل تعیین نبود، که در آن صورت outcome خالی است.

    • price
      نوع: number
    • profileImage
      نوع: string
    • profileImageOptimized
      نوع: string
    • proxyWallet
      نوع: string · Response65D835437A58_Address

      نشانی پروفایل کاربر (با پیشوند 0x، 40 کاراکتر هگز)

    • pseudonym
      نوع: string
    • side
      نوع: string فهرست مقادیر
      مقادیر
      • BUY
      • SELL
    • size
      نوع: number

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

    • slug
      نوع: string
    • timestamp
      نوع: integer قالب: int64

      Signed 64-bit integers (long type).

    • title
      نوع: string
    • transactionHash
      نوع: string
    • type
      نوع: string فهرست مقادیر
      مقادیر
      • TRADE
      • SPLIT
      • MERGE
      • REDEEM
      • REWARD
    • usdcSize
      نوع: number

      مقدار USDC برای این ردیف. در ردیف‌های REDEEM پرداخت برای نتیجه این ردیف است و برای نتیجه بازنده 0 است؛ ردیف‌های یک تسویه به کل پرداخت جمع می‌شوند.

    application/json
  • 400

    درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

  • 401

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    application/json
Request Example for get/v1/beta/polymarket/activity
curl 'https://openapi.felo.ai/v1/beta/polymarket/activity?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
[
  {
    "proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "timestamp": 1,
    "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
    "type": "TRADE",
    "size": 1,
    "usdcSize": 1,
    "transactionHash": "string",
    "price": 1,
    "asset": "string",
    "side": "BUY",
    "outcomeIndex": 1,
    "title": "string",
    "slug": "string",
    "icon": "string",
    "eventSlug": "string",
    "outcome": "string",
    "name": "string",
    "pseudonym": "string",
    "bio": "string",
    "profileImage": "string",
    "profileImageOptimized": "string",
    "isCombo": true
  }
]
Get Polymarket Wallet Activity