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