はじめに · 60秒

クイックスタート：キーから最初のオッズまで

更新日 2026年11月9日 · PinnFeed · 約1分で読めます

回答： 登録 → ダッシュボードでps_live_...キーを一度だけコピー → export PINNFEED_KEY=... → /v1/oddsをcurlで呼び出します。これが60秒の手順です。続いてPython、Node、スプレッドシート。WebSocketはステップ5（Builder）です。詳しいドキュメントは/docs（英語）にあります。

ステップ1：キー#

無料アカウントを作成します。
ダッシュボード → Create key → ps_live_...をコピー（表示は一度だけ）。
環境変数にだけ保存します：

export PINNFEED_KEY="ps_live_..."

ステップ2：curl#

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

マーケットとアウトカム（decimal、american、fair、fairProb）を含むJSONのイベントが返ります。仕様：openapi.json。

ステップ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"])

ステップ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);

ステップ5：Googleスプレッドシート#

IMPORTDATAはx-api-keyを送れません。拡張機能 → Apps Scriptを使い、キーはスクリプトプロパティに保存してください。手順はGoogleスプレッドシートのガイドにあります。

プッシュが必要になったら#

WebSocket wss://pinnfeed.io/v1/streamにはBuilder（月額99ユーロ）が必要です。FreeとHobbyのキーには403 plan_lacks_wsが返ります。PythonとNodeのクライアント：WebSocketガイド。

AIアシスタント#

MCP：/docs/mcp。エージェント向けファイル：llms-api.txt、AGENTS.md、SKILL.md。コピーして使えるプロンプト：バイブコーディング。

無料トライアル#

遅延ありの無料REST：登録。Builder WebSocket：料金。3日間の無料トライアルにはカード登録が必要で、それまでに解約しない場合は3日目の終了後に課金されます。

18歳以上の方を対象とした教育目的のコンテンツです。

よくある質問#

/docsとの違いは？#

このページは60秒の最短手順です。/docsはWebSocket、スキーマ、例を含む開発者向けの完全なガイドです。

キーをセルに入れてもいいですか？#

いいえ。スクリプトプロパティかシークレットを使ってください。セルに入れたキーはコピーされて漏れます。

始めるのにお金はかかりますか？#

いいえ。Freeは0ユーロ（REST、30秒遅延、2競技、1日1,000リクエスト）で、カードは不要です。