v0.2.0-beta

OpenAPI 3.1.0

Obtenir l'activité du portefeuille Polymarket

Felo API Support

MIT

Serveur

https://openapi.felo.ai

Bibliothèques clientes

Shell Curl

Polymarket

Prediction-market discovery and market data.

Polymarket Opérations

get/v1/beta/polymarket/activity

Obtenir l'activité du portefeuille Polymarket

Récupère l'activité d'un marché de prédiction. Filtrez le marché avec des valeurs de condition-ID, utilisez start et end pour la fenêtre temporelle, et limit et offset pour la pagination. D'autres sélecteurs existent : eventId, type, side, sortBy et sortDirection. La réponse réussie est un tableau de premier niveau d'enregistrements d'activité.

Référence tarifaire

Mesure : base de coût fixe par requête réussie.
Estimation de référence par requête : USD 0.012.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Paramètres de requête

end
Type: integer
min.:
0

Horodatage de limite supérieure (secondes epoch) pour la fenêtre d'activité. Omettez-le pour la valeur par défaut (heure actuelle) ; les lignes plus récentes que end sont exclues.
eventId
Type: array integer[]
min.:
1

Liste d'ID d'événement séparés par des virgules. Mutuellement exclusive avec market.
excludeDepositsWithdrawals
Type: boolean

Exclut les enregistrements de dépôt et de retrait. La valeur true par défaut s'applique même lorsque type demande ces enregistrements ; pour obtenir les dépôts et les retraits, vous devez donc passer false.
limit
Type: integer
min.:
0
max.:
500

Taille de page. Les valeurs supérieures au maximum sont plafonnées à 500.
market
Type: array string[]

Liste d'ID de condition séparés par des virgules. Mutuellement exclusive avec eventId.
offset
Type: integer
min.:
0
max.:
5000

Index de départ de la pagination. Les requêtes au-delà du plafond sont rejetées avec un 400 (jamais plafonnées silencieusement). Pour lire l'historique au-delà de l'offset 5000, paginez à l'intérieur de fenêtres start/end — chaque fenêtre dispose de son propre budget d'offset.
side
Type: string enum
valeurs
- BUY
- SELL
sortBy
Type: string enum
valeurs
- TIMESTAMP
- TOKENS
- CASH
sortDirection
Type: string enum

DESC (par défaut) renvoie d'abord les lignes les plus récentes ; ASC, les plus anciennes. Les deux ordres sont stables — la même requête renvoie les mêmes lignes quel que soit limit/offset, de sorte que les pages s'enchaînent sans lacunes ni répétitions.
valeurs
- ASC
- DESC
start
Type: integer
min.:
0

Horodatage de limite inférieure (secondes epoch) pour la fenêtre d'activité. Omettez-le ou passez 0 pour la fenêtre par défaut (environ 3 dernières années) ; passez une epoch positive (par exemple 1) pour récupérer tout l'historique. Avec sortDirection=ASC, omettre start lit déjà depuis le début de l'historique du compte (sans fenêtre par défaut).
type
Type: array string[] enum

Liste des types d'activité à inclure, séparés par des virgules. Les enregistrements DEPOSIT et WITHDRAWAL nécessitent également excludeDepositsWithdrawals=false.
valeurs
- TRADE
- SPLIT
- MERGE
- REDEEM
- REWARD
user
Type: string
obligatoire

Adresse du profil utilisateur (préfixe 0x, 40 caractères hex)

Réponses

200
Type: array object[] · Response65D835437A58_Activity[]

Succès
asset
Type: string

ID du jeton auquel cette ligne se réfère. Renseigné sur les lignes REDEEM avec le jeton réglé par la ligne. Vide lorsque la ligne n'est pas propre à un jeton.

bio
Type: string
conditionId
Type: string · Response65D835437A58_Hash64

Chaîne hexadécimale de 64 caractères préfixée par 0x

eventSlug
Type: string
icon
Type: string

Visuel du marché. Reprend l'image du marché, puis l'icône et l'image de l'événement parent, lorsque le marché n'a pas d'icône propre. Vide sur les lignes CONVERSION.

isCombo
Type: boolean

Vrai lorsque cette ligne fait partie d'une position combinatoire (multi-marchés). Indicateur uniquement : le détail du combo n'est pas intégré ici. Le conditionId de la ligne est égal au combo_condition_id du combo ; transmettez-le à /v1/activity/combos ou /v1/positions/combos via market_id pour récupérer les jambes et le détail. Omis sur les lignes hors combo.

name
Type: string
outcome
Type: string
outcomeIndex
Type: integer

Index basé sur zéro du résultat de cette ligne dans le tableau outcomes du marché, de sorte que outcome est toujours égal à outcomes[outcomeIndex]. Sur les lignes REDEEM, il identifie le résultat réglé par la ligne, et non le résultat gagnant du marché. 999 signifie que le résultat n'a pas pu être déterminé ; dans ce cas, outcome est vide.

price
Type: number
profileImage
Type: string
profileImageOptimized
Type: string
proxyWallet
Type: string · Response65D835437A58_Address

Adresse du profil utilisateur (préfixe 0x, 40 caractères hex)

pseudonym
Type: string
side
Type: string enum
valeurs
BUY
SELL
size
Type: number

Montant en jetons de cette ligne. Sur les lignes REDEEM, il s'agit du nombre de jetons brûlés pour le résultat de cette ligne ; le rachat des deux côtés d'un marché renvoie donc une ligne par résultat au lieu d'une seule ligne combinée.

slug
Type: string
timestamp
Type: integer Format: int64

Signed 64-bit integers (long type).

title
Type: string
transactionHash
Type: string
type
Type: string enum
valeurs
TRADE
SPLIT
MERGE
REDEEM
REWARD
usdcSize
Type: number

Montant en USDC de cette ligne. Sur les lignes REDEEM, il s'agit du paiement du résultat de cette ligne et vaut 0 pour un résultat perdant ; les lignes d'un même rachat totalisent le paiement total.
application/json
400

La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
401

Une clé API Felo valide est requise.
402

La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
403

Le compte n'est pas autorisé à effectuer cette opération.
429

Une limite de requêtes ou de dépenses a été atteinte.
502

Le service n'a pas pu terminer la requête.
503

L'API ou le service de facturation est temporairement indisponible.
504

Le service a expiré lors du traitement de la requête.
default

Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

application/json

get/v1/beta/polymarket/activity

curl 'https://openapi.felo.ai/v1/beta/polymarket/activity?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Afficher le schéma

[
  {
    "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
  }
]

Succès

Obtenir l'activité du portefeuille Polymarket

AuthentificationRequired

Polymarket

Obtenir l'activité du portefeuille Polymarket

Référence tarifaire