4D Results (Malaysia, Singapore, Cambodia)

4D Results API & MCP Server — 4dlivetoday

马来西亚、新加坡和柬埔寨的官方 4D 彩票开奖结果，提供免费的 JSON API 和远程 MCP 服务，AI 助手（Claude、ChatGPT、Cursor 等）可直接查询。

• 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 开奖共有 23 个号码：1、2、3 等奖号码、10 个特别奖（starter）号码和 10 个安慰奖号码。

其他官方游戏（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（6 位数的 1 至 3 等奖、starter 和安慰奖）
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 个附加号码，Group 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 开奖结果和头奖金额是多少？”
• “下一期新加坡 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	某家运营商的近期开奖（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

一期开奖结果（真实数据，已精简）：

{
  "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	已通过独立的第二来源确认官方结果
verifying	结果已公布，正在等待第二来源核验（通常在开奖后几分钟内）
single_source	该运营商只有一个官方来源
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	—	来自同一地址的 MCP 请求过多；请等待 Retry-After
503	upstream_unavailable	结果存储暂时无法访问；请稍后重试

没有开奖的日期（例如每周开奖运营商的普通周一）不属于错误：会返回 200 和空列表。

在 MCP 中，同样的问题会作为工具结果返回，并带有 isError: true 和相同的消息。

---

合理使用与缓存

• 无需密钥，也无需注册。响应会缓存约 60 秒；结果只会在开奖时间前后变化，因此也请在你这边进行缓存。
• 未知查询参数会被丢弃，并重定向至规范 URL。
• MCP 端点每次调用只接受一个请求（不支持 JSON-RPC 批处理）。
• 开奖夜（马来西亚时间开奖日约 18:30–21:30）是结果发生变化的时段；轮询频率高于每分钟一次没有任何好处。
• 滥用流量可能会在不另行通知的情况下受到速率限制。

---

署名

数据采用 CC BY 4.0 许可。如果你展示或再发布这些数据，请注明：

结果来自 4dlivetoday.com，汇编自各运营商的官方网站。

欢迎添加返回本站的链接，这也是本站得以免费运营的方式。

---

数据质量

• 开奖夜的每项结果均取自运营商自己的官方网站。如有第二个独立来源，会对结果进行交叉核对，其 status 会变为 checked。
• 较早的开奖记录从结果档案导入。它们的 status 为 history；若有第二个来源证实数字相同，则为 checked（例如 Magnum 自 1985 年以来的每次开奖）。各运营商数据的追溯年限，以及经第二个来源确认的较早开奖记录数量，列于数据来源页面。
• 始终以运营商自己的公告为准。如果你发现某项结果与运营商的官方网站不一致，请提供日期、运营商和运营商页面，提交 issue。

---

许可

• API 和 MCP 服务返回的数据：知识共享署名 4.0 国际许可协议（CC BY 4.0）。请参阅 DATA-LICENSE.md。
• 本仓库中的代码和文档：MIT。

4dlivetoday 是一个独立的结果网站，与上文所列任何运营商均无关联；使用运营商名称仅为标识其结果。仅供年满 21 岁且当地法律允许的读者使用。