Démarrage rapide : de la clé aux premières cotes
Réponse : inscription → copiez une fois votre clé ps_live_... depuis le tableau de bord → export PINNFEED_KEY=... → un curl sur /v1/odds. C'est le chemin de 60 secondes. Python, Node et Sheets suivent. Le WebSocket est l'étape 5 (Builder). La documentation complète reste sur /docs (en anglais).
Étape 1 — La clé#
- Créez un compte gratuit.
- Tableau de bord → Create key → copiez
ps_live_...(affichée une seule fois). - Uniquement dans l'environnement :
export PINNFEED_KEY="ps_live_..."
Étape 2 — curl#
curl -sS -H "x-api-key: $PINNFEED_KEY" \
"https://pinnfeed.io/v1/odds?sport=soccer&main=true&limit=5"
Vous recevez des événements JSON avec marchés et issues (decimal, american, fair, fairProb). Contrat : openapi.json.
Étape 3 — Python#
import os, urllib.request, json
req = urllib.request.Request(
"https://pinnfeed.io/v1/odds?sport=soccer&main=true&limit=5",
headers={"x-api-key": os.environ["PINNFEED_KEY"]},
)
print(json.load(urllib.request.urlopen(req))["events"][0]["home"])
Étape 4 — Node#
const key = process.env.PINNFEED_KEY;
const r = await fetch(
"https://pinnfeed.io/v1/odds?sport=soccer&main=true&limit=5",
{ headers: { "x-api-key": key } },
);
const data = await r.json();
console.log(data.events?.[0]?.home);
Étape 5 — Google Sheets#
IMPORTDATA ne peut pas envoyer x-api-key. Passez par Extensions → Apps Script et la clé dans les propriétés du script, puis suivez le guide Google Sheets.
Quand il vous faut le push#
Le WebSocket wss://pinnfeed.io/v1/stream demande Builder (99 €/mois). Les clés Free et Hobby reçoivent 403 plan_lacks_ws. Client Python et Node : guide WebSocket.
Assistants IA#
MCP : /docs/mcp. Fichiers pour agents : llms-api.txt, AGENTS.md, SKILL.md. Prompts prêts à copier : vibe coding.
Essai#
REST gratuit avec retard : inscription. WebSocket Builder : tarifs — essai de 3 jours ; carte requise, débitée après le jour 3 sauf résiliation.
Contenu éducatif réservé aux plus de 18 ans.
Questions fréquentes#
Quelle différence avec /docs ?#
Cette page est le chemin de 60 secondes. /docs est le guide développeur complet (WebSocket, schéma, exemples).
Puis-je mettre la clé dans une cellule du tableur ?#
Non. Utilisez les propriétés du script ou une variable secrète : une clé dans une cellule finit copiée et exposée.
Faut-il payer pour commencer ?#
Non. Free est à 0 € (REST, 30 s de retard, 2 sports, 1 000 requêtes/jour), sans carte.