Felo API PlatformFelo API Platform
Todos os endpoints de Polymarket
v0.2.0-beta
OpenAPI 3.1.0

Obter atividade da carteira Polymarket

Felo API Support
MIT
Servidor:https://openapi.felo.ai
Bibliotecas Cliente
Shell Curl

Polymarket

​

Prediction-market discovery and market data.

Polymarket Operações

Obter atividade da carteira Polymarket

​

Recupera a atividade de um mercado de previsão. Filtre o mercado com valores de condition-ID, use start e end para a janela de tempo e limit e offset para paginação. Seletores adicionais incluem eventId, type, side, sortBy e sortDirection. A resposta bem-sucedida é um array de nível superior de registros de atividade.

Referência de preços

  • Medição: base de custo fixa por requisição bem-sucedida.
  • Estimativa de referência por requisição: USD 0.012.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Parâmetros de Consulta
  • end
    Tipo: integer
    mín:  
    0

    Timestamp de limite superior (segundos epoch) para a janela de atividade. Omita para o padrão (hora atual); linhas mais recentes que end são excluídas.

  • eventId
    Tipo: array integer[]
    mín:  
    1

    Lista separada por vírgulas de IDs de evento. Mutuamente exclusiva com market.

  • excludeDepositsWithdrawals
    Tipo: boolean

    Exclui registros de depósito e saque. O true padrão se aplica mesmo quando type solicita esses registros, portanto, para obter depósitos e saques, você deve passar false.

  • limit
    Tipo: integer
    mín:  
    0
    máx:  
    500

    Tamanho da página. Valores acima do máximo são limitados a 500.

  • market
    Tipo: array string[]

    Lista separada por vírgulas de IDs de condição. Mutuamente exclusiva com eventId.

  • offset
    Tipo: integer
    mín:  
    0
    máx:  
    5000

    Índice inicial da paginação. Requisições acima do limite são rejeitadas com 400 (nunca truncadas silenciosamente). Para ler o histórico além do offset 5000, pagine dentro de janelas start/end — cada janela tem seu próprio orçamento de offset.

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

    DESC (padrão) retorna primeiro as linhas mais recentes; ASC, as mais antigas. Ambas as ordens são estáveis — a mesma consulta retorna as mesmas linhas em qualquer limit/offset, portanto as páginas se compõem sem lacunas nem repetições.

    valores
    • ASC
    • DESC
  • start
    Tipo: integer
    mín:  
    0

    Timestamp de limite inferior (segundos epoch) para a janela de atividade. Omita ou passe 0 para a janela padrão (últimos ~3 anos); passe um epoch positivo (por exemplo, 1) para recuperar o histórico completo. Com sortDirection=ASC, omitir start já lê desde o início do histórico da conta (sem janela padrão).

  • type
    Tipo: array string[] enum

    Lista separada por vírgulas de tipos de atividade a incluir. Registros DEPOSIT e WITHDRAWAL também exigem excludeDepositsWithdrawals=false.

    valores
    • TRADE
    • SPLIT
    • MERGE
    • REDEEM
    • REWARD
  • user
    Tipo: string
    obrigatório

    Endereço do perfil do usuário (prefixo 0x, 40 caracteres hex)

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

    Sucesso

    • asset
      Tipo: string

      ID do token ao qual esta linha se refere. Preenchido nas linhas REDEEM com o token que a linha liquida. Vazio quando a linha não é específica de um token.

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

      String hexadecimal de 64 caracteres com prefixo 0x

    • eventSlug
      Tipo: string
    • icon
      Tipo: string

      Arte do mercado. Usa como fallback a imagem do mercado e, em seguida, o ícone e a imagem do evento pai, quando o mercado não tem ícone próprio. Vazio nas linhas CONVERSION.

    • isCombo
      Tipo: boolean

      Verdadeiro quando esta linha faz parte de uma posição combinatória (multimercado). Apenas um indicador — os detalhes do combo não são incorporados aqui. O conditionId da linha é igual ao combo_condition_id do combo; passe-o para /v1/activity/combos ou /v1/positions/combos via market_id para buscar as pernas e os detalhes. Omitido em linhas que não são de combo.

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

      Índice baseado em zero do resultado desta linha no array outcomes do mercado, de modo que outcome é sempre igual a outcomes[outcomeIndex]. Nas linhas REDEEM, identifica o resultado que a linha liquida, não o resultado vencedor do mercado. 999 significa que o resultado não pôde ser determinado; nesse caso, outcome fica vazio.

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

      Endereço do perfil do usuário (prefixo 0x, 40 caracteres hex)

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

      Quantidade de tokens desta linha. Nas linhas REDEEM, é o número de tokens queimados para o resultado desta linha, portanto resgatar os dois lados de um mercado retorna uma linha por resultado em vez de uma única linha combinada.

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

      Signed 64-bit integers (long type).

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

      Valor em USDC desta linha. Nas linhas REDEEM, é o pagamento do resultado desta linha e é 0 para um resultado perdedor; as linhas de um resgate somam o pagamento total.

    application/json
  • 400

    Não foi possível processar a requisição. Verifique os parâmetros da requisição.

  • 401

    É necessária uma chave de API da Felo válida.

  • 402

    A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.

  • 403

    A conta não tem permissão para realizar esta operação.

  • 429

    Um limite de requisições ou de gastos foi atingido.

  • 502

    O serviço não pôde concluir a requisição.

  • 503

    A API ou o serviço de cobrança está temporariamente indisponível.

  • 504

    O serviço atingiu o tempo limite ao processar a requisição.

  • default

    Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

    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
  }
]

Sucesso

Get Polymarket Wallet Activity