Saltar al contenido
API

WOK API

Prices API - Cómo conectar | WOK

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

Acceso necesario

Prices / Inventory / Uso general

Elegir plan
  1. 1. Crea una clave

    Inicia sesión y elige un plan adecuado.

  2. 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. 3. Comprueba el acceso y haz una solicitud

    GET /v1/key muestra endpoints y límites sin consumir unidades.

Cuenta →

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.

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

← Otras tareas