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. Успішна відповідь — масив записів активності верхнього рівня.

Довідкові ціни

  • Тарифікація: фіксована базова вартість успішного запиту.
  • Довідкова оцінка запиту: USD 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

    Нижня межа часового вікна активності (в секундах епохи). Опустіть або передайте 0 для вікна за замовчуванням (останні ~3 роки); передайте додатне значення епохи (наприклад, 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

      ID токена, до якого належить цей рядок. Заповнюється в рядках REDEEM токеном, який цей рядок розраховує. Порожній, якщо рядок не стосується конкретного токена.

    • bio
      Тип: string
    • conditionId
      Тип: string · Response65D835437A58_Hash64

      64-символьний hex-рядок з префіксом 0x

    • eventSlug
      Тип: string
    • icon
      Тип: string

      Зображення маркету. Якщо маркет не має власної іконки, використовується зображення маркету, потім іконка та зображення батьківської події. Порожнє в рядках CONVERSION.

    • isCombo
      Тип: boolean

      True, якщо цей рядок є частиною комбінованої (мультимаркетної) позиції. Лише прапорець — деталі комбінації тут не вбудовуються. conditionId рядка дорівнює combo_condition_id комбінації; передайте його в /v1/activity/combos або /v1/positions/combos через market_id, щоб отримати плечі та деталі. У рядках без комбінації пропускається.

    • 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