Construire avec PinnFeed et l'IA
Réponse : prenez une clé Free sur inscription, exportez PINNFEED_KEY, collez un prompt de cette page dans Cursor, Claude, ChatGPT, Lovable, Replit ou Bolt, et donnez à l'agent llms-api.txt ou AGENTS.md. L'authentification se fait avec x-api-key (ou Bearer, ou ?key=). Le WebSocket demande Builder (99 €/mois).
1. La clé en une minute#
export PINNFEED_KEY="ps_live_..."
echo 'PINNFEED_KEY=ps_live_...' >> .env
echo '.env' >> .gitignore
Ne collez jamais la clé dans un chat partagé ni dans git. Free = REST avec environ 30 s de retard, 2 sports, 1 req/s, 1 000/jour. Hobby = REST en temps réel, sans WebSocket. Builder = le plan WebSocket. Détails : tarifs, démarrage rapide.
2. Vérifier la clé#
curl -sS -H "x-api-key: $PINNFEED_KEY" \
"https://pinnfeed.io/v1/odds?sport=soccer&main=true&limit=3"
OpenAPI : /openapi.json. Postman / Insomnia : collection JSON (variable apiKey).
3. Donner la vraie API à l'agent#
- API compacte : llms-api.txt
- Convention Cursor / Codex : AGENTS.md
- Skill produit : SKILL.md
- Docs (en anglais) : docs · WebSocket · MCP · erreurs
4. MCP (transports réels)#
MCP hébergé : POST https://pinnfeed.io/mcp (Streamable HTTP). Auth : Authorization: Bearer, x-api-key, ou ?key= si le client ne peut pas envoyer d'en-têtes.
{
"mcpServers": {
"pinnfeed": {
"url": "https://pinnfeed.io/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
claude mcp add --transport http pinnfeed https://pinnfeed.io/mcp \
--header "Authorization: Bearer YOUR_KEY"
Pour Claude Desktop, Claude web ou les connecteurs ChatGPT qui n'acceptent pas d'en-têtes : https://pinnfeed.io/mcp?key=YOUR_KEY avec une clé dédiée que vous pouvez révoquer. Outils : get_account, list_sports, search_events, get_live_odds, get_prematch_odds, get_event, get_drops, get_closing_odds.
5. Prompt de base (Cursor / Claude Code)#
Les prompts sont en anglais, comme la documentation que l'agent va lire :
You are building against PinnFeed (Pinnacle odds API).
1) Read https://pinnfeed.io/llms-api.txt and https://pinnfeed.io/openapi.json.
2) Use env PINNFEED_KEY only (x-api-key). Add .env to .gitignore.
3) Goal: YOUR_GOAL
4) Prefer REST on Free/Hobby; WebSocket only if I confirm Builder.
5) Educational, 18+. No betting tips, no guaranteed profit.
Plus de prompts (ChatGPT, Lovable, Replit) et 8 idées d'applications : hub vibe coding en anglais.
Essai#
Builder (99 €/mois) pour le WebSocket et l'historique des cotes de clôture. Essai de 3 jours ; carte requise, débitée après le jour 3 sauf résiliation. Clé gratuite : inscription.
Contenu éducatif réservé aux plus de 18 ans. Les règles sur les jeux d'argent varient selon les pays ; en France, ils sont encadrés par l'ANJ. Ceci n'est pas un avis juridique.
Questions fréquentes#
Faut-il Builder pour faire du vibe coding ?#
Non pour des prototypes REST sur Free ou Hobby. Oui pour /v1/stream et /v1/closing.
L'agent peut-il inventer des endpoints ?#
Il ne doit pas : épinglez-le à l'OpenAPI et à llms-api.txt.
Le serveur MCP compte-t-il dans le quota ?#
Oui, chaque tools/call compte comme une requête REST.