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

마인드셰어 예측

GET /forecasts/mindshare
GetMindshareForecast

향후 72시간 동안 자산의 마인드셰어가 어디에 있을지 가능성과 함께 결과 범위로 나타낸 것입니다. series은 4시간마다의 분포를 제공하고, chance_higher_72h와 likely_low_share에서 likely_high_share는 결과가 어디에 위치하는지 요약하며, takeoff_chance_72h는 관심이 급증할 가능성입니다.

예측은 자산에 관한 새 게시물이 올라오면 1분 이내에, 그리고 최소 15분마다 갱신됩니다. refresh=true은 최신 데이터로 약 5초 만에 재계산합니다. 20초를 넘으면 refreshed: false와 함께 최신 예측을 받게 되며, 5크레딧이 청구됩니다. 예측이 없는 자산은 reason와 함께 status: not_forecastable을 반환합니다. 예측이 있는 자산은 /forecasts/assets에서 확인할 수 있습니다.

5크레딧이 들며, refresh=true을 사용하면 10크레딧입니다. not_forecastable 응답은 무료이며 계정당 시간당 최대 30건까지 가능합니다. 이를 초과하면 이 엔드포인트는 해당 시간이 지날 때까지 429를 반환합니다.

이 작업에는 지갑 결제를 사용할 수 없습니다. 계정 인증을 사용하세요. x402 결제 가이드.

파라미터

asset_id string QUERY 필수

/assets 또는 /search에서 가져온 자산 ID입니다(예: NVDA, GLD, SPX, bitcoin). 함께 반환된 asset_class와 같이 보내세요.

Example:NVDA

asset_class string QUERY 필수

asset_id로 지정된 자산의 클래스입니다: equity(주식 및 ETF), commodity, index, crypto 중 하나입니다. /assets 또는 /search가 asset_id와 함께 반환한 asset_class를 보내세요.

허용 값
equitycommodityindexcrypto

Example:equity

refresh boolean QUERY

true이면 최신 데이터로 예측을 재계산합니다. 10크레딧, 약 5초가 소요됩니다. 기본값은 false입니다.

Example:false

cURL 예제

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/forecasts/mindshare' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'

응답

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

미디어 타입 application/json

as_of
string (date-time) 필수

예측 시작 시각(UTC)으로, 계산에 사용된 마지막 완전한 15분 구간의 끝입니다. 자산이 한 번도 채점된 적이 없으면 null입니다.

chance_higher_72h
number (double) 필수

72시간 후 주가가 current_share보다 높을 확률이며, 0에서 1 사이의 값입니다.

current_share
number (double) 필수

as_of 시점의 자산 점유율로, 0에서 1 사이의 값입니다. 모든 경로가 시작하는 지점이며, 확률을 측정하는 기준값입니다.

horizon_hours
integer 필수

예측이 얼마나 앞을 내다보는지(시간 단위)이며, 항상 72입니다.

likely_high_share
number (double) 필수

72시간 후 점유율의 90번째 백분위수로, 90% 확률로 이 값 아래에서 마감합니다.

likely_low_share
number (double) 필수

72시간 후 점유율의 10번째 백분위수로, 90% 확률로 이 값 위에서 마감합니다.

reason
string 필수

자산을 예측할 수 없는 이유로, too_little_history, stale_data, missing_price 중 하나입니다. status가 ok이면 null입니다.

허용 값
too_little_historystale_datamissing_pricenull
refreshed
boolean 필수

이 요청이 예측을 다시 실행한 경우(refresh=true이고 재실행이 제때 완료된 경우) true이며, 5분마다 예약 실행된 최신 예측이면 false입니다.

sample_paths
array<array<number (double)>> 필수

점유율에 대한 24개의 가능한 경로로, 각각 series와 정렬됩니다. 이를 그려서 결과의 분포를 확인하세요.

series
array<object> 필수

as_of부터 4시간마다의 예측 분포로, 18개 스텝이며 가장 오래된 것부터 정렬됩니다.
series[].mean_share
number (double) 필수

이 스텝에서의 예상 점유율입니다.

series[].p10_share
number (double) 필수

이 스텝에서 점유율의 10번째 백분위수로, 0에서 1 사이의 값입니다.

series[].p25_share
number (double) 필수

이 스텝에서 점유율의 25번째 백분위수로, 0에서 1 사이의 값입니다.

series[].p50_share
number (double) 필수

이 스텝에서 점유율의 50번째 백분위수로, 0에서 1 사이의 값입니다.

series[].p75_share
number (double) 필수

이 스텝에서 점유율의 75번째 백분위수로, 0에서 1 사이의 값입니다.

series[].p90_share
number (double) 필수

이 스텝에서 점유율의 90번째 백분위수로, 0에서 1 사이의 값입니다.

series[].quantile_shares
array<number (double)> 필수

이 스텝에서 점유율의 21개 분위수로, 0번째, 5번째, 10번째, ... 100번째 백분위수이며 가장 낮은 것부터 정렬됩니다. 임의 범위에 속할 확률을 구하려면 이들 사이를 보간하세요.

series[].timestamp
string (date-time) 필수

이 스텝이 예측하는 UTC 시각으로, as_of에 4, 8, ... 72시간을 더한 값입니다.

status
string 필수

ok이거나, 자산을 예측할 수 없을 때는 not_forecastable입니다(이 경우 요약 필드는 null이고 series는 비어 있으며, reason이 그 이유를 나타냅니다).

허용 값
oknot_forecastable
takeoff_chance_72h
number (double) 필수

72시간 이내에 자산에 대한 관심이 급증할 확률로, 0에서 1 사이의 값입니다. 추정치가 없으면 null입니다.

{
  "as_of": "2026-09-14T09:15:00Z",
  "chance_higher_72h": 0.63,
  "current_share": 0.0498,
  "horizon_hours": 72,
  "likely_high_share": 0.1022,
  "likely_low_share": 0.0331,
  "reason": null,
  "refreshed": false,
  "sample_paths": [
    [
      0.0502,
      0.0515,
      0.0531
    ],
    [
      0.0494,
      0.0488,
      0.0479
    ]
  ],
  "series": [
    {
      "mean_share": 0.0512,
      "p10_share": 0.039936000000000006,
      "p25_share": 0.045568000000000004,
      "p50_share": 0.050176,
      "p75_share": 0.055296000000000005,
      "p90_share": 0.063488,
      "quantile_shares": [
        0.0301,
        0.0352,
        0.0391,
        0.0418,
        0.0437,
        0.0451,
        0.0463,
        0.0474,
        0.0484,
        0.0493,
        0.0502,
        0.0511,
        0.0521,
        0.0532,
        0.0544,
        0.0557,
        0.0573,
        0.0594,
        0.0623,
        0.0671,
        0.0889
      ],
      "timestamp": "2026-09-14T13:15:00Z"
    },
    {
      "mean_share": 0.0523,
      "p10_share": 0.040794000000000004,
      "p25_share": 0.046547,
      "p50_share": 0.051254,
      "p75_share": 0.056484,
      "p90_share": 0.06485199999999999,
      "quantile_shares": [
        0.0301,
        0.0352,
        0.0391,
        0.0418,
        0.0437,
        0.0451,
        0.0463,
        0.0474,
        0.0484,
        0.0493,
        0.0502,
        0.0511,
        0.0521,
        0.0532,
        0.0544,
        0.0557,
        0.0573,
        0.0594,
        0.0623,
        0.0671,
        0.0889
      ],
      "timestamp": "2026-09-14T17:15:00Z"
    },
    {
      "mean_share": 0.0534,
      "p10_share": 0.041652,
      "p25_share": 0.047526000000000006,
      "p50_share": 0.052332000000000004,
      "p75_share": 0.05767200000000001,
      "p90_share": 0.066216,
      "quantile_shares": [
        0.0301,
        0.0352,
        0.0391,
        0.0418,
        0.0437,
        0.0451,
        0.0463,
        0.0474,
        0.0484,
        0.0493,
        0.0502,
        0.0511,
        0.0521,
        0.0532,
        0.0544,
        0.0557,
        0.0573,
        0.0594,
        0.0623,
        0.0671,
        0.0889
      ],
      "timestamp": "2026-09-14T21:15:00Z"
    }
  ],
  "status": "ok",
  "takeoff_chance_72h": 0.21
}