Iniziare · 60 secondi

Quickstart: dalla chiave alle prime quote

Aggiornato il 9 novembre 2026 · PinnFeed · 2 min di lettura

Risposta: registrati → copia una volta la chiave ps_live_... dalla dashboard → export PINNFEED_KEY=... → un curl su /v1/odds. È il percorso da 60 secondi. Seguono Python, Node e Sheets. Il WebSocket è il passo 5 (Builder). La documentazione completa resta su /docs (in inglese).

Passo 1 — La chiave#

Crea un account gratuito.
Dashboard → Create key → copia ps_live_... (mostrata una sola volta).
Solo nell'ambiente:

export PINNFEED_KEY="ps_live_..."

Passo 2 — curl#

curl -sS -H "x-api-key: $PINNFEED_KEY" \
  "https://pinnfeed.io/v1/odds?sport=soccer&main=true&limit=5"

Ricevi eventi JSON con mercati ed esiti (decimal, american, fair, fairProb). Contratto: openapi.json.

Passo 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"])

Passo 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);

Passo 5 — Google Sheets#

IMPORTDATA non può inviare x-api-key. Usa Estensioni → Apps Script con la chiave nelle proprietà dello script e segui la guida Google Sheets.

Quando ti serve il push#

Il WebSocket wss://pinnfeed.io/v1/stream richiede Builder (99 €/mese). Le chiavi Free e Hobby ricevono 403 plan_lacks_ws. Client Python e Node: guida WebSocket.

Assistenti IA#

MCP: /docs/mcp. File per agenti: llms-api.txt, AGENTS.md, SKILL.md. Prompt pronti: vibe coding.

Prova#

REST gratuito con ritardo: registrazione. WebSocket Builder: prezzi, prova di 3 giorni; serve una carta, addebitata dopo il giorno 3 se non disdici prima.

Contenuto educativo per maggiorenni (18+).

Domande frequenti#

Che differenza c'è con /docs?#

Questa pagina è il percorso da 60 secondi. /docs è la guida completa per sviluppatori (WebSocket, schema, esempi).

Posso mettere la chiave in una cella del foglio?#

No. Usa le proprietà dello script o un secret: una chiave in una cella finisce copiata ed esposta.

Devo pagare per iniziare?#

No. Free costa 0 € (REST, 30 s di ritardo, 2 sport, 1.000 richieste al giorno), senza carta.