API développeur
Un flux de prix public et gratuit pour les skins CS2 (CS:GO) sur SkinCash. Conçu pour les sites de comparaison de prix, les agrégateurs et les extensions de navigateur. Pas de clé API, pas d'inscription — juste une simple requête GET.
# réponse d'exemple — appuyez sur Exécuter pour interroger l'API en direct
{
"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"
}
], …
}En bref
Démarrage rapide
Récupérez l'intégralité du catalogue en direct en une seule requête. Envoyez Accept-Encoding: gzip (le --compressed de curl) — le flux complet fait quelques Mo non compressé.
curl -s --compressed https://api.skincash.gg/v1/pricesVotre choix de langage reste appliqué sur toute la page.
Authentification
L'API est publique — chaque point de terminaison est un simple GET, sans inscription, sans OAuth. Le CORS est ouvert, vous pouvez donc l'appeler directement depuis un navigateur. Il suffit d'envoyer la requête :
L'accès anonyme est limité en débit par IP (voir Limites de débit). Si vous gérez un agrégateur ou une extension et avez besoin de plus, nous délivrons une clé partenaire gratuite qui augmente votre limite — aucun autre comportement ne change. Envoyez-la dans un en-tête Authorization: Bearer (ou X-API-Key) :
curl -s --compressed \
-H "Authorization: Bearer YOUR_API_KEY" \
https://api.skincash.gg/v1/pricesDemandez une clé à [email protected]. Gardez-la côté serveur ; traitez-la comme un mot de passe.
Points de terminaison
Le catalogue complet — chaque article en vente, prix d'achat le plus bas + stock en direct + lien profond, trié du plus cher au moins cher. Prend en charge gzip et les requêtes conditionnelles. Essayez en direct ↑
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 article par son nom Steam exact (encodé pour URL). Renvoie 404 s'il n'est pas actuellement en vente.
market_hash_namestring · requismarket_hash_name Steam exact, encodé pour 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"
}Métadonnées des articles — image, type, rareté pour chaque article en vente (sans prix). Vous permet d'afficher et de rapprocher les annonces SkinCash sans scraping. Même cache de 5 min + GET conditionnel 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"
}
]
}Recherchez des articles par nom (partiel) → prix d'achat + lien profond canonique. La surface de comparaison et de redirection pour les outils de comparaison de prix et extensions de navigateur. Les correspondances exactes/par préfixe sont classées en premier.
qstring · requis2–200 caractères, insensible à la casse.limitinteger · optionnel1–100, par défaut 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"
}
]
}Spécification OpenAPI 3.1 lisible par machine pour l'ensemble de l'API — le premier arrêt pour les générateurs de code, les clients API et les LLM.
curl -s https://api.skincash.gg/v1/openapi.jsonSchéma de réponse
Le updated_at au niveau du flux indique la fraîcheur de chaque ligne : tous les prix se rafraîchissent ensemble à chaque cycle (~5 min). Les prix correspondent au prix d'achat payé par le client.
Interrogation efficace (ETag / 304)
Chaque réponse porte un ETag et un Last-Modified. Renvoyez-les lors de votre prochaine interrogation pour obtenir un 304 Not Modified économique (sans corps) lorsque rien n'a changé — interrogez aussi souvent que vous le souhaitez sans re-télécharger le catalogue.
# 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 débit
Extractions complètes — /prices, /catalog
Lectures légères — /prices/{name}, /search
Les limites sont par IP et réparties selon le poids de la charge utile. Le flux est mis en cache, donc avec des requêtes conditionnelles une interrogation toutes les 5 minutes n'en approche jamais. Dépasser une limite renvoie 429 RATE_LIMITED avec un en-tête Retry-After. Besoin de limites plus élevées pour une intégration à fort trafic ? Contactez-nous au sujet d'une clé partenaire.
Versionnage et stabilité
L'API est versionnée dans le chemin (/v1). Au sein d'une version, nous ne faisons qu'ajouter des champs — un champ existant n'est jamais renommé, supprimé ni retypé, votre analyseur ne cassera donc pas. Les changements incompatibles sont livrés dans une nouvelle version, avec préavis.
Erreurs
Les erreurs partagent toujours une structure de corps cohérente :
{
"success": false,
"error": {
"error_code": "NOT_FOUND",
"message": "No live price for this item."
}
}Vous gérez un agrégateur ou une extension ?
Référencez SkinCash comme source — le flux ci-dessus est prêt à être consommé dès aujourd'hui. Nous serons ravis de nous adapter à votre spécification d'ingestion, d'ajouter des champs ou de mettre en place un accord de partenariat. Contactez-nous et nous agirons vite.
[email protected]