Felo API PlatformFelo API Platform
Tutti gli endpoint di Polymarket
v0.2.0-beta
OpenAPI 3.1.0

Recupera l'attività del wallet Polymarket

Server:https://openapi.felo.ai
Librerie client

Polymarket

​

Prediction-market discovery and market data.

Recupera l'attività del wallet Polymarket

​

Recupera l'attività dei mercati predittivi. Filtra il mercato con valori di condition ID, usa start e end per la finestra temporale e limit e offset per la paginazione. Altri selettori includono eventId, type, side, sortBy e sortDirection. La risposta riuscita è un array di record di attività di primo livello.

Riferimento prezzi

  • Misurazione: base di costo fissa per richiesta riuscita.
  • Stima di riferimento per richiesta: USD 0.012.

Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Parametri di query
  • end
    Tipo: integer
    min:  
    0

    Timestamp limite superiore (secondi epoch) per la finestra di attività. Ometti per il valore predefinito (ora corrente); le righe più recenti di end vengono escluse.

  • eventId
    Tipo: array integer[]
    min:  
    1

    Elenco separato da virgole di ID evento. Mutuamente esclusivo con market.

  • excludeDepositsWithdrawals
    Tipo: boolean

    Esclude i record di deposito e prelievo. Il valore predefinito true si applica anche quando type richiede quei record, quindi per ottenere depositi e prelievi devi passare false.

  • limit
    Tipo: integer
    min:  
    0
    max:  
    500

    Dimensione della pagina. I valori superiori al massimo vengono limitati a 500.

  • market
    Tipo: array string[]

    Elenco separato da virgole di ID condizione. Mutuamente esclusivo con eventId.

  • offset
    Tipo: integer
    min:  
    0
    max:  
    5000

    Indice iniziale per la paginazione. Le richieste oltre il limite vengono rifiutate con un 400 (mai limitate silenziosamente). Per leggere la cronologia oltre l'offset 5000, pagina all'interno di finestre start/end: ogni finestra ha il proprio budget di offset.

  • side
    Tipo: string enum
    valori
    • BUY
    • SELL
  • sortBy
    Tipo: string enum
    valori
    • TIMESTAMP
    • TOKENS
    • CASH
  • sortDirection
    Tipo: string enum

    DESC (predefinito) restituisce prima le righe più recenti; ASC prima le più vecchie. Entrambi gli ordinamenti sono stabili: la stessa query restituisce le stesse righe con qualsiasi limit/offset, così le pagine si compongono senza lacune né ripetizioni.

    valori
    • ASC
    • DESC
  • start
    Tipo: integer
    min:  
    0

    Timestamp limite inferiore (secondi epoch) per la finestra di attività. Ometti o passa 0 per la finestra predefinita (gli ultimi ~3 anni); passa un'epoca positiva (ad es. 1) per recuperare la cronologia completa. Con sortDirection=ASC, omettere start legge già dall'inizio della cronologia dell'account (nessuna finestra predefinita).

  • type
    Tipo: array string[] enum

    Elenco separato da virgole dei tipi di attività da includere. Anche i record DEPOSIT e WITHDRAWAL richiedono excludeDepositsWithdrawals=false.

    valori
    • TRADE
    • SPLIT
    • MERGE
    • REDEEM
    • REWARD
  • user
    Tipo: string
    obbligatorio

    Indirizzo del profilo utente (prefisso 0x, 40 caratteri esadecimali)

Risposte
  • 200
    Tipo: array object[] · Response65D835437A58_Activity[]

    Riuscito

    • asset
      Tipo: string

      ID del token a cui si riferisce questa riga. Compilato nelle righe REDEEM con il token che la riga regola. Vuoto quando la riga non è specifica di un token.

    • bio
      Tipo: string
    • conditionId
      Tipo: string · Response65D835437A58_Hash64

      Stringa esadecimale di 64 caratteri con prefisso 0x

    • eventSlug
      Tipo: string
    • icon
      Tipo: string

      Artwork del mercato. Ricade sull'immagine del mercato, poi sull'icona e sull'immagine dell'evento padre, quando il mercato non ha un'icona propria. Vuoto nelle righe CONVERSION.

    • isCombo
      Tipo: boolean

      True quando questa riga fa parte di una posizione combinatoria (multi-mercato). Solo flag: i dettagli della combinazione non sono incorporati qui. Il conditionId della riga è uguale al combo_condition_id della combinazione; passarlo a /v1/activity/combos o /v1/positions/combos tramite market_id per recuperare legs e dettagli. Omesso nelle righe non combinatorie.

    • name
      Tipo: string
    • outcome
      Tipo: string
    • outcomeIndex
      Tipo: integer

      Indice con base zero dell'esito di questa riga nell'array outcomes del mercato, così che outcome sia sempre uguale a outcomes[outcomeIndex]. Nelle righe REDEEM identifica l'esito che la riga regola, non l'esito vincente del mercato. 999 significa che l'esito non è stato determinato; in tal caso outcome è vuoto.

    • price
      Tipo: number
    • profileImage
      Tipo: string
    • profileImageOptimized
      Tipo: string
    • proxyWallet
      Tipo: string · Response65D835437A58_Address

      Indirizzo del profilo utente (prefisso 0x, 40 caratteri esadecimali)

    • pseudonym
      Tipo: string
    • side
      Tipo: string enum
      valori
      • BUY
      • SELL
    • size
      Tipo: number

      Importo del token per questa riga. Nelle righe REDEEM è il numero di token bruciati per l'esito di questa riga, quindi riscattare entrambi i lati di un mercato restituisce una riga per esito invece di un'unica riga combinata.

    • slug
      Tipo: string
    • timestamp
      Tipo: integer Formato: int64

      Signed 64-bit integers (long type).

    • title
      Tipo: string
    • transactionHash
      Tipo: string
    • type
      Tipo: string enum
      valori
      • TRADE
      • SPLIT
      • MERGE
      • REDEEM
      • REWARD
    • usdcSize
      Tipo: number

      Importo USDC per questa riga. Nelle righe REDEEM è il pagamento per l'esito di questa riga ed è 0 per un esito perdente; le righe di un riscatto sommano al pagamento totale.

    application/json
  • 400

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    Risposta di errore; le risposte passthrough upstream possono usare formati del provider

    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