WOK API
History API - Como conectar | WOK
Histórico de preços observados e gráficos da carteira
Acesso necessário
History / 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-history?game=cs2&name=AK-47+%7C+Redline+%28Field-Tested%29&days=30" \
-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-history?game=cs2&name=AK-47+%7C+Redline+%28Field-Tested%29&days=30", {
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-history?game=cs2&name=AK-47+%7C+Redline+%28Field-Tested%29&days=30'
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
Exiba observações com data, fonte e moeda. POST /v1/portfolio-history aceita uma cesta; consulte o esquema para os campos exatos.
O histórico começa quando WOK observa o preço; não é todo o fluxo de transações Steam. Mantenha lacunas em datas ausentes, sem inventar zeros. days: 1..365.
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.
## History
Histórico de preços observados e gráficos da carteira
Acesso necessário: History / Prices / Inventory / Uso geral
GET /v1/price-history
Exiba observações com data, fonte e moeda. POST /v1/portfolio-history aceita uma cesta; consulte o esquema para os campos exatos.
O histórico começa quando WOK observa o preço; não é todo o fluxo de transações Steam. Mantenha lacunas em datas ausentes, sem inventar zeros. days: 1..365.
Endpoints de dados incluídos:
- /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"
```
Substitua o SteamID ou link de exemplo pelos seus dados.