Rihpig

Posted on Nov 3 Originally published at apidog.com

FinFeedAPI 리뷰: 멀티 거래소 예측 시장 데이터 API

Kalshi, Polymarket, ForecastEx 전반에서 단일 경제 이벤트를 시장이 어떻게 가격에 반영하는지 추적하고 싶다고 상상해 보세요. 서류상으로는 간단한 대시보드처럼 들립니다. 실제로는 서로 다른 세 개의 API, 동일한 시장을 식별하는 세 가지 방식, 그리고 차트 하나를 그리기 전에 조정해야 하는 세 가지 응답 형식을 의미합니다.

지금 Apidog을 사용해 보세요

이 문제는 새로운 거래소가 생길 때마다 커집니다. 예측 시장은 이제 규제를 받는 미국 거래소, 온체인 프로토콜, 플레이 머니 커뮤니티, 그리고 기존 암호화폐 플랫폼의 이벤트 계약에 이르기까지 폭넓게 걸쳐 있으며, 이들 중 어느 것도 공통 데이터 모델을 공유하지 않습니다.

바로 이 간극을 메우기 위해 FinFeedAPI가 만들어졌습니다. 이 제품의 Prediction Markets API는 아홉 개 거래소를 하나의 표준화된 스키마 아래로 모아, 개발자가 데이터 출처와 관계없이 시장, 거래, 주문장, 이력을 동일한 방식으로 조회할 수 있게 합니다.

개발자 입장에서 이러한 성장에는 지저분한 진실이 따릅니다. 모든 거래소는 자체 API, 자체 시장 식별자, 자체 명명 규칙, 그리고 '시장'이란 무엇인지에 대한 자체 정의까지 노출합니다. 세 플랫폼에서 동일한 이벤트를 추적하는 대시보드를 원하시나요? 그러면 세 개의 통합, 세 개의 데이터 모델, 세 세트의 예외 사례를 유지해야 합니다.

바로 이것이 FinFeedAPI가 해결하려는 문제입니다.

이 리뷰에서는 FinFeedAPI의 Prediction Markets API가 무엇을 다루는지, 실제로 어떤 데이터를 얻을 수 있는지, 엔드포인트가 실제로 어떻게 생겼는지, 비용은 얼마인지, 그리고 어디가 부족한지 살펴보겠습니다. 이를 통해 이것이 여러분의 스택에 맞는지 판단할 수 있을 것입니다.

요약

항목	내용
제공업체	API Bricks(CoinAPI를 만든 회사이기도 함)의 FinFeedAPI
지원 거래소	9개 예측 시장 거래소
데이터	시장 및 메타데이터, 거래, 호가, 주문장, OHLCV, 과거 플랫 파일
접근 방식	REST, JSON-RPC, 호스팅된 MCP 서버, Flat Files(S3)
모드	읽기 전용 시장 데이터, 요청-응답 방식(WebSocket 스트림 없음)
가격	시작 시 무료 크레딧, 이후 1,000회 요청당 $1부터 사용량 기반
적합 대상	거래소 간 대시보드, 리서치, 백테스팅, AI 에이전트

FinFeedAPI란 무엇인가?

FinFeedAPI는 CoinAPI를 만든 것과 같은 회사인 API Bricks가 만든 금융 데이터 제공업체입니다. Stock, Currencies, SEC API와 함께, 하나의 통합을 통해 아홉 개 예측 시장 거래소의 시장 데이터에 표준화된 방식으로 접근할 수 있게 해주는 Prediction Markets API를 제공합니다.

아이디어는 간단합니다. 아홉 개 API를 배우는 대신 하나를 배우면 됩니다. 시장 ID, 결과, 타임스탬프, 응답 구조는 데이터가 어느 거래소에서 왔든 동일한 스키마를 따릅니다.

문서를 살펴보면서 몇 가지 엔지니어링 세부 사항이 눈에 띄었습니다:

모든 지원 거래소에 걸친 통합 데이터 모델
결과를 포함하는 표준화된 시장 ID, 예: ..._YES 및 ..._NO
모든 엔드포인트의 ISO 8601 UTC 타임스탬프
최대 19자리, 소수점 9자리까지 일관된 숫자 정밀도
네 가지 접근 방식: REST, JSON-RPC, 호스팅된 MCP 서버, Flat Files

미리 분명히 해둘 점이 하나 있습니다: FinFeedAPI는 읽기 전용 시장 데이터 계층입니다. 주문을 넣지 않습니다. 제품에 실행 기능이 필요하다면, 그 부분은 여전히 각 거래소의 네이티브 API를 사용해야 합니다.

지원되는 예측 시장 플랫폼

FinFeedAPI는 현재 규제 거래소, 탈중앙화 프로토콜, 온체인 결과 시장, 플레이 머니 커뮤니티에 걸쳐 아홉 개 거래소를 지원합니다.

플랫폼	유형	다루는 내용
Polymarket	탈중앙화	정치, 경제, 암호화폐, 스포츠, 글로벌 이벤트
Kalshi	규제 대상(CFTC)	경제 지표, 선거, 날씨, 스포츠 등에 대한 미국 이벤트 계약
ForecastEx	규제 대상(CFTC)	경제 및 금융 결과를 포함한 미국 이벤트 계약
Gemini Prediction Markets	규제 대상	스포츠, 암호화폐, 경제, 정치 및 기타 주제에 대한 이벤트 계약
Crypto.com Prediction Markets	규제 대상	Crypto.com의 예측 시장 플랫폼에 대한 이벤트 기반 계약
Myriad	탈중앙화	암호화폐, 시사 이슈 및 기타 결과
Pascal	탈중앙화	Solana 기반 비수탁형 예측 시장
Hyperliquid Outcome Markets (HIP-4)	온체인 결과 시장	Hyperliquid의 네이티브 인프라상 바이너리 및 다중 결과 이벤트 계약
Manifold Markets	소셜, 플레이 머니	다양한 주제에 대한 커뮤니티 주도 시장

이 조합이 흥미로운 이유입니다. 규제 거래소, 암호화폐 네이티브 거래소, 플레이 머니 군중이 동일한 이벤트를 어떻게 가격에 반영하는지 비교하는 것이 거래소 간 리서치가 가치를 갖는 지점입니다. 또한 정규화된 스키마가 가장 많은 시간을 절약해 주는 지점이기도 합니다.

어떤 데이터에 접근할 수 있나요?

FinFeedAPI가 존재 가치를 발휘하는 부분이 바로 여기입니다. 대부분의 예측 시장 도구는 최신 가격에서 멈춥니다. FinFeedAPI는 탐색부터 주문장 깊이와 이력에 이르기까지 전체 시장을 노출합니다.

모든 REST 엔드포인트는 https://api.prediction-markets.finfeedapi.com/v1 아래에 있습니다.

데이터셋	엔드포인트	얻는 것
거래소	`GET /exchanges` 및 `/exchanges/{exchange_id}`	지원 거래소, 거래소 ID, 설명, 웹사이트
활성 시장	`GET /markets/{exchange_id}/active`	현재 활성 시장 ID의 간결한 목록
시장 목록	`GET /markets/{exchange_id}/history`	커서 기반 페이지네이션이 있는 전체 시장 레코드: 제목, 설명, 결과, 가격, 상태
단일 시장	`GET /markets/{exchange_id}/{market_id}`	한 시장의 메타데이터
현재 활동	`GET /activity/{exchange_id}/{market_id}/current`	최신 거래와 최신 매수·매도 호가
최근 활동	`GET /activity/{exchange_id}/{market_id}/latest`	최근 거래 및 호가 업데이트
과거 거래 및 호가	`GET /activity/{exchange_id}/{market_id}/history/trades` 및 `/history/quotes`	플랫 파일에서 제공되는 과거 레코드
현재 주문장	`GET /orderbook/{exchange_id}/{market_id}/current`	시장 결과에 대한 매수 및 매도 호가
과거 주문장	`GET /orderbook/{exchange_id}/{market_id}/history`	주문장 재구성을 위한 원시 지정가 주문 이벤트(추가, 업데이트, 삭제)
OHLCV	`GET /ohlcv/periods`, `/ohlcv/{exchange_id}/{market_id}/history`, `/latest`, `/ohlcv/{exchange_id}/history`	시가, 고가, 저가, 종가, 거래량, 거래 횟수가 포함된 캔들

몇 가지 알아둘 점:

탐색은 두 단계입니다. /active 엔드포인트는 최근 호가와 거래에서 파생되기 때문에 ID만 반환합니다. 전체 세부 정보는 /history 또는 단일 시장 엔드포인트를 호출하세요.
OHLCV 기간은 초부터 수년까지이며, 과거 캔들은 시간 오름차순으로 반환됩니다. 이는 백테스팅에 필요한 방식입니다.
과거 주문장 데이터는 단순 스냅샷이 아니라 이벤트 수준입니다. 이는 시장 리플레이와 유동성 리서치를 가능하게 합니다.
라이프사이클 및 해소 데이터는 open, closed, resolved, suspended 상태를 다루며, 소스 거래소가 지원하는 경우 해소 정보를 포함합니다.

시작하기: 첫 요청

온보딩은 빠릅니다. 무료 계정을 만들고 콘솔에서 API 키를 생성하면 무료 크레딧으로 시작할 수 있습니다.

REST 및 JSON-RPC의 경우 Authorization 헤더에 키를 전달합니다. 문서에서는 X-APIKey, X-APIBricks-Key, X-CoinAPI-Key도 허용합니다.

1. 지원 거래소 나열

다른 모든 곳에서 사용할 정확한 exchange_id 값을 얻으려면 여기서 시작하세요.

curl -X GET "https://api.prediction-markets.finfeedapi.com/v1/exchanges" \
  -H "[REDACTED CREDENTIAL]

2. 활성 시장 탐색

curl -X GET "https://api.prediction-markets.finfeedapi.com/v1/markets/POLYMARKET/active?limit=10" \
  -H "[REDACTED CREDENTIAL]

이것은 각 시장 ID에 결과가 포함된 단순 목록을 반환합니다:

[
  "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. 최신 거래 및 호가 가져오기

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]

응답은 해당 결과에 대한 최신 거래와 최신 매수·매도 호가를 제공합니다.

4. Python에서 과거 OHLCV 가져오기

확률 차트나 백테스트를 만들 때 가장 먼저 사용하게 될 호출입니다.

import requests

[REDACTED CREDENTIAL]
BASE = "https://api.prediction-markets.finfeedapi.com/v1"
headers = {[REDACTED CREDENTIAL]}

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"])

각 캔들에는 time_period_start, time_period_end, price_open, price_high, price_low, price_close, volume_traded, trades_count가 포함됩니다. 지원되는 모든 period_id를 보려면 /ohlcv/periods를 호출하세요.

5. 주문장 깊이 확인

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]

스냅샷은 exchange_id, market_id, time_exchange, time_coinapi와 함께 bids 및 asks 배열을 반환합니다. 이것만으로도 스프레드와 최우선 호가 불균형을 계산할 수 있습니다.

원시 HTTP를 직접 작성하고 싶지 않다면, API Bricks는 GitHub SDK 저장소에 공식 SDK(Python, Node.js, Go, C# 등)를 게시합니다.

REST를 넘어서: MCP, JSON-RPC, Flat Files

모든 인터페이스는 동일한 표준화 데이터셋을 노출합니다. 아키텍처에 맞는 것을 선택하면 됩니다.

인터페이스	인증 헤더	적합 대상
REST API	`Authorization`	대시보드, 분석, 프로덕션 앱
JSON-RPC API	`Authorization`	동일한 데이터에 대해 RPC 스타일 호출을 선호하는 서비스
호스팅된 MCP 서버	`X-APIKey`	AI 어시스턴트, 코딩 에이전트, 리서치 워크플로
Flat Files(S3)	S3 호환 자격 증명	백테스팅 및 머신러닝을 위한 대량 이력

MCP 서버가 돋보이는 부분

제 관점에서 이것은 제품에서 가장 미래지향적인 부분입니다. 에이전트에게 API 문서를 가르치는 대신, 호스팅된 MCP 엔드포인트를 가리키면 에이전트가 스스로 도구를 발견합니다.

설정은 Cursor, Claude Desktop 또는 MCP 지원 클라이언트에서 몇 줄의 구성만 필요합니다:

{
  "mcpServers": {
    "FinFeedAPI-Prediction-Markets": {
      "url": "https://api.prediction-markets.finfeedapi.com/mcp",
      "headers": {
        [REDACTED CREDENTIAL]
      }
    }
  }
}

현재 서버가 노출하는 도구는 다음과 같습니다:

거래소 탐색: exchanges_list, exchanges_get
시장 탐색: markets_get_active, markets_get_history
실시간 활동: activity_get_current, activity_get_latest
과거 거래 및 호가: activity_get_trades_history, activity_get_quotes_history
OHLCV: ohlcv_list_periods, ohlcv_get_latest_market, ohlcv_get_history_market, ohlcv_get_history_exchange
주문장: orderbook_get_current, orderbook_get_history

즉, 에이전트에게 '가장 활발한 Kalshi 시장을 찾고 이번 주에 그 확률이 어떻게 움직였는지 보여줘'와 같이 요청하면, 에이전트가 탐색, 활동, OHLCV 호출을 스스로 연결할 수 있습니다.

구버전 FinFeedAPI MCP 연결을 설정한 경우 한 가지 참고: 엔드포인트가 /sse에서 /mcp로 이동했으므로 오래된 구성은 업데이트해야 합니다.

대용량 이력을 위한 Flat Files

대규모 리서치에서는 페이지네이션된 REST 호출을 통해 수년치 데이터를 가져오는 것은 느립니다. Flat Files는 S3 호환 API를 통해 대량 거래, 호가, 주문장, OHLCV를 제공하므로 이미 알고 있는 S3 도구와 SDK를 사용할 수 있습니다.

가격

FinFeedAPI는 크레딧 기반의 사용량 기반 가격을 사용합니다. 무료 크레딧으로 시작한 뒤 요청당 비용을 지불합니다.

Pay As You Go에서는 처음 1,000회 요청/일의 비용이 1,000회당 $5이고, 하루 1,000회를 초과하는 요청은 1,000회당 $1로 내려갑니다. 약정 플랜은 이 요율을 더 낮춥니다.

플랜	월 비용	크레딧당 요율	주요 추가 혜택
Pay As You Go	약정 없음	$1.00	AI 및 이메일 지원, 셀프서비스 온보딩
Committed 64	$64	$0.85	AI 지원 온보딩
Committed 256	$256	$0.75	AI 지원 온보딩
Committed 512	$512	$0.70	Slack 지원, 전용 Slack 채널
Committed 1024	$1,024	$0.65	99.9% 업타임 SLA, 고객 성공 담당자, 휴먼 온보딩
엔터프라이즈	맞춤형	맞춤형	맞춤형 SLA, 지연 시간 최적화, 전용 인프라

약정 플랜은 사용량을 줄여주는 것이 아닙니다. 같은 지출로 더 많은 크레딧을 제공하며, 크레딧이 소진되면 추가 사용량은 Pay As You Go 요율로 청구됩니다. 연간 결제도 가능합니다.

제 의견은 다음과 같습니다. 프로토타입과 리서치에는 Pay As You Go로 충분합니다. 많은 시장을 몇 초마다 폴링한다면 먼저 계산해 보세요. FinFeedAPI는 대시보드, 주문장 모니터링, OHLCV 백필에 대한 가격 사용 사례를 게시하여 추정을 훨씬 쉽게 만듭니다.

FinFeedAPI가 부족한 부분

완벽한 API는 없으며, 트레이드오프를 건너뛴 리뷰는 별로 유용하지 않습니다. 염두에 둘 점은 다음과 같습니다:

주문 실행 없음. 데이터 계층일 뿐입니다. 트레이딩 봇은 주문을 넣기 위해 여전히 네이티브 거래소 API가 필요합니다.
예측 시장용 WebSocket 스트림 없음. 현재 데이터는 요청-응답 호출을 통해 제공되므로 '실시간'은 폴링을 의미합니다. 지연 시간에 민감한 전략에는 이는 실제 제약이며, 잦은 폴링은 청구서를 증가시킵니다.
일일 첫 1,000회 요청이 가장 비쌉니다. 1,000회당 $5 대 이후 1,000회당 $1이므로, 아주 작은 프로젝트는 바쁜 프로젝트보다 더 높은 실효 요율을 지불합니다.
해소 데이터는 소스에 따라 달라집니다. 라이프사이클 및 해소 세부 정보는 각 거래소가 노출하는 만큼만 완전합니다.
정규화는 트레이드오프입니다. 통합 스키마가 핵심이지만, 특정 거래소에 고유한 필드에 의존한다면 커밋하기 전에 데이터 샘플을 확인하세요.

이 중 어느 것도 분석, 리서치, AI 사용 사례에 치명적이지는 않습니다. 고빈도 트레이딩 시스템을 구축하는 경우에 가장 중요합니다.

누가 FinFeedAPI를 사용해야 하나요?

장점

하나의 스키마 뒤에 있는 아홉 개 예측 시장 거래소
전체 시장 라이프사이클: 탐색, 거래, 호가, 주문장, OHLCV, 이력
리플레이를 위한 이벤트 수준 과거 주문장 데이터
Cursor 및 Claude Desktop과 함께 작동하는 호스팅된 MCP 서버
리서치 및 머신러닝을 위한 대량 Flat Files
무료 크레딧으로 시작하는 사용량 기반 가격

적합 대상

거래소 간 확률을 비교하는 멀티 거래소 대시보드
예측 시장 전략을 백테스팅하는 퀀트 리서처 및 분석가
깨끗한 과거 OHLCV가 필요한 예측 및 ML 팀
주문장 깊이와 스프레드를 기반으로 하는 유동성 분석
실제 세계 이벤트에 대해 추론하는 에이전트를 만드는 AI 팀
군중이 결과를 어떻게 가격에 반영하는지에 대한 학술 및 경제 연구

아마 적합하지 않은 대상

주문을 넣어야 하는 봇
푸시 기반의 서브초 스트림이 필요한 전략

마지막 생각

예측 시장은 대부분의 팀이 통합할 수 있는 속도보다 빠르게 성장하고 있습니다. 새로운 거래소가 생길 때마다 새로운 식별자, 새로운 형식, 새로운 유지보수 작업이 생깁니다.

FinFeedAPI는 거래소가 되려고 하지 않습니다. 아홉 개의 파편화된 거래소를 하나의 일관된 데이터 계층으로 바꾸는 한 가지 작업에 집중합니다. 시장, 거래, 호가, 주문장, OHLCV, 깊은 이력이 모두 REST, JSON-RPC, MCP 또는 Flat Files를 통해 동일한 형태로 반환됩니다.

읽기 전용이고 요청-응답 방식이라는 점을 알고 접근하면, 예측 대시보드부터 AI 리서치 에이전트까지 폭넓은 제품에 적합합니다.

아홉 개 거래소. 하나의 스키마. 하나의 API 키. 배관 작업은 줄이고, 빌드는 더 많이.

웹사이트: finfeedapi.com/products/prediction-markets-api

API 문서: Prediction Markets REST API 문서

DEV Community