4D Results (Malaysia, Singapore, Cambodia)

4D Results API と MCP Server — 4dlivetoday

マレーシア、シンガポール、カンボジアの公式4D宝くじ結果を、無料のJSON APIと、AI アシスタント（Claude、ChatGPT、Cursorなど）から直接問い合わせられるリモートMCP サーバーで提供します。

• MCP サーバー： https://4dlivetoday.com/mcp（Streamable HTTP、サインイン不要）
• REST API： https://4dlivetoday.com/api/v1/（JSON、キー不要）
• ドキュメントページ： https://4dlivetoday.com/en/developers
• データライセンス： CC BY 4.0 — 商用利用を含め無料で使用できますが、帰属表示が必要です

抽選日には、各運営元の公式ウェブサイトから結果を取得し、独立した結果サイトが存在する場合は照合します。過去の抽選結果は結果アーカイブから取得します（Magnumの公式アーカイブは1985年まで遡り、その他は主にcheck4d.orgのアーカイブです）。各運営元の収録範囲についてはデータソースをご覧ください。このサービスが公開するのは結果と抽選履歴のみです。チケットの販売や賭けの受付は行わず、番号の推奨、「ホット」ナンバー、予測も提供しません。

---

目次

• 対象範囲
• AI アシスタントからの利用（MCP）
• MCP ツール
• REST API
• レスポンス形式
• エラー
• 適正利用とキャッシュ
• 帰属表示
• データ品質
• ライセンス

---

対象範囲

運営元ID	名称	地域
magnum	Magnum 4D	マレーシア
damacai	Da Ma Cai 1+3D	マレーシア
toto	Sports Toto 4D	マレーシア
sabah88	Sabah 88 4D	東マレーシア
stc	Sandakan STC 4D	東マレーシア
cashsweep	Sarawak Cash Sweep	東マレーシア
sg	Singapore 4D（Singapore Pools）	シンガポール
gd	Grand Dragon 4D（GD Lotto）	カンボジア
perdana	Perdana 4D（夕方。午後の抽選はperdana3pmとして表示されます）	カンボジア
9lotto	9 Lotto 4D	カンボジア

各4D抽選には、1等、2等、3等、スペシャル（スターター）10個、コンソレーション10個の計23個の番号があります。

その他の公式ゲーム（game ID）：

ゲームID	名称
magnum_life	Magnum Life（8個の番号＋ボーナス2個）
magnum_jackpot, magnum_gold	Magnum 4D Jackpot／Jackpot Goldの賞金額
damacai_3p3d	Da Ma Cai 3+3D（1等～3等、スターター、コンソレーションの6桁番号）
damacai_jackpot	Da Ma Cai 1+3D Jackpotおよび3D Jackpotの賞金額
toto_5d, toto_6d	Toto 5D、Toto 6D
toto_star, toto_power, toto_supreme	Star Toto 6/50、Power Toto 6/55、Supreme Toto 6/58
toto_jackpot	Sports Toto 4D Jackpotの賞金額
sg_toto	Singapore Toto（6個の番号＋追加番号、グループ1の賞金）

履歴：4Dの結果は数十年前まで遡ります（Magnumは1985年から）。MagnumとDa Ma Caiのその他のゲームは過去12か月分を収録しており、毎日更新されます。Sports TotoのゲームとSingapore Totoは2026年9月下旬以降の結果を収録しています。

抽選日と時刻については、https://4dlivetoday.com/en/schedule（または`get_draw_schedule`ツール）をご覧ください。

---

AI アシスタントからの利用（MCP）

サーバーは次のエンドポイントでStreamable HTTPを提供します。

https://4dlivetoday.com/mcp

APIキーもOAuthも不要です。

Claude（claude.aiおよびClaude Desktop、コネクター経由）

設定 → コネクター → カスタムコネクターを追加 → https://4dlivetoday.com/mcpを貼り付けます。

Claude Desktop（設定ファイル、mcp-remote経由）

claude_desktop_config.json：

{
  "mcpServers": {
    "4dlivetoday": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://4dlivetoday.com/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http 4dlivetoday https://4dlivetoday.com/mcp

Cursor

~/.cursor/mcp.json（またはプロジェクト内の.cursor/mcp.json）：

{
  "mcpServers": {
    "4dlivetoday": { "url": "https://4dlivetoday.com/mcp" }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "4dlivetoday": { "type": "http", "url": "https://4dlivetoday.com/mcp" }
  }
}

試してみる

アシスタントに、次のような質問をしてみてください。

• 「昨夜のMagnum 4Dの結果は？」
• 「2026年9月27日の各運営会社の4D結果をすべて表示して」
• 「1063が賞に当たったことはある？いつ？」
• 「最新のSupreme Toto 6/58の結果とジャックポットは？」
• 「次回のSingapore 4Dの抽せんはいつ？」

すぐに使える設定ファイルはexamples/mcpにあります。

---

MCP ツール

ツール	入力	戻り値
get_latest_results	—	各運営会社の最新の抽せん
get_results_by_date	date（YYYY-MM-DD、マレーシア時間）	指定日の各運営会社の抽せん
get_operator_results	operator、limit（1～30、デフォルトは10）	その運営会社の最近の抽せん
lookup_number	number（4桁、例："0650"）	その数字が当選したすべての抽せん。賞の等級別に新しい順で表示され、合計件数も含まれます
get_other_game_results	game、limit（1～30、デフォルトは10）	上記の他のゲームのうち、指定したゲームの最近の結果
get_draw_schedule	—	今後の抽せん日（通常・特別）と、抽せんを実施する運営会社

各ツールの結果には、短いテキストの概要と完全な構造化データが含まれます。また、各結果には4dlivetoday.comの該当ページへのurlが含まれるため、アシスタントからリンクできます。

---

REST API

ベースURL：https://4dlivetoday.com/api/v1

メソッドとパス	説明
GET /api/v1	インデックス：エンドポイントとエンベロープのフィールド
GET /api/v1/latest	各運営会社の最新の抽せん
GET /api/v1/results/{date}	指定日の全運営会社（YYYY-MM-DD、マレーシア時間）
GET /api/v1/operators/{operator}?limit=10	1つの運営会社の最近の抽せん（limitは1～30）
GET /api/v1/numbers/{number}	4桁の数字が当選したすべての履歴
GET /api/v1/games/{game}?limit=10	別の公式ゲームの最近の結果
GET /api/v1/schedule	今後の抽せん日
GET /api/v1/openapi.json	OpenAPI 3.1の説明

例

curl https://4dlivetoday.com/api/v1/latest
curl https://4dlivetoday.com/api/v1/results/2026-09-27
curl "https://4dlivetoday.com/api/v1/operators/magnum?limit=5"
curl https://4dlivetoday.com/api/v1/numbers/1063
curl "https://4dlivetoday.com/api/v1/games/sg_toto?limit=3"
curl https://4dlivetoday.com/api/v1/schedule

詳しくはexamples/をご覧ください：curl、Python、Node.js。

CORSはオープン（Access-Control-Allow-Origin: *）のため、ブラウザーから呼び出せます。

---

レスポンス形式

成功したレスポンスはすべて同じエンベロープを使用します（urlは4dlivetoday.com上の該当する人間向けページです）。

{
  "data": { "results": [ ] },
  "source": "4dlivetoday.com",
  "license": "CC BY 4.0",
  "license_url": "https://creativecommons.org/licenses/by/4.0/",
  "attribution": "Results from 4dlivetoday.com (https://4dlivetoday.com), compiled from each operator's official site.",
  "url": "https://4dlivetoday.com/en/results/2026-09-27",
  "generated_at": "2026-09-30T12:00:00.000Z"
}

エンドポイントごとのdataの内容：

エンドポイント	data
/latest	{ results: [draw, …] } — 各運営会社の最新の抽せん
/results/{date}	{ date, results: [draw, …] }（抽せんがない日は、resultsが空でnoteが含まれます）
/operators/{operator}	{ operator, operator_name, results: [draw, …] }
/numbers/{number}	{ number, count, results: [{ operator, operator_name, date, draw_no, tier, url }, …] } — tierは1st、2nd、3rd、special、またはconsolationです
/games/{game}	{ game, game_name, operator, results: [game result, …] }
/schedule	{ schedule: [{ date, kind, operators: [{ id, name }, …] }, …] } — kindはregularまたはspecialです

4Dの抽せん（実データ、一部抜粋）：

{
  "operator": "magnum",
  "operator_name": "Magnum 4D",
  "date": "2026-09-27",
  "draw_no": "428/26",
  "first": "1063",
  "second": "2421",
  "third": "5815",
  "special": ["6814", "7902", "… 10 numbers"],
  "consolation": ["1091", "8204", "… 10 numbers"],
  "status": "checked",
  "url": "https://4dlivetoday.com/en/results/2026-09-27"
}

数字は常に文字列なので、先頭のゼロは保持されます（"0650"であり、650ではありません）。

statusは、結果の確認状況を示します。

status	意味
checked	独立した第2の情報源で公式結果を確認済み
verifying	公開済みで、第2の情報源による確認中（通常、抽せんから数分後）
single_source	この運営会社には公式情報源が1つしかありません
history	アーカイブから取り込まれたデータ

ゲーム結果（実データ、一部抜粋）：

{
  "game": "sg_toto",
  "game_name": "Singapore Toto",
  "operator": "sg",
  "date": "2026-09-28",
  "draw_no": "4221",
  "numbers": ["14", "22", "25", "27", "34", "37"],
  "bonus": ["18"],
  "jackpots": { "Group 1 prize": "S$ 1,298,326" },
  "url": "https://4dlivetoday.com/en/sg-toto"
}

金額は運営会社が公開したとおりの通貨付き文字列です（"RM 12,749,753.62"、"S$ 1,298,326"）。抽せん番号を読みやすい形式で公開していない運営会社では、draw_noが空の場合があります。

---

エラー

{ "error": { "code": "invalid_date", "message": "date must be a real calendar date in YYYY-MM-DD format" } }

HTTP	code	発生条件
400	invalid_date, invalid_operator, invalid_number, invalid_game, invalid_limit	入力が不正です
429	—	1つのアドレスからの MCP リクエストが多すぎます。Retry-After を待ってください
503	upstream_unavailable	結果ストアに一時的にアクセスできません。しばらくしてから再試行してください

抽選がない日付（たとえば、週次の運営元にとっての通常の月曜日）はエラーではありません。200 と空のリストが返されます。

MCP では、同じ問題が isError: true と同じメッセージを含むツールの結果として返されます。

---

公正な利用とキャッシュ

• キーもサインアップも不要です。レスポンスは約60秒間キャッシュされます。結果が変わるのは抽選時間の前後のみなので、お使いの側でもキャッシュしてください。
• 不明なクエリパラメーターは、正規 URL へのリダイレクト時に削除されます。
• MCP エンドポイントは、呼び出しごとに1つのリクエストを受け付けます（JSON-RPC バッチには対応していません）。
• 抽選日の夜（マレーシア時間でおよそ18:30～21:30）は結果が変わる時間帯です。1分に1回を超えてポーリングしても意味はありません。
• 悪質なトラフィックは、通知なくレート制限される場合があります。

---

クレジット表記

データは CC BY 4.0 ライセンスで提供されています。表示または再公開する場合は、次のクレジットを記載してください。

4dlivetoday.com の結果。各運営元の公式サイトから集計しています。

リンクを掲載していただけると幸いです。また、リンクによって本サービスを無料で提供し続けることができます。

---

データ品質

• 抽選日の夜は、各結果を運営元の公式サイトから取得しています。独立した情報源がもう1つある場合は結果を照合し、status は checked になります。
• 過去の抽選結果は結果アーカイブから取り込まれています。これらには status: history が付与されます。2つ目の情報源で同じ数字が確認された結果（たとえば、1985年までさかのぼるすべての Magnum の抽選結果）には checked が付与されます。各運営元の結果をどこまでさかのぼれるか、また2つ目の情報源で確認された過去の抽選結果の数は、データソースのページに記載されています。
• 運営元自身の発表を常に最終的なものとして扱ってください。運営元の公式サイトと異なる結果を見つけた場合は、日付、運営元、および運営元のページを添えてissue を作成してください。

---

ライセンス

• API と MCP サーバーが返すデータ：Creative Commons Attribution 4.0 International (CC BY 4.0)。DATA-LICENSE.mdを参照してください。
• このリポジトリのコードとドキュメント：MIT。

4dlivetoday は独立した結果サイトです。上記の運営元とは提携していません。運営元の名前は、その結果を特定する目的でのみ使用しています。法律で認められている地域にお住まいの、21歳以上の方を対象としています。