WOK API
Prices API - Como conectar | WOK
Catálogo, preços por fonte, estatísticas e histórico
Acesso necessário
Prices / Inventory / Uso geral
Escolher plano- 1. Crie uma chave
Entre na conta e escolha o plano adequado.
- 2. Configure o ambiente do servidor
WOK_API_KEY é a chave WOK, não Steam. Não a coloque no navegador, URLs, logs ou instruções para agentes.
- 3. Verifique o acesso e faça uma solicitação
GET /v1/key retorna endpoints e limites sem gastar unidades.
Primeira solicitação
Substitua o SteamID ou link de exemplo pelos seus dados.
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.Tratar a resposta
Mantenha source, currency, freshness e price_stat junto ao valor. Preserve null se a fonte não tiver observação.
min/max/avg/median dependem das observações. Uma cotação não garante disponibilidade do anúncio. Não interprete RUB como USD nem substitua estatística ausente por outra fonte sem avisar.
Parâmetros e formato da resposta →Guia para agentes
Copie a tarefa na sua ferramenta. Defina a chave separadamente no servidor; as instruções não contêm chaves.
Ler instruções
# Conecte ao WOK API
WOK_API_KEY é a chave WOK, não Steam. Não a coloque no navegador, URLs, logs ou instruções 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. Revise a stack e crie um adaptador no servidor conforme as convenções do projeto.
2. Chame GET /v1/key uma vez para conferir access.endpoints, capabilities e cotas, sem custo. Planos específicos excluem outras tarefas.
3. Use parâmetros documentados e valide HTTP e status da aplicação. Distinga unavailable, private e empty. Dados ausentes ficam null ou unavailable; nunca invente zeros.
4. Defina prazo total de 60 segundos e limite concorrência. Repita 429/502/503/504 temporários no máximo duas vezes com variação aleatória, respeitando Retry-After e o prazo. Se a cota acabar, aguarde o reset. Não repita 400/401/403 nem recursos sem suporte em loop.
5. Use cache pela data da fonte e una leituras idênticas em andamento. Não consulte por quadro nem force atualização automática.
6. Mantenha moeda, fonte, estatística e horário juntos. Não compare moedas ou snapshots diferentes como o mesmo preço.
7. Use SteamID64 como strings, não números JavaScript. Codifique nomes na URL preservando espaços, ★, barras e caracteres não latinos. Siga a paginação por cursor. Lotes podem cobrar por item ou jogador.
8. Crie exemplos e verificações com mocks primeiro. Peça antes de pedidos reais pagos ou em massa. A instrução não autoriza compras, alterações de plano, cobranças ou e-mails.
9. Informe arquivos, comandos, verificações e recursos sem suporte. Não afirme equivalência de dados ou render sem evidências nas respostas.
## Prices
Catálogo, preços por fonte, estatísticas e histórico
Acesso necessário: Prices / Inventory / Uso geral
GET /v1/price
Mantenha source, currency, freshness e price_stat junto ao valor. Preserve null se a fonte não tiver observação.
min/max/avg/median dependem das observações. Uma cotação não garante disponibilidade do anúncio. Não interprete RUB como USD nem substitua estatística ausente por outra fonte sem avisar.
Endpoints de dados incluídos:
- /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"
```
Substitua o SteamID ou link de exemplo pelos seus dados.