API pública para desarrolladores
Una API JSON gratuita de solo lectura con precios de CS2, Dota 2, Rust y TF2, analítica de CS2 y el índice del mercado, estimaciones de inventarios de Steam con totales por juego disponibles, y equipos y jugadores de CS2. La mayoría de los métodos requieren una clave API personal gratuita, que además sube los límites; el índice del mercado y las consultas de float funcionan sin ella. Los parámetros y datos admitidos se listan abajo.
Tus skins. Tus precios bajo control.
Guarda objetos de CS2, sigue los cambios de precio y compara mercados directamente en Steam.
Acceso a la API y límites personales
Sin clave
El índice del mercado y las consultas de float funcionan sin iniciar sesión: 5 solicitudes por minuto y dirección IP. Los precios, las ofertas, el estado de los datos, el pool de drops, los equipos, los jugadores y los inventarios requieren una clave.
EndpointsCon clave
Una clave personal gratuita para tus scripts e integraciones. Da acceso a precios, ofertas, estado de los datos, pool de drops, equipos, jugadores e inventarios, y aumenta los límites, que se cuentan por separado para cada clave.
Cómo conseguir una clave| Límite | Sin clave | Con clave |
|---|---|---|
| Solicitudes por minuto | 5 | 120 |
| Solicitudes de inventario por hora: individuales y por lotes | Requiere clave | 480 |
| Primeras consultas de inventario por minuto | Requiere clave | 48 |
| Perfiles por llamada a /api/ | Requiere clave | 100 |
| Consultas al coordinador de juego por minuto en /api/ | 10 | 15 |
La cuota horaria de inventarios cubre ambos métodos; un lote cuenta como una solicitud. Un inventario individual devuelto con stale: true no consume esta cuota. Las primeras consultas son de perfiles sin valoración guardada.
Todas las claves usadas desde una misma dirección IP comparten un límite común, sean de las cuentas que sean: 240 solicitudes por minuto, 960 solicitudes de inventario por hora, 96 primeras consultas y 30 consultas al coordinador de juego por minuto.
Cómo conseguir una clave
- Inicia sesión con Steam y abre la sección «Claves de API» de tu perfil. Ir al perfil
- Crea claves 5 minutos después de registrarte en Skinory. Cada cuenta puede tener hasta 3 claves activas con su propia etiqueta.
- La clave se muestra una sola vez, al crearla: guardamos solo su hash. Una clave perdida o filtrada se revoca con un clic y se sustituye por otra.
Cómo enviar la clave
Envía la clave en la cabecera Authorization con el esquema Bearer o en la cabecera X-Api-Key. Las claves solo se leen en /api/v1; no las pongas en código del navegador ni en repositorios públicos.
Cabeceras de respuesta y errores
- X-RateLimit-Limit
- cuota de solicitudes por minuto
- X-RateLimit-Remaining
- solicitudes que quedan en la ventana actual
- X-RateLimit-Reset
- segundos hasta que se reinicia la ventana
Una clave mal escrita, desconocida o revocada nunca se ignora: la solicitud recibe 401 con WWW-Authenticate en vez de pasar a los límites anónimos. La clave de una cuenta bloqueada recibe 403. Por encima del límite la respuesta es 429 con Retry-After.
Ejemplos de solicitudes
Precios con clave
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline" Un inventario con clave
Envía un SteamID64, URL de perfil o nombre personalizado a /api/v1/inventory. El inventario debe ser público. La solicitud puede esperar hasta 25 s, devolver una valoración guardada (stale: true) o responder 503 con Retry-After. checkedAt indica la fecha de valoración.
curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930" Inventarios guardados por lotes
Envía hasta 100 SteamID64 o URL /profiles/, separados por comas. /api/v1/inventories lee valoraciones guardadas sin contactar con Steam. cached indica una valoración guardada; unknown, que no existe. Solicita una valoración mediante /api/v1/inventory.
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930" Todos los precios de TF2 en una petición
curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/games/tf2/prices" 429 indica que se ha alcanzado un límite de la API; 503 indica que la valoración está pendiente o que Steam limita temporalmente las solicitudes. Espere todo el tiempo indicado en Retry-After, en segundos, aunque supere un minuto, y no reintente en paralelo las solicitudes del mismo perfil.
Actualización de precios
Los precios de /api/v1/price, /api/v1/offers y los métodos de Dota 2, Rust y TF2 bajo /api/v1/games tienen un retraso mínimo de 6 horas. Consulta pricedAt, snapshotAt y stale: no son cotizaciones en tiempo real. Si no hay una instantánea diferida disponible, la API devuelve 503 con Retry-After. Las valoraciones de inventario tienen su propio checkedAt.
Endpoints
Los métodos y parámetros proceden de OpenAPI. Los parámetros marcados con * son obligatorios. Consulta la especificación para ver los esquemas completos de respuesta.
| Endpoint | Devuelve | Parámetros |
|---|---|---|
GET /api/v1/droppool clave API | Pool de drops semanal de CS2 que se monitoriza | — |
GET /api/v1/status clave API | Fechas de actualización de fuentes de precios y conjuntos de datos | — |
GET /api/v1/index | Índice de mercado CS2 actual y capitalización por categoría | lang |
GET /api/v1/index/history | Historial diario del índice CS2 de una categoría | categorydayslang |
GET /api/v1/inventory clave API | Valoración de un inventario público de Steam: CS2, Dota 2, Rust y TF2 | steam*lang |
GET /api/v1/inventories clave API | Valoraciones guardadas de hasta 100 inventarios de Steam por solicitud | steam*lang |
GET /api/v1/price clave API | Buscar objetos CS2 por nombre; precios con al menos 6 horas de retraso | q*langcurrency |
GET /api/v1/price/history clave API | Historial diario del precio de un objeto CS2 | q*dayslang |
GET /api/v1/offers clave API | Ofertas de mercados de un objeto CS2 con al menos 6 horas de retraso | name*lang |
GET /api/v1/games/{game} clave API | Catálogo de Dota 2, Rust o TF2: filtros y fuentes de precios | game*lang |
GET /api/v1/games/{game}/items clave API | Objetos de Dota 2, Rust o TF2; precios con al menos 6 horas de retraso | game*qnameheroraritytypequalityslotcategoryitemclasssortpagelimitlang |
GET /api/v1/games/{game}/items/{slug} clave API | Un objeto de Dota 2, Rust o TF2 con ofertas de mercados y al menos 6 horas de retraso | game*slug*lang |
GET /api/v1/games/{game}/prices clave API | Todos los precios de un juego en una respuesta, con al menos 6 horas de retraso | game* |
GET /api/v1/float | Float, seed, pegatinas y amuleto de un objeto CS2 mediante su enlace de inspección | url*lang |
GET /api/v1/teams clave API | Equipos CS2 del ranking oficial de Valve | region |
GET /api/v1/teams/{slug} clave API | Perfil de equipo: plantilla, trofeos, partidos e historial del ranking | slug* |
GET /api/v1/players clave API | Jugadores de los equipos del ranking de Valve | steamlimit |
GET /api/v1/players/{slug} clave API | Perfil del jugador y equipo actual | slug* |
Acceso separado para asistentes de IA
Los asistentes de IA reconocidos pueden consultar inventarios sin clave. Las cuotas de solicitudes se aplican por IP; las primeras consultas comparten un presupuesto entre todos los asistentes. Cada lote admite hasta 50 perfiles. Estos no son los límites de tu clave personal.
- Solicitudes por minuto para asistentes de IA conocidos en /api/v1
- 120
- Solicitudes de inventario por hora e IP
- 240
- Consultas por minuto de perfiles nunca tasados, compartidas por todos los asistentes de IA
- 32
Especificación y archivos legibles por máquina
/api/openapi.jsonespecificación OpenAPI 3.1: parámetros, esquemas de respuesta y errores/.well-known/openapi.jsonla misma especificación en la dirección well-known/llms.txtresumen del sitio con patrones de URL y recetas de API para asistentes de IA/llms-full.txttodas las guías de texto en inglés en un solo archivo Markdown/llms-catalog.txtCS2: top 500 skins por valor de mercado listado en JSON Lines, actualizado cada hora/.well-known/ai-catalog.jsonmanifiesto de capacidades para agentes de IA- Metodología de dónde salen los precios y cómo se calculan
Licencia
Las guías, los textos editoriales y los datos derivados propios del sitio (estimaciones del pool de drops, RTP de cajas, índices, medianas diarias, tablas de patrones, la recopilación llms-catalog.txt) tienen licencia CC BY 4.0: cita a Skinory con un enlace a la página de origen.
Los datos de equipos y jugadores (/api/v1/teams, /api/v1/players) proceden de Liquipedia y tienen licencia CC BY-SA 4.0: cita a Skinory con un enlace y comparte las adaptaciones con la misma licencia.
Los catálogos usan datos de Steam y archivos de los juegos, incluido CSGO-API para CS2. Estos materiales y los precios de mercados son de terceros; se aplican las condiciones de sus titulares originales.
Cómo citar
Cita una página como «Skinory — título de la página, URL, fecha de actualización», con la URL canónica y la fecha que muestra la página o, si no la tiene, la fecha de consulta. Da los precios con su moneda y hora: cambian.
Skinory — AK-47 | Redline, https://skinory.io/es/items/ak-47-redline, 2026-11-17
