Hãy tưởng tượng bạn muốn theo dõi cách thị trường định giá một sự kiện kinh tế duy nhất trên Kalshi, Polymarket và ForecastEx. Trên lý thuyết, nghe có vẻ như chỉ là một dashboard đơn giản. Trên thực tế, điều đó có nghĩa là ba API khác nhau, ba cách xác định cùng một thị trường, và ba định dạng phản hồi cần phải dung hòa trước khi bạn có thể vẽ nổi một biểu đồ.
Vấn đề đó càng lớn hơn với mỗi sàn mới. Các thị trường dự đoán hiện nay trải rộng từ các sàn giao dịch được quản lý tại Mỹ, các giao thức on-chain, các cộng đồng chơi bằng tiền ảo, cho đến các hợp đồng sự kiện từ những nền tảng crypto lâu đời, và không có sàn nào trong số đó chia sẻ một mô hình dữ liệu chung.
Đây chính là khoảng trống mà FinFeedAPI được tạo ra để lấp đầy. Prediction Markets API của nó đưa chín sàn giao dịch về dưới một schema được chuẩn hóa, giúp các nhà phát triển có thể truy vấn thị trường, giao dịch, sổ lệnh và lịch sử theo cùng một cách, bất kể dữ liệu đến từ đâu.
Đối với các nhà phát triển, sự tăng trưởng đó đi kèm với một sự thật phức tạp. Mỗi sàn đều phơi bày API riêng, mã định danh thị trường riêng, quy ước đặt tên riêng, và quan niệm riêng về việc một "thị trường" thậm chí trông như thế nào. Muốn có một dashboard theo dõi cùng một sự kiện trên ba nền tảng? Giờ bạn phải duy trì ba tích hợp, ba mô hình dữ liệu và ba tập hợp các trường hợp biên.
Đó chính xác là vấn đề mà FinFeedAPI đang cố gắng giải quyết.
Trong bài đánh giá này, tôi sẽ đi qua những gì Prediction Markets API của FinFeedAPI bao phủ, bạn thực sự nhận được dữ liệu gì, các endpoint trông như thế nào trong thực tế, chi phí ra sao, và nó còn thiếu sót ở đâu, để bạn có thể quyết định liệu nó có phù hợp với stack của mình hay không.
TL;DR
| Tiêu chí | Chi tiết |
|---|---|
| Nhà cung cấp | FinFeedAPI bởi API Bricks (cũng đứng sau CoinAPI) |
| Các sàn được hỗ trợ | 9 sàn thị trường dự đoán |
| Dữ liệu | Thị trường và metadata, giao dịch, báo giá, sổ lệnh, OHLCV, tệp phẳng lịch sử |
| Truy cập | REST, JSON-RPC, máy chủ MCP được host, Flat Files (S3) |
| Chế độ | Dữ liệu thị trường chỉ đọc, request-response (không có luồng WebSocket) |
| Giá | Tín dụng miễn phí để bắt đầu, sau đó tính theo mức sử dụng từ $1 cho mỗi 1.000 yêu cầu |
| Phù hợp nhất cho | Dashboard đa sàn, nghiên cứu, backtesting, AI agent |
FinFeedAPI là gì?
FinFeedAPI là một nhà cung cấp dữ liệu tài chính được xây dựng bởi API Bricks, cùng công ty đứng sau CoinAPI. Bên cạnh các API Stock, Currencies và SEC, nó cung cấp một Prediction Markets API cho phép bạn truy cập được chuẩn hóa vào dữ liệu thị trường từ chín sàn thị trường dự đoán thông qua một tích hợp duy nhất.
Ý tưởng rất đơn giản: thay vì học chín API, bạn chỉ học một. Mã thị trường, kết quả, dấu thời gian và cấu trúc phản hồi đều tuân theo cùng một schema bất kể dữ liệu đến từ sàn nào.
Một vài chi tiết kỹ thuật nổi bật với tôi khi đọc qua tài liệu:
- Mô hình dữ liệu thống nhất trên mọi sàn được hỗ trợ
-
Mã thị trường được chuẩn hóa bao gồm cả kết quả, ví dụ
..._YESvà..._NO - Dấu thời gian ISO 8601 UTC trên mọi endpoint
- Độ chính xác số nhất quán, lên tới 19 chữ số với 9 chữ số thập phân
- Bốn cách truy cập: REST, JSON-RPC, máy chủ MCP được host, và Flat Files
Một điều cần nói rõ ngay từ đầu: FinFeedAPI là một lớp dữ liệu thị trường chỉ đọc. Nó không đặt lệnh. Nếu sản phẩm của bạn cần khớp lệnh, bạn vẫn sẽ phải dùng API gốc của từng sàn cho phần đó.
Các nền tảng thị trường dự đoán được hỗ trợ
FinFeedAPI hiện bao phủ chín sàn, trải rộng từ các sàn được quản lý, các giao thức phi tập trung, các thị trường kết quả on-chain, cho đến một cộng đồng chơi bằng tiền ảo.
| Nền tảng | Loại | Phạm vi bao phủ |
|---|---|---|
| Polymarket | Phi tập trung | Chính trị, kinh tế, crypto, thể thao và các sự kiện toàn cầu |
| Kalshi | Được quản lý (CFTC) | Các hợp đồng sự kiện tại Mỹ về chỉ số kinh tế, bầu cử, thời tiết, thể thao và hơn thế nữa |
| ForecastEx | Được quản lý (CFTC) | Các hợp đồng sự kiện tại Mỹ, bao gồm các kết quả kinh tế và tài chính |
| Gemini Prediction Markets | Được quản lý | Hợp đồng sự kiện về thể thao, crypto, kinh tế, chính trị và các chủ đề khác |
| Crypto.com Prediction Markets | Được quản lý | Các hợp đồng dựa trên sự kiện trên nền tảng thị trường dự đoán của Crypto.com |
| Myriad | Phi tập trung | Crypto, các sự kiện thời sự và các kết quả khác |
| Pascal | Phi tập trung | Các thị trường dự đoán không lưu ký được xây dựng trên Solana |
| Hyperliquid Outcome Markets (HIP-4) | Thị trường kết quả on-chain | Các hợp đồng sự kiện nhị phân và đa kết quả trên hạ tầng gốc của Hyperliquid |
| Manifold Markets | Xã hội, tiền ảo | Các thị trường do cộng đồng dẫn dắt trên nhiều chủ đề |
Sự kết hợp này chính là điều khiến nó thú vị. So sánh cách một sàn được quản lý, một sàn crypto-native và một đám đông chơi bằng tiền ảo định giá cùng một sự kiện chính là nơi nghiên cứu đa sàn trở nên có giá trị. Đó cũng là nơi một schema được chuẩn hóa tiết kiệm được nhiều thời gian nhất.
Bạn có thể truy cập những dữ liệu nào?
Đây là nơi FinFeedAPI chứng minh được giá trị của mình. Hầu hết các công cụ thị trường dự đoán chỉ dừng ở mức giá mới nhất. FinFeedAPI phơi bày toàn bộ thị trường, từ bước khám phá cho tới độ sâu sổ lệnh và lịch sử.
Tất cả các endpoint REST đều nằm dưới https://api.prediction-markets.finfeedapi.com/v1.
| Tập dữ liệu | Endpoint | Bạn nhận được gì |
|---|---|---|
| Các sàn |
GET /exchanges và /exchanges/{exchange_id}
|
Các sàn được hỗ trợ, ID sàn, mô tả, website |
| Thị trường đang hoạt động | GET /markets/{exchange_id}/active |
Danh sách gọn các mã thị trường hiện đang hoạt động |
| Danh sách thị trường | GET /markets/{exchange_id}/history |
Bản ghi thị trường đầy đủ với phân trang dựa trên con trỏ: tiêu đề, mô tả, kết quả, giá, trạng thái |
| Một thị trường đơn lẻ | GET /markets/{exchange_id}/{market_id} |
Metadata của một thị trường |
| Hoạt động hiện tại | GET /activity/{exchange_id}/{market_id}/current |
Giao dịch mới nhất cùng giá chào mua và chào bán mới nhất |
| Hoạt động gần đây | GET /activity/{exchange_id}/{market_id}/latest |
Các giao dịch và cập nhật báo giá gần đây |
| Giao dịch và báo giá lịch sử |
GET /activity/{exchange_id}/{market_id}/history/trades và /history/quotes
|
Bản ghi lịch sử được phục vụ từ tệp phẳng |
| Sổ lệnh hiện tại | GET /orderbook/{exchange_id}/{market_id}/current |
Lệnh chào mua và chào bán cho một kết quả thị trường |
| Sổ lệnh lịch sử | GET /orderbook/{exchange_id}/{market_id}/history |
Các sự kiện lệnh giới hạn thô (thêm, cập nhật, xóa) để tái dựng sổ lệnh |
| OHLCV |
GET /ohlcv/periods, /ohlcv/{exchange_id}/{market_id}/history, /latest, /ohlcv/{exchange_id}/history
|
Nến với giá mở, cao, thấp, đóng, khối lượng và số lượng giao dịch |
Một vài điều đáng lưu ý:
-
Khám phá gồm hai bước. Endpoint
/activechỉ trả về các ID, vì nó được suy ra từ các báo giá và giao dịch gần đây. Bạn gọi/historyhoặc endpoint thị trường đơn lẻ để lấy thông tin đầy đủ. - Chu kỳ OHLCV trải từ vài giây cho tới vài năm, và các nến lịch sử được trả về theo thứ tự thời gian tăng dần, đúng như những gì bạn cần cho backtesting.
- Dữ liệu sổ lệnh lịch sử ở mức sự kiện, chứ không chỉ là ảnh chụp nhanh. Điều đó mở ra khả năng phát lại thị trường và nghiên cứu thanh khoản.
- Dữ liệu vòng đời và giải quyết bao gồm các trạng thái mở, đóng, đã giải quyết và tạm ngưng, cùng thông tin giải quyết ở những nơi sàn nguồn hỗ trợ.
Bắt đầu: Những yêu cầu đầu tiên của bạn
Việc làm quen rất nhanh. Bạn tạo một tài khoản miễn phí, tạo API key từ console, và bắt đầu với tín dụng miễn phí.
Với REST và JSON-RPC, bạn truyền key trong header Authorization. Tài liệu cũng chấp nhận X-APIKey, X-APIBricks-Key và X-CoinAPI-Key.
1. Liệt kê các sàn được hỗ trợ
Bắt đầu từ đây để lấy các giá trị exchange_id chính xác mà bạn sẽ dùng ở mọi nơi khác.
curl -X GET "https://api.prediction-markets.finfeedapi.com/v1/exchanges" \
-H "[REDACTED CREDENTIAL]
2. Khám phá các thị trường đang hoạt động
curl -X GET "https://api.prediction-markets.finfeedapi.com/v1/markets/POLYMARKET/active?limit=10" \
-H "[REDACTED CREDENTIAL]
Lệnh này trả về một danh sách thuần các mã thị trường, mỗi mã đã bao gồm kết quả của nó:
[
"WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_YES",
"WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_NO",
"NFL-PIT-CAR-2025-08-21-SPREAD-AWAY-5PT5_YES"
]
3. Lấy giao dịch và báo giá mới nhất
curl -X GET \
"https://api.prediction-markets.finfeedapi.com/v1/activity/POLYMARKET/WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_YES/current" \
-H "[REDACTED CREDENTIAL]_API_KEY"
Phản hồi cung cấp cho bạn giao dịch mới nhất cùng giá chào mua và chào bán mới nhất cho kết quả đó.
4. Kéo dữ liệu OHLCV lịch sử bằng Python
Đây là lệnh gọi mà tôi sẽ dùng đầu tiên khi xây dựng một biểu đồ xác suất hoặc một bài backtest.
import requests
[REDACTED CREDENTIAL]
BASE = "https://api.prediction-markets.finfeedapi.com/v1"
headers = {"Authorization": API_KEY}
market_id = "WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_YES"
resp = requests.get(
f"{BASE}/ohlcv/POLYMARKET/{market_id}/history",
headers=headers,
params={"period_id": "1DAY", "limit": 30},
)
resp.raise_for_status()
for candle in resp.json():
print(candle["time_period_start"], candle["price_close"], candle["volume_traded"])
Mỗi nến bao gồm time_period_start, time_period_end, price_open, price_high, price_low, price_close, volume_traded và trades_count. Gọi /ohlcv/periods để xem mọi period_id được hỗ trợ.
5. Kiểm tra độ sâu sổ lệnh
curl -X GET \
"https://api.prediction-markets.finfeedapi.com/v1/orderbook/POLYMARKET/WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_YES/current" \
-H "[REDACTED CREDENTIAL]
Ảnh chụp nhanh trả về exchange_id, market_id, time_exchange, time_coinapi, cùng các mảng bids và asks. Như vậy là đủ để tính chênh lệch giá và mất cân bằng ở đầu sổ lệnh.
Nếu bạn không muốn tự viết HTTP thô, API Bricks có phát hành các SDK chính thức (Python, Node.js, Go, C# và nhiều ngôn ngữ khác) trong kho SDK trên GitHub của mình.
Ngoài REST: MCP, JSON-RPC và Flat Files
Mọi giao diện đều phơi bày cùng các tập dữ liệu được chuẩn hóa. Bạn chọn cái phù hợp với kiến trúc của mình.
| Giao diện | Header xác thực | Phù hợp nhất cho |
|---|---|---|
| REST API | Authorization |
Dashboard, phân tích, ứng dụng production |
| JSON-RPC API | Authorization |
Các dịch vụ thích gọi kiểu RPC hơn là dùng cùng dữ liệu |
| Máy chủ MCP được host | X-APIKey |
Trợ lý AI, agent lập trình, quy trình nghiên cứu |
| Flat Files (S3) | Thông tin xác thực tương thích S3 | Lịch sử khối lượng lớn cho backtesting và machine learning |
Máy chủ MCP là điểm nổi bật
Theo góc nhìn của tôi, đây là phần có tầm nhìn xa nhất của sản phẩm. Thay vì dạy cho agent tài liệu API của bạn, bạn chỉ cần trỏ nó tới một endpoint MCP được host và nó sẽ tự khám phá các công cụ.
Việc thiết lập chỉ gồm vài dòng cấu hình trong Cursor, Claude Desktop, hoặc bất kỳ client hỗ trợ MCP nào:
{
"mcpServers": {
"FinFeedAPI-Prediction-Markets": {
"url": "https://api.prediction-markets.finfeedapi.com/mcp",
"headers": {
[REDACTED CREDENTIAL]
}
}
}
}
Máy chủ hiện phơi bày các công cụ cho:
-
Khám phá sàn:
exchanges_list,exchanges_get -
Khám phá thị trường:
markets_get_active,markets_get_history -
Hoạt động trực tiếp:
activity_get_current,activity_get_latest -
Giao dịch và báo giá lịch sử:
activity_get_trades_history,activity_get_quotes_history -
OHLCV:
ohlcv_list_periods,ohlcv_get_latest_market,ohlcv_get_history_market,ohlcv_get_history_exchange -
Sổ lệnh:
orderbook_get_current,orderbook_get_history
Điều đó có nghĩa là bạn có thể hỏi một agent điều gì đó như "tìm những thị trường Kalshi đang hoạt động sôi nổi nhất và cho tôi xem tỷ lệ cược của chúng đã thay đổi thế nào trong tuần này" và nó có thể tự mình chuỗi các lệnh gọi khám phá, hoạt động và OHLCV lại với nhau.
Một lưu ý nếu bạn thiết lập kết nối MCP FinFeedAPI cũ hơn: endpoint đã chuyển từ /sse sang /mcp, nên các cấu hình cũ cần được cập nhật.
Flat Files cho lịch sử nặng
Đối với nghiên cứu quy mô lớn, việc kéo dữ liệu nhiều năm qua các lệnh gọi REST phân trang sẽ rất chậm. Flat Files cung cấp cho bạn giao dịch, báo giá, sổ lệnh và OHLCV dạng khối lượng lớn thông qua một API tương thích S3, để bạn có thể dùng chính những công cụ và SDK S3 mà bạn đã quen thuộc.
Giá cả
FinFeedAPI sử dụng mô hình giá theo mức sử dụng dựa trên tín dụng. Bạn bắt đầu với tín dụng miễn phí, sau đó trả tiền theo từng yêu cầu.
Ở gói Pay As You Go, 1.000 yêu cầu đầu tiên mỗi ngày có giá $5 cho mỗi 1.000, và bất cứ thứ gì vượt quá 1.000 mỗi ngày sẽ giảm xuống còn $1 cho mỗi 1.000. Các gói cam kết sẽ hạ mức giá đó xuống thấp hơn.
| Gói | Hàng tháng | Giá mỗi tín dụng | Các ưu đãi đáng chú ý |
|---|---|---|---|
| Pay As You Go | Không ràng buộc | $1.00 | Hỗ trợ qua AI và email, tự phục vụ onboarding |
| Committed 64 | $64 | $0.85 | Onboarding có hỗ trợ AI |
| Committed 256 | $256 | $0.75 | Onboarding có hỗ trợ AI |
| Committed 512 | $512 | $0.70 | Hỗ trợ qua Slack, kênh Slack riêng |
| Committed 1024 | $1,024 | $0.65 | SLA uptime 99,9%, chuyên viên customer success, onboarding do con người thực hiện |
| Enterprise | Tùy chỉnh | Tùy chỉnh | SLA tùy chỉnh, tối ưu độ trễ, hạ tầng riêng |
Các gói cam kết không làm giảm lượng bạn sử dụng. Chúng cho bạn nhiều tín dụng hơn với cùng mức chi tiêu, và khi số tín dụng đó cạn, phần sử dụng thêm sẽ được tính theo giá Pay As You Go. Thanh toán theo năm cũng có sẵn.
Quan điểm của tôi: với nguyên mẫu và nghiên cứu, Pay As You Go là ổn. Nếu bạn đang polling nhiều thị trường vài giây một lần, hãy tính toán trước. FinFeedAPI có công bố các trường hợp sử dụng giá cho dashboard, giám sát sổ lệnh và backfill OHLCV, giúp việc ước tính dễ dàng hơn nhiều.
FinFeedAPI còn thiếu sót ở đâu
Không có API nào hoàn hảo, và một bài đánh giá bỏ qua các đánh đổi thì chẳng có ích gì. Đây là những điều cần ghi nhớ:
- Không có khớp lệnh. Đây chỉ là một lớp dữ liệu. Bot giao dịch vẫn cần API gốc của sàn để đặt lệnh.
- Không có luồng WebSocket cho thị trường dự đoán. Dữ liệu hiện tại đến qua các lệnh gọi request-response, nên "trực tiếp" có nghĩa là polling. Với các chiến lược nhạy cảm với độ trễ, đó là một hạn chế thật sự, và việc polling thường xuyên sẽ làm tăng hóa đơn của bạn.
- 1.000 yêu cầu đầu tiên mỗi ngày là đắt nhất. Ở mức $5 cho mỗi 1.000 so với $1 cho mỗi 1.000 sau đó, những dự án rất nhỏ phải trả mức giá hiệu dụng cao hơn những dự án bận rộn.
- Dữ liệu giải quyết phụ thuộc vào nguồn. Thông tin vòng đời và giải quyết chỉ đầy đủ bằng những gì mà mỗi sàn phơi bày.
- Việc chuẩn hóa là một sự đánh đổi. Schema thống nhất chính là mục đích, nhưng nếu bạn phụ thuộc vào một trường riêng của một sàn nào đó, hãy kiểm tra các mẫu dữ liệu trước khi cam kết.
Không có điểm nào trong số này là trở ngại chết người đối với các trường hợp sử dụng phân tích, nghiên cứu hay AI. Chúng quan trọng nhất nếu bạn đang xây dựng một hệ thống giao dịch tần suất cao.
Ai nên dùng FinFeedAPI?
Điểm mạnh
- Chín sàn thị trường dự đoán dưới một schema duy nhất
- Toàn bộ vòng đời thị trường: khám phá, giao dịch, báo giá, sổ lệnh, OHLCV, lịch sử
- Dữ liệu sổ lệnh lịch sử ở mức sự kiện để phát lại
- Máy chủ MCP được host hoạt động với Cursor và Claude Desktop
- Flat Files khối lượng lớn cho nghiên cứu và machine learning
- Giá theo mức sử dụng với tín dụng miễn phí để bắt đầu
Phù hợp nhất cho
- Dashboard đa sàn so sánh tỷ lệ cược giữa các sàn
- Nhà nghiên cứu định lượng và chuyên viên phân tích backtest các chiến lược thị trường dự đoán
- Đội ngũ dự báo và ML cần dữ liệu OHLCV lịch sử sạch
- Phân tích thanh khoản dựa trên độ sâu sổ lệnh và chênh lệch giá
- Đội ngũ AI xây dựng các agent lập luận về các sự kiện thực tế
- Nghiên cứu học thuật và kinh tế về cách đám đông định giá các kết quả
Có lẽ không phù hợp cho
- Các bot cần đặt lệnh
- Các chiến lược cần một luồng đẩy, dưới một giây
Suy nghĩ cuối cùng
Các thị trường dự đoán đang tăng trưởng nhanh hơn khả năng tích hợp của hầu hết các đội ngũ. Mỗi sàn mới mang đến những mã định danh mới, định dạng mới và công việc bảo trì mới.
FinFeedAPI không cố gắng trở thành một sàn giao dịch. Nó tập trung vào một việc duy nhất: biến chín sàn phân mảnh thành một lớp dữ liệu nhất quán. Thị trường, giao dịch, báo giá, sổ lệnh, OHLCV và lịch sử sâu đều được trả về với cùng một hình dạng, thông qua REST, JSON-RPC, MCP hoặc Flat Files.
Hãy bước vào với hiểu biết rằng nó chỉ đọc và theo kiểu request-response, và nó phù hợp với rất nhiều sản phẩm, từ dashboard dự báo cho tới các agent nghiên cứu AI.
Chín sàn. Một schema. Một API key. Ít việc nối hệ thống hơn, nhiều việc xây dựng hơn.
Website: finfeedapi.com/products/prediction-markets-api
Tài liệu API: Tài liệu REST API của Prediction Markets






Top comments (0)