Polymarket Scan MCP

Máy chủ MCP PolymarketScan

Dữ liệu chỉ đọc từ các thị trường dự đoán Polymarket.com dành cho trợ lý AI. Kết nối ChatGPT, Claude, Grok, Cursor, Claude Code hoặc bất kỳ máy khách MCP nào để nhận xác suất ngụ ý từ thị trường (tỷ lệ cược), lịch sử giá, các biến động lớn nhất, thị trường đang thịnh hành, giao dịch lớn, dòng mua và bán, thống kê nhà giao dịch công khai và tin tức liên quan.

• Không cần tài khoản, khóa API hoặc OAuth. Mọi công cụ đều công khai và chỉ đọc.
• Chỉ đọc. Các công cụ không thể đặt, thay đổi hoặc hủy lệnh, chuyển tiền hoặc truy cập bất kỳ tài khoản nào.
• Phiên bản: 2.0.0 (tháng 10 năm 2026). Giao thức: MCP qua Streamable HTTP (không trạng thái, phản hồi JSON).

Điểm cuối

https://mcp.polymarketscan.org/mcp

Địa chỉ gốc vẫn hoạt động và phục vụ cùng một máy chủ:

https://gzydspfquuaudqeztorw.supabase.co/functions/v1/mcp-server/mcp

Công cụ (11)

Máy khách MCP của bạn đọc toàn bộ lược đồ đầu vào và đầu ra của từng công cụ từ máy chủ (tools/list). Mọi đầu vào trừ những đầu vào được đánh dấu là bắt buộc đều là tùy chọn.

search_markets (Tìm kiếm thị trường dự đoán)

Tìm kiếm các thị trường đang mở trên Polymarket.com và trả về các kết quả khớp nhất, mỗi kết quả có tối đa sáu xác suất ngụ ý từ thị trường của các kết quả, thay đổi trong 24 giờ và khối lượng.

• Đầu vào: query (bắt buộc): sự kiện, con người, đội, tài sản hoặc câu hỏi bằng từ ngữ thông thường, tối đa 200 ký tự. limit: 1 đến 10, mặc định 5.
• Ghi chú: chỉ các thị trường đang mở. Các kết quả mà truy vấn nêu tên được xếp trước, sau đó là các kết quả dẫn đầu (hoặc các bậc của thang giá gần 50% nhất). Để xem danh sách đầy đủ các kết quả của một thị trường, quy tắc và trạng thái, hãy dùng get_market_odds.
• Thử hỏi: "Tỷ lệ cược cho quyết định lãi suất tiếp theo của Fed là bao nhiêu?"

get_market_odds (Lấy tỷ lệ cược thị trường)

Một thị trường hoặc sự kiện đầy đủ: xác suất của từng kết quả và thay đổi trong 24 giờ (tối đa 40 kết quả, cộng với tổng số lượng), khối lượng, thanh khoản, ngày kết thúc, trạng thái, quy tắc giải quyết và nguồn, cùng kết quả sau khi đã giải quyết.

• Đầu vào: market (bắt buộc): slug thị trường hoặc sự kiện, liên kết polymarket.com hoặc polymarketscan.org, ID điều kiện (0x + 64 hex) hoặc thị trường bằng từ ngữ thông thường.
• Ghi chú: hoạt động cho các thị trường đang mở, đã đóng và đã giải quyết. Các kết quả loại trừ lẫn nhau được xếp hạng theo xác suất. Nếu không có gì khớp, nó trả về tối đa 3 thị trường đang mở gần nhất thay thế.
• Thử hỏi: "Cho tôi xem cơ hội của từng ứng viên trong cuộc bầu cử tổng thống năm 2028."

get_price_history (Lấy lịch sử giá)

Cách xác suất của một kết quả thay đổi trong một khoảng thời gian: bắt đầu và kết thúc, thay đổi theo điểm phần trăm, cao và thấp, và biểu đồ.

• Đầu vào: market (bắt buộc): như cho get_market_odds. outcome: kết quả để vẽ biểu đồ, chẳng hạn như "Có" hoặc tên ứng viên; mặc định là kết quả đang mở dẫn đầu của một sự kiện nhiều kết quả, hoặc kết quả đầu tiên của một thị trường đơn. range: 1d, 1w, 1m, 3m hoặc all, mặc định 1w.
• Ghi chú: giá đến từ lịch sử sổ lệnh của Polymarket.com. Các khoảng trống trong thị trường ít hoạt động được để trống. Đối với thị trường đã đóng hoặc đã giải quyết, phạm vi kết thúc khi giao dịch đóng cửa.
• Thử hỏi: "Tỷ lệ cược suy thoái kinh tế Mỹ đã thay đổi thế nào trong tháng này?"

get_market_movers (Lấy các biến động thị trường lớn nhất)

Các thị trường đang mở có thay đổi lớn nhất trong 24 giờ về xác suất (theo điểm phần trăm), kèm kết quả đã biến động, xác suất hiện tại và khối lượng 24 giờ; tối đa hai mỗi sự kiện.

• Đầu vào: direction: up, down hoặc both, mặc định both. category: một trong politics, elections, geopolitics, world, economy, finance, crypto, tech, culture, sports, esports, weather hoặc science; bỏ qua để lấy tất cả danh mục. limit: 1 đến 20, mặc định 10.
• Ghi chú: bao gồm 300 thị trường được giao dịch nhiều nhất (theo danh mục khi có danh mục được chỉ định) có ít nhất 10.000 USD giao dịch trong 24 giờ. Các thị trường có giá từ 1% trở xuống hoặc 99% trở lên bị loại vì thực chất đã được quyết định. Các trận đấu thể thao và thể thao điện tử riêng lẻ (các trận đấu đơn và các dòng chênh lệch điểm và tổng điểm của chúng, sắp diễn ra hoặc đang diễn ra) bị loại trừ trừ khi danh mục là sports hoặc esports; các hợp đồng tương lai như người thắng giải mùa giải hoặc chức vô địch vẫn được giữ.
• Thử hỏi: "Thị trường dự đoán nào biến động nhiều nhất hôm nay?"

get_trending_markets (Lấy thị trường đang thịnh hành)

Các sự kiện đang mở có khối lượng giao dịch lớn nhất trong 24 giờ qua, mỗi sự kiện có tối đa bốn xác suất của các kết quả (các kết quả dẫn đầu, hoặc các bậc của thang giá gần 50% nhất), thay đổi trong 24 giờ và khối lượng.

• Đầu vào: category: các giá trị tương tự như get_market_movers; bỏ qua để lấy tất cả danh mục. limit: 1 đến 20, mặc định 8.
• Ghi chú: các sự kiện đã có vẻ được quyết định (một kết quả ở mức 99% trở lên) và các bảng phụ của trò chơi bị loại trừ. Các trận đấu thể thao và thể thao điện tử riêng lẻ (các trận đấu đơn, sắp diễn ra hoặc đang diễn ra) bị loại trừ trừ khi danh mục là sports hoặc esports; các hợp đồng tương lai như người thắng giải mùa giải hoặc chức vô địch vẫn được giữ.
• Thử hỏi: "Điều gì đang thịnh hành trên Polymarket trong lĩnh vực tiền điện tử?"

get_whale_trades (Lấy giao dịch lớn)

Các giao dịch lớn nhất gần đây từ nguồn cấp giao dịch công khai của Polymarket.com, lớn nhất trước, kèm thời gian, bên, kết quả, quy mô đô la, cổ phần, giá, thị trường và ví cùng tên công khai của nhà giao dịch.

• Đầu vào: min_usd: giao dịch nhỏ nhất tính bằng đô la Mỹ, 1.000 đến 1.000.000, mặc định 10.000. market: giới hạn vào một thị trường hoặc sự kiện (slug, liên kết polymarket.com hoặc polymarketscan.org, ID điều kiện hoặc vài từ); bỏ qua để lấy tất cả thị trường. hours: khoảng thời gian nhìn lại, 1 đến 168, mặc định 24. limit: 1 đến 50, mặc định 15.
• Ghi chú: trên tất cả các thị trường, các lệnh khớp ở mức 99 xu trở lên hoặc 1 xu trở xuống (các thị trường thực chất đã được quyết định) bị loại trừ. Mỗi lệnh khớp được đếm một lần; đô la là cổ phần nhân với giá. Nếu nguồn cấp quá bận để quét toàn bộ cửa sổ, kết quả sẽ cho biết phạm vi nó bao phủ.
• Thử hỏi: "Cho tôi xem các giao dịch Polymarket trên 50.000 USD trong 24 giờ qua."

get_market_flow (Lấy dòng thị trường)

Ai đang mua và bán một thị trường: đô la đã mua, đã bán và ròng theo từng kết quả, số lượng giao dịch, tối đa 8 giao dịch lớn nhất và tối đa 5 người nắm giữ hàng đầu theo từng kết quả.

• Đầu vào: market (bắt buộc): như cho get_market_odds. hours: khoảng thời gian nhìn lại, 1 đến 168, mặc định 24.
• Ghi chú: đối với sự kiện nhiều kết quả, nó sử dụng kết quả đang mở dẫn đầu (đối với thang giá, bậc đang mở được giao dịch nhiều nhất) và nêu rõ điều đó. Tổng đô la đếm mỗi lệnh khớp một lần (phía người nhận), vì vậy chúng chạy khoảng một nửa khối lượng hai chiều mà Polymarket.com công bố. Trong các thị trường rất bận rộn, các lệnh khớp nhỏ có thể bị bỏ qua để toàn bộ cửa sổ vừa vặn; kết quả sẽ nêu rõ điều đó.
• Thử hỏi: "Ai đang mua thị trường Bitcoin 150.000 USD?"

get_leaderboard (Lấy bảng xếp hạng nhà giao dịch)

Bảng xếp hạng nhà giao dịch của Polymarket.com theo lợi nhuận hoặc khối lượng: thứ hạng, địa chỉ ví đầy đủ, tên hiển thị công khai, lợi nhuận và khối lượng đô la, kèm liên kết hồ sơ.

• Đầu vào: metric: profit hoặc volume, mặc định profit. period: day (kể từ 00:00 UTC), week (7 ngày), month (30 ngày) hoặc all, mặc định month. category: một trong sports, politics, crypto, economics, finance, tech, culture, esports, weather hoặc mentions; bỏ qua để lấy tất cả thị trường. limit: 1 đến 25, mặc định 10.
• Ghi chú: lợi nhuận ngày, tuần và tháng bao gồm các vị thế mở ở giá hiện tại; lợi nhuận mọi thời đại chỉ là lợi nhuận đã thực hiện. Polymarket không công bố khối lượng đô la theo danh mục, vì vậy các bảng theo danh mục để trống mục đó.
• Thử hỏi: "Ai là nhà giao dịch Polymarket hàng đầu theo lợi nhuận trong tháng này?"

get_trader_profile (Lấy hồ sơ nhà giao dịch)

Thống kê công khai của một nhà giao dịch: tên hiển thị, lợi nhuận đã thực hiện mọi thời đại và khối lượng, giá trị danh mục, vị thế mở, thị trường đã giao dịch, tối đa 5 vị thế lớn nhất và 8 giao dịch gần nhất.

• Đầu vào: trader (bắt buộc): địa chỉ ví 0x đầy đủ (42 ký tự), liên kết hồ sơ polymarket.com, @username hoặc tên người dùng.
• Ghi chú: tên người dùng được khớp chính xác khi có thể; nếu không, hồ sơ công khai gần nhất được sử dụng và kết quả sẽ nêu rõ điều đó. Các giao dịch gần đây là những giao dịch từ 1 USD trở lên. Nó không cho biết ai kiểm soát một ví.
• Thử hỏi: "Tra cứu nhà giao dịch Polymarket này: 0x…"

get_trader_positions (Lấy vị thế nhà giao dịch)

Tối đa 50 vị thế mở của một nhà giao dịch kèm cổ phần, giá trung bình và hiện tại, giá trị và lợi nhuận hoặc lỗ chưa thực hiện, cộng với tổng số lượng và giá trị danh mục.

• Đầu vào: trader (bắt buộc): như cho get_trader_profile. sort: value (giá trị hiện tại lớn nhất trước) hoặc pnl (lợi nhuận chưa thực hiện lớn nhất trước), mặc định value. limit: 1 đến 50, mặc định 20.
• Ghi chú: các vị thế có giá trị dưới 1 USD và các vị thế đã giải quyết đang chờ mua lại bị loại khỏi danh sách.
• Thử hỏi: "Các vị thế mở lớn nhất của nhà giao dịch này là gì?"

get_market_news (Lấy tin tức thị trường)

Tối đa 10 tiêu đề từ 14 ngày qua về một thị trường hoặc chủ đề, kèm hãng tin, thời gian đăng và liên kết, từ nguồn cấp tin tức của PolymarketScan về các hãng tin lớn.

• Đầu vào: market: slug thị trường hoặc sự kiện, liên kết polymarket.com hoặc polymarketscan.org, hoặc ID điều kiện; từ ngữ thông thường được coi là chủ đề. query: từ khóa chủ đề như "bitcoin etf"; với một thị trường, chỉ giữ lại tin tức của thị trường đó có đề cập đến chúng. limit: 1 đến 10, mặc định 5. Cung cấp một thị trường, một truy vấn hoặc cả hai.
• Ghi chú: không phải tìm kiếm web đầy đủ: nó không trả về nội dung bài viết và có thể không tìm thấy gì cho các thị trường ngách.
• Thử hỏi: "Có tin tức nào đằng sau biến động trong thị trường quyết định của Fed không?"

Kết quả

• Đơn vị giống nhau trong mọi công cụ: xác suất từ 0 đến 1, thay đổi giá theo điểm phần trăm, giá tính bằng xu, tiền tính bằng đô la Mỹ và số lượng cổ phần được ghi nhãn là cổ phần. Giá trị null có nghĩa là con số không có sẵn, không bao giờ là số không. Ví là địa chỉ chữ thường đầy đủ, vì vậy kết quả có thể được chuyển thẳng vào các công cụ nhà giao dịch.
• Chân trang. Văn bản của mỗi kết quả kết thúc bằng "Nguồn: Polymarket.com qua PolymarketScan. Chỉ mang tính thông tin, không phải lời khuyên tài chính." Các kết quả về giao dịch hoặc vị thế (get_whale_trades, get_market_flow, get_leaderboard, get_trader_profile, get_trader_positions) thêm "Giao dịch có rủi ro; có thể mất 100%." get_market_news kết thúc bằng "Nguồn: các hãng tin qua nguồn cấp tin tức của PolymarketScan. Chỉ mang tính thông tin, không phải lời khuyên tài chính." thay thế.
• Liên kết. Liên kết thị trường và nhà giao dịch mở các trang phân tích PolymarketScan và mang ?ref=mcp, đánh dấu lượt truy cập là đến từ trợ lý AI. Không có liên kết kết quả nào đến trang giao dịch trên polymarket.com. Tiêu đề tin tức liên kết đến bài viết của nhà xuất bản.
• Lỗi. Nếu dịch vụ dữ liệu của Polymarket không phản hồi, một công cụ trả về thông báo ngắn bằng tiếng Anh đơn giản yêu cầu bạn thử lại. Nó không bao giờ chuyển tiếp lỗi thô từ nguồn hoặc cơ sở dữ liệu.

Thẻ

Trong các máy chủ hỗ trợ MCP Apps (chẳng hạn như ChatGPT), kết quả được hiển thị trong thẻ PolymarketScan tương tác: tỷ lệ cược, biểu đồ giá, danh sách xếp hạng thị trường, giao dịch và nhà giao dịch. Thẻ không tải gì từ mạng. Trong các máy khách khác, cùng kết quả đến dưới dạng dữ liệu có cấu trúc cộng với bản tóm tắt ngắn bằng tiếng Anh đơn giản.

Thêm vào trợ lý của bạn

ChatGPT

• Thư mục plugin: khi PolymarketScan được liệt kê, hãy mở thư mục plugin trong ChatGPT, tìm kiếm "PolymarketScan" và kết nối.
• Chế độ nhà phát triển (trước khi liệt kê, hoặc để kiểm tra): bật Cài đặt → Bảo mật và đăng nhập → Chế độ nhà phát triển, đi tới chatgpt.com/plugins, nhấp +, nhập https://mcp.polymarketscan.org/mcp và chọn không xác thực.

Claude (claude.ai và Claude Desktop)

• Thư mục kết nối: khi PolymarketScan được liệt kê, hãy thêm từ Cài đặt → Kết nối → Duyệt kết nối.
• Kết nối tùy chỉnh: Cài đặt → Kết nối → Thêm kết nối tùy chỉnh. Đặt tên là PolymarketScan, dùng URL https://mcp.polymarketscan.org/mcp và để trống các trường OAuth.

Grok

Thêm một connector tùy chỉnh (MCP server) với URL https://mcp.polymarketscan.org/mcp và không cần xác thực.

Claude Code

claude mcp add --transport http polymarketscan https://mcp.polymarketscan.org/mcp

Cursor

Thêm vào ~/.cursor/mcp.json (tất cả dự án) hoặc .cursor/mcp.json (một dự án):

{
  "mcpServers": {
    "polymarketscan": {
      "url": "https://mcp.polymarketscan.org/mcp"
    }
  }
}

Các client chỉ chạy server local (stdio)

Kết nối qua mcp-remote, ví dụ trong claude_desktop_config.json:

{
  "mcpServers": {
    "polymarketscan": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.polymarketscan.org/mcp"]
    }
  }
}

Bất kỳ MCP client nào hoặc HTTP thông thường

Trỏ một Streamable HTTP client tới endpoint. Server không lưu trạng thái và trả lời JSON-RPC qua POST /mcp với JSON:

curl -s https://mcp.polymarketscan.org/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Nguồn dữ liệu

Tỷ lệ cược, giá, giao dịch, người nắm giữ, bảng xếp hạng và số liệu thống kê trader được lấy từ các API công khai của Polymarket.com khi một tool được gọi. Tiêu đề tin tức đến từ nguồn tin riêng của PolymarketScan từ các hãng truyền thông lớn. Phản hồi từ Polymarket.com được lưu cache tối đa một phút; bảng xếp hạng, thị trường đã thanh toán và tên hồ sơ công khai được lưu cache từ 2 phút đến một giờ.

Quyền riêng tư

Server chỉ nhận các lệnh gọi tool mà trợ lý thực hiện, không bao giờ nhận cuộc trò chuyện của bạn. Server ghi lại hai loại yêu cầu: một client kết nối (initialize) và một tool được sử dụng (tools/call). Việc liệt kê các tool và các thông điệp giao thức khác không được ghi lại. Mỗi bản ghi chứa hành động (một kết nối hoặc tên tool), loại client xác định từ user agent, 300 ký tự đầu tiên của user agent, một hàm băm có khóa của địa chỉ IP kết nối (HMAC-SHA-256 với khóa bí mật của server, được rút gọn) và thời gian. Dữ liệu đầu vào và kết quả của tool không được lưu trữ. Chi tiết: Chính sách quyền riêng tư, mục 3.

Tuyên bố miễn trừ trách nhiệm

Nguồn: Polymarket.com qua PolymarketScan. Chỉ mang tính thông tin, không phải lời khuyên tài chính. Xác suất ngụ ý từ thị trường là dự đoán của đám đông, không phải sự chắc chắn. Dữ liệu có thể bị trễ hoặc sai; hãy kiểm tra các con số quan trọng trên trang được liên kết. Giao dịch có rủi ro; có thể mất 100% vốn.

PolymarketScan là một nền tảng phân tích độc lập, không phải Polymarket. Điều khoản dịch vụ · Chính sách quyền riêng tư · Liên hệ · support@polymarketscan.org