Obtener actividad de la cartera de Polymarket
Polymarket
Prediction-market discovery and market data.
Obtener actividad de la cartera de Polymarket
Recupera la actividad de un mercado de predicción. Filtra el mercado con valores de condition-ID, usa start y end para la ventana temporal, y limit y offset para la paginación. Hay selectores adicionales: eventId, type, side, sortBy y sortDirection. La respuesta correcta es un array de nivel superior de registros de actividad.
Referencia de precios
- Medición: base de costo fija por solicitud exitosa.
- Estimación de referencia por solicitud: USD 0.012.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: integerendmín.:0
Marca temporal de límite superior (segundos epoch) para la ventana de actividad. Omítela para usar el valor predeterminado (hora actual); se excluyen las filas más recientes que
end. - Tipo: array integer[]event
Id mín.:1Lista separada por comas de IDs de evento. Mutuamente excluyente con market.
- Tipo: booleanexclude
Deposits Withdrawals Excluye los registros de depósito y retirada. El
truepredeterminado se aplica incluso cuandotypesolicita esos registros, así que para obtener depósitos y retiradas debes pasarfalse. - Tipo: integerlimitmín.:0máx.:500
Tamaño de página. Los valores por encima del máximo se limitan a 500.
- Tipo: array string[]market
Lista separada por comas de IDs de condición. Mutuamente excluyente con eventId.
- Tipo: integeroffsetmín.:0máx.:5000
Índice inicial de paginación. Las solicitudes que superan el límite se rechazan con un 400 (nunca se truncan silenciosamente). Para leer el historial más allá del offset 5000, pagina dentro de ventanas
start/end: cada ventana tiene su propio presupuesto de offset. - Tipo: string enumsidevalores
- B
U Y - S
E L L
- Tipo: string enumsort
By valores- T
I M E S T A M P - T
O K E N S - C
A S H
- Tipo: string enumsort
Direction DESC(predeterminado) devuelve primero las filas más recientes;ASC, las más antiguas. Las dos ordenaciones son estables: la misma consulta devuelve las mismas filas con cualquierlimit/offset, por lo que las páginas se componen sin huecos ni repeticiones.valores- A
S C - D
E S C
- Tipo: integerstartmín.:0
Marca temporal de límite inferior (segundos epoch) para la ventana de actividad. Omítela o pasa
0para la ventana predeterminada (últimos ~3 años); pasa un epoch positivo (por ejemplo,1) para recuperar el historial completo. ConsortDirection=ASC, omitirstartya lee desde el principio del historial de la cuenta (sin ventana predeterminada). - Tipo: array string[] enumtype
Lista separada por comas de tipos de actividad que se incluirán. Los registros DEPOSIT y WITHDRAWAL también requieren
excludeDepositsWithdrawals=false.valores- T
R A D E - S
P L I T - M
E R G E - R
E D E E M - R
E W A R D
- Tipo: stringuserobligatorio
Dirección del perfil del usuario (prefijo 0x, 40 caracteres hex)
- Tipo: array object[] · Response65D835437A58_Activity[]200
Correcto
- assetTipo: string
ID del token al que hace referencia esta fila. Se rellena en las filas
REDEEMcon el token que liquida la fila. Vacío cuando la fila no es específica de un token. - bioTipo: string
- conditionTipo: string · Response65D835437A58_Hash64
Id Cadena hexadecimal de 64 caracteres con prefijo 0x
- eventTipo: string
Slug - iconTipo: string
Ilustración del mercado. Si el mercado no tiene un icono propio, se recurre a la imagen del mercado y luego al icono e imagen del evento principal. Vacío en las filas
CONVERSION. - isTipo: boolean
Combo Verdadero cuando esta fila forma parte de una posición combinada (de varios mercados). Solo es un indicador: los detalles del combo no se incluyen aquí. El conditionId de la fila es igual al combo_condition_id del combo; pásalo a /v1/activity/combos o /v1/positions/combos mediante market_id para obtener las patas y los detalles. Se omite en las filas que no son de combo.
- nameTipo: string
- outcomeTipo: string
- outcomeTipo: integer
Index Índice basado en cero del resultado de esta fila en el array
outcomesdel mercado, de modo queoutcomesiempre es igual aoutcomes[outcomeIndex]. En las filasREDEEM, identifica el resultado que liquida la fila, no el resultado ganador del mercado.999significa que no se pudo determinar el resultado; en ese caso,outcomeestá vacío. - priceTipo: number
- profileTipo: string
Image - profileTipo: string
Image Optimized - proxyTipo: string · Response65D835437A58_Address
Wallet Dirección del perfil del usuario (prefijo 0x, 40 caracteres hex)
- pseudonymTipo: string
- sideTipo: string enumvalores
- B
U Y - S
E L L
- sizeTipo: number
Cantidad de tokens de esta fila. En las filas
REDEEM, es el número de tokens quemados para el resultado de esta fila, por lo que canjear ambos lados de un mercado devuelve una fila por resultado en lugar de una sola fila combinada. - slugTipo: string
- timestampTipo: integer Formato: int64
Signed 64-bit integers (long type).
- titleTipo: string
- transactionTipo: string
Hash - typeTipo: string enumvalores
- T
R A D E - S
P L I T - M
E R G E - R
E D E E M - R
E W A R D
- usdcTipo: number
Size Importe en USDC de esta fila. En las filas
REDEEM, es el pago del resultado de esta fila y es0para un resultado perdedor; las filas de un mismo canje suman el pago total.
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
application/json
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
}
]