API para Desarrolladores
Un feed de precios gratuito y público para skins de CS2 (CS:GO) en SkinCash. Creado para sitios de comparación de precios, agregadores y extensiones de navegador. Sin clave API, sin registro — solo una simple petición GET.
# respuesta de ejemplo — pulsa Ejecutar para consultar la API en 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"
}
], …
}De un vistazo
Inicio rápido
Obtén todo el catálogo en vivo en una sola petición. Envía Accept-Encoding: gzip (el --compressed de curl) — el feed completo pesa unos pocos MB sin comprimir.
curl -s --compressed https://api.skincash.gg/v1/pricesTu elección de lenguaje se mantiene en toda la página.
Autenticación
La API es pública — cada endpoint es un simple GET, sin registro, sin OAuth. CORS está abierto, así que puedes llamarla directamente desde un navegador. Solo envía la petición:
El acceso anónimo tiene límite de tasa por IP (consulta Límites de tasa). Si gestionas un agregador o una extensión y necesitas más, emitimos una clave de socio gratuita que eleva tu límite — sin ningún otro cambio de comportamiento. Envíala como una cabecera Authorization: Bearer (o X-API-Key):
curl -s --compressed \
-H "Authorization: Bearer YOUR_API_KEY" \
https://api.skincash.gg/v1/pricesSolicita una clave en [email protected]. Mantenla del lado del servidor; trátala como una contraseña.
Endpoints
El catálogo completo — cada artículo en venta, precio de compra más bajo + stock en vivo + enlace directo, ordenados de más caro a más barato. Admite gzip y peticiones condicionales. Pruébalo en 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"
}
]
}Un artículo por su nombre exacto de Steam (codificado en URL). Devuelve 404 si no está actualmente en venta.
market_hash_namestring · obligatoriomarket_hash_name exacto de Steam, codificado en 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"
}Metadatos del artículo — imagen, tipo, rareza de cada artículo en venta (sin precios). Te permite renderizar y unir los listados de SkinCash sin hacer scraping. Misma caché 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"
}
]
}Busca artículos por nombre (parcial) → precio de compra + enlace directo canónico. La superficie de comparar y hacer clic para herramientas de comparación de precios y extensiones de navegador. Las coincidencias exactas/por prefijo se clasifican primero.
qstring · obligatorio2–200 caracteres, sin distinción de mayúsculas.limitinteger · opcional1–100, predeterminado 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"
}
]
}Especificación OpenAPI 3.1 legible por máquina para toda la API — la primera parada para generadores de código, clientes de API y LLMs.
curl -s https://api.skincash.gg/v1/openapi.jsonEsquema de respuesta
El updated_at a nivel de feed indica la frescura de cada fila: todos los precios se actualizan juntos en cada ciclo (~5 min). Los precios son el precio de compra que paga un cliente.
Sondeo eficiente (ETag / 304)
Cada respuesta lleva un ETag y un Last-Modified. Devuélvelos en tu siguiente sondeo para obtener un económico 304 Not Modified (sin cuerpo) cuando nada ha cambiado — sondea con la frecuencia que quieras sin volver a descargar el 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 refreshedLímites de tasa
Volcados completos — /prices, /catalog
Lecturas ligeras — /prices/{name}, /search
Los límites son por IP y se dividen según el peso de la carga. El feed está en caché, así que con peticiones condicionales un sondeo de 5 minutos nunca se acerca al límite. Superar un límite devuelve 429 RATE_LIMITED con una cabecera Retry-After. ¿Necesitas límites más altos para una integración de alto tráfico? Escríbenos sobre una clave de socio.
Versionado y estabilidad
La API está versionada en la ruta (/v1). Dentro de una versión solo añadimos campos — un campo existente nunca se renombra, elimina ni cambia de tipo, así que tu parser no se romperá. Los cambios incompatibles se lanzan como una nueva versión, con aviso.
Errores
Los errores siempre comparten una misma forma de cuerpo consistente:
{
"success": false,
"error": {
"error_code": "NOT_FOUND",
"message": "No live price for this item."
}
}¿Gestionas un agregador o una extensión?
Incluye a SkinCash como fuente — el feed de arriba está listo para consumir hoy. Estaremos encantados de adaptarnos a tu especificación de ingesta, añadir campos o establecer un acuerdo de socios. Contáctanos y actuaremos rápido.
[email protected]