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

예측 시장 상세

GET /predictions/market
GetPredictionMarket

계약 규칙, 결과, 거래소 관측값 및 연결된 주체입니다. 대기 중인 주체는 기존 리졸버를 기다립니다. 결합된 시장 심리는 추론되지 않습니다.

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

파라미터

market_id string QUERY 필수

/predictions의 안정적인 시장 또는 리스팅 ID

Example:polymarket:123

cURL 예제

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/predictions/market' \
  --data-urlencode 'market_id=polymarket:123' \
  --header 'X-API-Key: YOUR_API_KEY'

응답

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

미디어 타입 application/json

id
string 필수

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

listings
array<object> 필수

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

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

listings[].event_id
string 필수

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

listings[].id
string 필수

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

listings[].liquidity_usd
number (double) 필수

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

listings[].market_id
string 필수

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

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

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

listings[].open_interest
number (double) 필수

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

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

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

listings[].outcomes
array<object> 필수

독립적인 가격 증거가 있는 정렬된 네이티브 결과입니다.
listings[].outcomes[].ask
number (double) 필수

0에서 1 사이의 분수로 표현한 거래소 매도 호가이며, 사용할 수 없으면 null입니다.

listings[].outcomes[].bid
number (double) 필수

0에서 1 사이의 분수로 표현한 거래소 매수 호가이며, 사용할 수 없으면 null입니다.

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

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

listings[].outcomes[].label
string 필수

거래소 결과 레이블입니다.

listings[].outcomes[].position
integer 필수

0부터 시작하는 네이티브 결과 위치입니다.

listings[].outcomes[].price
number (double) 필수

0에서 1 사이의 분수로 표현한 결과 호가이며, 사용할 수 없으면 null입니다. 주체 센티먼트가 아닙니다.

listings[].outcomes[].price_basis
string 필수

provider, last_trade, midpoint 또는 unavailable입니다.

listings[].provider
string 필수

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

listings[].provider_id
string 필수

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

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

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

listings[].question
string 필수

원래 계약 질문입니다.

listings[].resolution_source
string 필수

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

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

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

listings[].result
string 필수

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

listings[].revision
string 필수

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

listings[].rules
string 필수

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

listings[].source_url
string 필수

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

listings[].status
string 필수

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

listings[].volume
number (double) 필수

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

listings[].volume_24h
number (double) 필수

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

listings[].volume_unit
string 필수

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

question
string 필수

원래 계약 질문입니다.

subjects
array<object> 필수

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

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

subjects[].image_url
string 필수

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

subjects[].name
string 필수

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

subjects[].role
string 필수

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

subjects[].status
string 필수

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

subjects[].subject_id
string 필수

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

subjects[].types
array<string> 필수

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

{
  "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": [
        {
          "ask": 0.66,
          "bid": 0.64,
          "id": "polymarket:123",
          "label": "Yes",
          "position": 0,
          "price": 0.65,
          "price_basis": "provider"
        }
      ],
      "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": [
        "string"
      ],
      "image_url": "https://example.com/nvda.png",
      "name": "NVIDIA",
      "role": "entity",
      "status": "open",
      "subject_id": "eq:NVDA",
      "types": [
        "string"
      ]
    }
  ]
}