# 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.

## Prices

Catálogo, precios por fuente, estadísticas e historial

Acceso necesario: Prices / Inventory / Uso general

GET /v1/price

Guarda source, currency, freshness y price_stat junto al precio. Conserva null si la fuente no tiene observación.

min/max/avg/median dependen de las observaciones. Una cotización no garantiza que el anuncio siga disponible. No interpretes RUB como USD ni sustituyas una estadística ausente por otra fuente sin indicarlo.

Endpoints de datos incluidos:

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

https://woksteamapi.com/steam-price-api

```sh
curl --fail-with-body --max-time 60 "https://woksteamapi.com/v1/price?game=rust&name=Big+Grin&price_source=tm&price_stat=min&strict=true" \
  -H "Authorization: Bearer $WOK_API_KEY"
```

Sustituye el SteamID o enlace de ejemplo por tus datos.