WOK API
Prices API - Cómo conectar | WOK
Catálogo, precios por fuente, estadísticas e historial
Prices / Inventory / Uso general
Elegir plan- 1. Crea una clave
Inicia sesión y elige un plan adecuado.
- 2. Configura el entorno del servidor
WOK_API_KEY es tu clave WOK, no de Steam. No la pongas en código del navegador, URL, registros ni instrucciones para agentes.
- 3. Comprueba el acceso y haz una solicitud
GET /v1/key muestra endpoints y límites sin consumir unidades.
Primera solicitud
Sustituye el SteamID o enlace de ejemplo por tus datos.
cURL
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"Node.js
const key = process.env.WOK_API_KEY;
if (!key) throw new Error('Set WOK_API_KEY on the server');
const response = await fetch("https://woksteamapi.com/v1/price?game=rust&name=Big+Grin&price_source=tm&price_stat=min&strict=true", {
method: 'GET',
headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
signal: AbortSignal.timeout(60000),
});
if (!response.ok) throw new Error(`WOK HTTP ${response.status}; inspect Retry-After for 429`);
const result = await response.json();
// Validate the documented status and fields before using result.Python
import json, os, urllib.request, urllib.error
url = 'https://woksteamapi.com/v1/price?game=rust&name=Big+Grin&price_source=tm&price_stat=min&strict=true'
headers = {'Authorization': 'Bearer ' + os.environ['WOK_API_KEY'], 'Content-Type': 'application/json'}
data = None
request = urllib.request.Request(url, data=data, headers=headers, method='GET')
with urllib.request.urlopen(request, timeout=60) as response:
result = json.load(response)
# Handle HTTPError and validate the documented response status in your application.Procesar la respuesta
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.
Parámetros y formato de respuesta →Guía para agentes
Copia la tarea en tu herramienta. Configura la clave aparte en el servidor; la instrucción no contiene claves.
Leer instrucciones
# 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.