전체 문서 Nebula 문서 모든 엔드포인트 인터랙티브 문서 Markdown OpenAPI JSON
  1. REST API
  2. 기타

예측 시장

GET /predictions
ListPredictionMarkets

Polymarket 및 Kalshi 계약을 탐색합니다. 가격은 각 거래소의 결과 확률이며, 소셜 센티먼트가 아닙니다. 거래량은 거래소 단위를 유지합니다. 동등한 계약은 동일한 시장을 공유하며, 관련 계약은 별도로 유지됩니다. 주체 지표는 기존 subject 및 asset 엔드포인트를 사용합니다.

https://nebula-api.hiddensystems.ai/api/v1/x402/predictions에서 월렛 결제를 사용할 수 있습니다. Nebula 계정이나 API 키가 필요하지 않으며, 서명하기 전에 결제 제안을 확인하세요. x402 결제 가이드.

파라미터

query string QUERY

공개 식별자와 이름을 대상으로 하는 대소문자 구분 없는 검색입니다.

Example:NVIDIA

provider string QUERY

선택 사항: 거래소

허용 값
polymarketkalshi

Example:polymarket

status string QUERY

기본값: open

허용 값
openclosedresolveddisputedall

Default:open

subject_id string QUERY

/subjects 또는 /search가 반환하는 정규 비자산 식별자로, 예를 들어 text:jensen huang 또는 handle:elonmusk입니다. 대소문자를 구분하지 않고 허용됩니다. asset_id 또는 asset_class와 함께 사용할 수 없습니다.

Example:text:jensen huang

limit integer QUERY

반환되는 최대 결과 수.

Default:25

offset integer QUERY

페이지네이션 오프셋

Default:0

cURL 예제

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/predictions' \
  --header 'X-API-Key: YOUR_API_KEY'

응답

200 OK
400 잘못된 요청
401 인증되지 않음
402 크레딧이 모두 소진됨. 응답에 갱신 시점과 구매한 크레딧 잔액이 포함됩니다.
403 금지됨
404 찾을 수 없음
405 허용되지 않은 메서드입니다. Allow 헤더에 지원되는 메서드가 나열됩니다.
429 요청이 너무 많음
500 내부 서버 오류
503 서비스 이용 불가

미디어 타입 application/json

has_more
boolean 필수

반환된 레코드 뒤에 사용할 수 있는 페이지가 더 있으면 true입니다.

limit
integer 필수

요청된 최대 레코드 수입니다.

markets
array<object> 필수

각 거래소 내에서 최상의 활동 순위순으로 정렬된 정규 시장입니다. 거래소별 거래량은 합산되지 않습니다.
markets[].id
string 필수

이 객체 유형 내에서의 안정적인 식별자입니다.

markets[].listings
array<object> 필수

규칙과 호가가 각각 별도로 유지되는 거래소 상장 정보입니다.
markets[].listings[].closes_at
string (date-time) 필수

UTC 기준 거래소 거래 종료 시각입니다. 반드시 이벤트 발생 또는 결제 시각은 아닙니다.

markets[].listings[].event_id
string 필수

거래소 이벤트 식별자이며, 없으면 비어 있습니다.

markets[].listings[].id
string 필수

이 객체 유형 내에서의 안정적인 식별자입니다.

markets[].listings[].liquidity_usd
number (double) 필수

거래소가 보고한 유동성(미국 달러)이며, 사용할 수 없으면 null입니다.

markets[].listings[].market_id
string 필수

정규 시장 식별자이며, 동등한 거래소 상장 정보가 이를 공유합니다.

markets[].listings[].observed_at
string (date-time) 필수

Nebula가 이 호가를 가져온 UTC 시각입니다. 비교 전에 신선도를 확인하세요.

markets[].listings[].open_interest
number (double) 필수

거래소 미결제 계약 수이며, 사용할 수 없으면 null입니다.

markets[].listings[].opens_at
string (date-time) 필수

UTC 기준 거래소 개장 시각이며, 사용할 수 없으면 null입니다.

markets[].listings[].outcomes
array<object> 필수

독립적인 가격 증거가 있는 정렬된 네이티브 결과입니다.

markets[].listings[].provider
string 필수

거래소: polymarket 또는 kalshi입니다.

markets[].listings[].provider_id
string 필수

네이티브 거래소 시장 식별자입니다.

markets[].listings[].provider_updated_at
string (date-time) 필수

거래소 메타데이터 업데이트 시각이며, 사용할 수 없으면 null입니다.

markets[].listings[].question
string 필수

원래 계약 질문입니다.

markets[].listings[].resolution_source
string 필수

거래소 결제 소스이며, 없으면 비어 있습니다.

markets[].listings[].resolves_at
string (date-time) 필수

UTC 기준 거래소 예상 결제 시각이며, 사용할 수 없으면 null입니다.

markets[].listings[].result
string 필수

거래소 결제 결과이며, 알려진 결과가 있기 전에는 비어 있습니다.

markets[].listings[].revision
string 필수

질문, 규칙, 소스, 종료 시각 및 결과 방향의 SHA-256입니다.

markets[].listings[].rules
string 필수

전체 거래소 결제 규칙입니다.

markets[].listings[].source_url
string 필수

원래 거래소 상장 URL입니다.

markets[].listings[].status
string 필수

리스팅 수명 주기: open, closed, resolved 또는 disputed. 주체의 경우 resolved 또는 pending.

markets[].listings[].volume
number (double) 필수

volume_unit 단위의 누적 거래소 거래량이며, 사용할 수 없을 때는 null입니다.

markets[].listings[].volume_24h
number (double) 필수

volume_unit 단위의 최근 24시간 거래소 거래량이며, 사용할 수 없을 때는 null입니다.

markets[].listings[].volume_unit
string 필수

Polymarket은 usd, Kalshi는 contracts입니다. 이 수량은 서로 더할 수 없습니다.

markets[].question
string 필수

원래 계약 질문입니다.

markets[].subjects
array<object> 필수

연결된 주체입니다. 각각의 기존 분석 엔드포인트를 별도로 사용하세요. 시장 심리는 추론되지 않습니다.
markets[].subjects[].fallback_image_urls
array<string> 필수

백엔드에서 결정된 순서대로 정렬된 폴백 아이콘 후보입니다.

markets[].subjects[].image_url
string 필수

백엔드에서 결정된 첫 번째 주체 아이콘 후보이며, 비어 있으면 폴백을 사용합니다.

markets[].subjects[].name
string 필수

정규 주체 표시 이름입니다.

markets[].subjects[].role
string 필수

질문 첨부 역할: entity, topic 또는 place.

markets[].subjects[].status
string 필수

리스팅 수명 주기: open, closed, resolved 또는 disputed. 주체의 경우 resolved 또는 pending.

markets[].subjects[].subject_id
string 필수

정규 레지스트리 주체 식별자이며, 기존 자산 또는 주제 자격을 유지합니다.

markets[].subjects[].types
array<string> 필수

기존 ID 리졸버의 정규 주체 유형입니다.

offset
integer 필수

건너뛴 일치 레코드 수입니다.

{
  "has_more": false,
  "limit": 50,
  "markets": [
    {
      "id": "polymarket:123",
      "listings": [
        {
          "closes_at": "2026-10-07T20:00:00Z",
          "event_id": "event-123",
          "id": "polymarket:123",
          "liquidity_usd": 5000,
          "market_id": "polymarket:123",
          "observed_at": "2026-10-06T12:00:00Z",
          "open_interest": 100,
          "opens_at": "2026-10-01T00:00:00Z",
          "outcomes": [],
          "provider": "polymarket",
          "provider_id": "123",
          "provider_updated_at": "2026-10-06T12:00:00Z",
          "question": "Will NVIDIA close above $200 on October 7?",
          "resolution_source": "Official exchange close",
          "resolves_at": "2026-10-08T00:00:00Z",
          "result": "yes",
          "revision": "revision-hash",
          "rules": "Resolves Yes if the official closing price exceeds $200.",
          "source_url": "https://polymarket.com/event/example",
          "status": "open",
          "volume": 10000,
          "volume_24h": 1000,
          "volume_unit": "usd"
        }
      ],
      "question": "Will NVIDIA close above $200 on October 7?",
      "subjects": [
        {
          "fallback_image_urls": [],
          "image_url": "https://example.com/nvda.png",
          "name": "NVIDIA",
          "role": "entity",
          "status": "open",
          "subject_id": "eq:NVDA",
          "types": []
        }
      ]
    }
  ],
  "offset": 0
}