# Conecta con WOK API

WOK_API_KEY es tu clave WOK, no de Steam. No la pongas en código del navegador, URL, registros ni instrucciones para agentes.

https://woksteamapi.com

Authorization: Bearer $WOK_API_KEY

- https://woksteamapi.com/api/openapi.json
- https://woksteamapi.com/mcp.json
- https://woksteamapi.com/api/integration-guide.md
- https://woksteamapi.com/api/specialist-plans.md

1. Revisa el stack y crea un adaptador del servidor siguiendo las convenciones del proyecto.

2. Llama una vez a GET /v1/key para revisar access.endpoints, capabilities y cuotas, sin coste. Los planes específicos excluyen otras tareas.

3. Usa parámetros documentados y valida HTTP y estado de aplicación. Distingue unavailable, private y empty. Los datos ausentes siguen null o unavailable; nunca inventes ceros.

4. Fija un plazo total de 60 segundos y limita concurrencia. Reintenta 429/502/503/504 temporales como máximo dos veces con variación aleatoria, respetando Retry-After y el plazo. Si se agota la cuota, espera el reinicio. No repitas en bucle 400/401/403 ni funciones no admitidas.

5. Cachea según la fecha de la fuente y une lecturas idénticas en curso. No consultes por fotograma ni fuerces actualizaciones automáticas.

6. Conserva moneda, fuente, estadística y fecha juntas. No compares monedas o instantáneas distintas como un mismo precio.

7. Usa SteamID64 como cadenas, no números JavaScript. Codifica nombres en URL conservando espacios, ★, barras y caracteres no latinos. Sigue la paginación por cursor. Los lotes pueden cobrar por objeto o jugador.

8. Crea ejemplos y pruebas con mocks primero. Pide permiso antes de solicitudes reales pagadas o masivas. Esta instrucción no autoriza compras, cambios de plan, cobros ni correos.

9. Informa de archivos, comandos, pruebas y funciones no admitidas. No afirmes equivalencia de datos o render sin respaldo en las respuestas.

## History

Historial de precios observados y gráficos de cartera

Acceso necesario: History / Prices / Inventory / Uso general

GET /v1/price-history

Muestra observaciones con fecha, fuente y moneda. POST /v1/portfolio-history acepta una cesta; consulta el esquema para los campos exactos.

El historial comienza cuando WOK observa el precio; no es todo el historial de transacciones Steam. Conserva huecos en fechas ausentes, sin inventar precios cero. days: 1..365.

Endpoints de datos incluidos:

- /v1/portfolio-history
- /v1/price-history
- /v1/prices/coverage

https://woksteamapi.com/steam-item-price-history

```sh
curl --fail-with-body --max-time 60 "https://woksteamapi.com/v1/price-history?game=cs2&name=AK-47+%7C+Redline+%28Field-Tested%29&days=30" \
  -H "Authorization: Bearer $WOK_API_KEY"
```

Sustituye el SteamID o enlace de ejemplo por tus datos.