Loading markets
Una API REST de solo lectura sobre todos los mercados, eventos y precios públicos de Problyx. No hace falta cuenta para empezar; una API key sube tu límite de peticiones.
Todos los endpoints responden de forma anónima sobre HTTPS y devuelven JSON. No hay nada que instalar ni ningún flujo OAuth.
curl "https://problyxweb-production.up.railway.app/public/v1/markets?status=active&limit=5"Las llamadas anónimas funcionan sin más. Enviar una API key te mueve a un cubo de límite propio, más alto, en lugar de compartir el de tu IP.
| Modo | Cómo | Límite |
|---|---|---|
| Anónimo | No envíes nada | 10 peticiones/min por IP |
| Con API key | Cabecera X-API-Key: pbx_… | 30 peticiones/min por key |
El tier gratuito es de evaluación: suficiente para probar la API y montar una integración personal, no para tráfico de producción. Para límites más altos, uso comercial o cualquier cosa con volumen real, escribe a info@problyx.com y cuéntanos qué estás construyendo.
curl -H "X-API-Key: pbx_your_key" \
"https://problyxweb-production.up.railway.app/public/v1/events?limit=20"Las keys se crean en Perfil → Ajustes → API keys (requiere email verificado, máximo 5 activas). La key se muestra una sola vez: guárdala en tu servidor. Una key inválida devuelve 401, nunca cae a modo anónimo.
Crear una API key| Endpoint | Qué devuelve |
|---|---|
| GET /public/v1/markets | Lista de mercados. Filtra con q, status, category y sort; pagina con limit (≤100) y offset (≤10000). |
| GET /public/v1/markets/{id} | Un mercado concreto. |
| GET /public/v1/markets/{id}/quote | Vista previa de una operación: pasa outcome, amount y action. |
| GET /public/v1/events | Lista de eventos, con sus mercados anidados. |
| GET /public/v1/events/{id} | Un evento concreto. |
Todas las respuestas usan el mismo sobre, así que tu cliente solo tiene que ramificar en success.
{ "success": true, "data": { … } }
{ "success": false, "error": { "code": "…", "message": "…" } }401API key inválida.404No encontrado. Los recursos privados o pendientes de revisión también responden 404, nunca 403.409Mercado cerrado a operaciones.410Mercado ya resuelto.423Mercado liquidándose (bloqueo de resolución).429Límite de peticiones superado: espera y reintenta.Límites más altos, uso comercial, webhooks o acceso de escritura: subimos los topes por integración. Cuéntanos tu caso de uso y el volumen que esperas.
Escribir a info@problyx.com