API para Desenvolvedores
Um feed de preços público e gratuito para skins de CS2 (CS:GO) na SkinCash. Feito para sites de comparação de preços, agregadores e extensões de navegador. Sem chave de API, sem cadastro — apenas uma simples requisição GET.
# resposta de exemplo — pressione Executar para acessar a API ao vivo
{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"count": 25812,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}
], …
}Num relance
Início rápido
Obtenha todo o catálogo ao vivo em uma única requisição. Envie Accept-Encoding: gzip (o --compressed do curl) — o feed completo tem alguns MB sem compressão.
curl -s --compressed https://api.skincash.gg/v1/pricesSua escolha de linguagem permanece em toda a página.
Autenticação
A API é pública — todo endpoint é um simples GET, sem cadastro, sem OAuth. O CORS é aberto, então você pode chamá-la diretamente de um navegador. Basta enviar a requisição:
O acesso anônimo é limitado por taxa por IP (veja Limites de taxa). Se você opera um agregador ou extensão e precisa de mais, emitimos uma chave de parceiro gratuita que aumenta seu limite — nenhum outro comportamento muda. Envie-a como um cabeçalho Authorization: Bearer (ou X-API-Key):
curl -s --compressed \
-H "Authorization: Bearer YOUR_API_KEY" \
https://api.skincash.gg/v1/pricesSolicite uma chave em [email protected]. Mantenha-a no servidor; trate-a como uma senha.
Endpoints
O catálogo completo — todos os itens à venda, menor preço de compra + estoque ao vivo + link direto, ordenados do mais caro primeiro. Suporta gzip e requisições condicionais. Experimente ao vivo ↑
curl -s --compressed https://api.skincash.gg/v1/prices{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"count": 25812,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}
]
}Um item pelo seu nome exato na Steam (codificado em URL). Retorna 404 se não estiver à venda no momento.
market_hash_namestring · obrigatóriomarket_hash_name exato da Steam, codificado em URL.curl -s --compressed \
"https://api.skincash.gg/v1/prices/AK-47%20%7C%20Redline%20(Field-Tested)"{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}Metadados dos itens — imagem, tipo, raridade para todos os itens à venda (sem preços). Permite renderizar e combinar listagens da SkinCash sem scraping. Mesmo cache de 5 min + GET condicional que /prices.
curl -s --compressed https://api.skincash.gg/v1/catalog{
"updated_at": "2026-08-05T12:00:00.000Z",
"count": 25812,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"image": "https://cdn.skincash.gg/sc/economy/image/class/730/…",
"type": "Rifle",
"rarity": "Classified"
}
]
}Busque itens por nome (parcial) → preço de compra + link direto canônico. A superfície de comparar e clicar para ferramentas de comparação de preços e extensões de navegador. Correspondências exatas/por prefixo aparecem primeiro.
qstring · obrigatório2–200 caracteres, sem distinção entre maiúsculas e minúsculas.limitinteger · opcional1–100, padrão 50.curl -s "https://api.skincash.gg/v1/search?q=redline&limit=5"{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"query": "redline",
"count": 1,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}
]
}Especificação OpenAPI 3.1 legível por máquina para toda a API — o primeiro ponto de parada para geradores de código, clientes de API e LLMs.
curl -s https://api.skincash.gg/v1/openapi.jsonEsquema de resposta
O updated_at no nível do feed é a atualização de cada linha: todos os preços são atualizados juntos a cada ciclo (~5 min). Os preços são o preço de compra que um cliente paga.
Polling eficiente (ETag / 304)
Toda resposta traz um ETag e Last-Modified. Envie-os de volta no seu próximo polling para obter um econômico 304 Not Modified (sem corpo) quando nada mudou — faça polling com a frequência que quiser sem rebaixar o catálogo.
# Save the ETag from the first response, then:
curl -s -o /dev/null -w "%{http_code}\n" \
-H 'If-None-Match: "your-saved-etag"' \
https://api.skincash.gg/v1/prices
# -> 304 when unchanged, 200 (with body) when refreshedLimites de taxa
Despejos completos — /prices, /catalog
Leituras leves — /prices/{name}, /search
Os limites são por IP e divididos pelo peso da carga. O feed é armazenado em cache, então com requisições condicionais um polling de 5 minutos nunca chega perto. Exceder um limite retorna 429 RATE_LIMITED com um cabeçalho Retry-After. Precisa de limites maiores para uma integração de alto tráfego? Fale conosco sobre uma chave de parceiro.
Versionamento e estabilidade
A API é versionada no caminho (/v1). Dentro de uma versão, apenas adicionamos campos — um campo existente nunca é renomeado, removido ou tem seu tipo alterado, então seu parser não vai quebrar. Mudanças incompatíveis são lançadas como uma nova versão, com aviso prévio.
Erros
Os erros sempre compartilham um formato de corpo consistente:
{
"success": false,
"error": {
"error_code": "NOT_FOUND",
"message": "No live price for this item."
}
}Opera um agregador ou extensão?
Liste a SkinCash como fonte — o feed acima está pronto para consumo hoje. Teremos prazer em atender à sua especificação de ingestão, adicionar campos ou definir um acordo de parceria. Entre em contato e agiremos rapidamente.
[email protected]