Felo API PlatformFelo API Platform
Все эндпоинты Polymarket
v0.2.0-beta
OpenAPI 3.1.0

Получить активность кошелька Polymarket

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клиентские библиотеки
Shell Curl

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.

Query-параметры
  • 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 enum
    значения
    • BUY
    • SELL
  • sortBy
    Тип: string enum
    значения
    • TIMESTAMP
    • TOKENS
    • CASH
  • sortDirection
    Тип: string enum

    DESC (по умолчанию) возвращает сначала самые новые строки, ASC — самые старые. Оба порядка стабильны: один и тот же запрос возвращает одни и те же строки при любых limit/offset, поэтому страницы складываются без пропусков и повторов.

    значения
    • ASC
    • DESC
  • start
    Тип: integer
    мин.:  
    0

    Нижняя граница временного окна активности (в секундах эпохи). Опустите или передайте 0 для окна по умолчанию (последние ~3 года); передайте положительное значение эпохи (например, 1), чтобы получить всю историю. При sortDirection=ASC пропуск start уже читает с начала истории аккаунта (без окна по умолчанию).

  • type
    Тип: array string[] enum

    Список типов активности через запятую для включения. Записи 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 enum
      значения
      • BUY
      • SELL
    • size
      Тип: number

      Количество токенов для этой строки. В строках REDEEM это количество токенов, сожжённых для результата этой строки, поэтому при погашении обеих сторон маркета возвращается по одной строке на результат вместо одной объединённой строки.

    • slug
      Тип: string
    • timestamp
      Тип: integer Формат: int64

      Signed 64-bit integers (long type).

    • title
      Тип: string
    • transactionHash
      Тип: string
    • type
      Тип: string enum
      значения
      • TRADE
      • SPLIT
      • MERGE
      • REDEEM
      • REWARD
    • usdcSize
      Тип: number

      Сумма в USDC для этой строки. В строках REDEEM это выплата по результату этой строки, и она равна 0 для проигрышного результата; строки одного погашения в сумме дают общую выплату.

    application/json
  • 400

    Запрос не удалось обработать. Проверьте параметры запроса.

  • 401

    Требуется действительный API-ключ Felo.

  • 402

    Запрос не может быть выполнен: не выполнено требование биллинга.

  • 403

    Аккаунту не разрешено выполнять эту операцию.

  • 429

    Достигнут лимит запросов или расходов.

  • 502

    Сервис не смог выполнить запрос.

  • 503

    API или сервис биллинга временно недоступны.

  • 504

    Истекло время ожидания обработки запроса.

  • default

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    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

Нужна помощь?