所有文件 Nebula 文件所有端點互動式文件 Markdown OpenAPI JSON

REST API
預測

可預測資產

GET /forecasts/assets

ListForecastAssets

目前有預測的所有資產。此清單涵蓋 /forecasts/mindshare 與 /forecasts/sentiment，兩者預測相同的資產：將資產的 asset_id 與 asset_class 傳給任一端點即可。股票、大宗商品與指數排在前面，接著是加密貨幣，並依討論熱度由高至低排序。此清單每五分鐘更新一次。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/forecasts/assets 付款。不需要 Nebula 帳號或 API 金鑰；簽署前請先確認付款條件。x402 付款指南。

參數

asset_class string QUERY

將清單限制為單一類別：equity（股票與 ETF）、commodity、index 或 crypto。

允許的值

equitycommodityindexcrypto

Example:equity

limit integer QUERY

傳回的結果數量上限。

Default:100

offset integer QUERY

略過的結果數量。

Default:0

cURL 範例

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

回應

200 OK

400 錯誤的要求

401 未經授權

402 額度已用完；回應會包含續約時間與已購買的額度餘額

403 禁止

404 找不到

405 不允許的方法；Allow 標頭會列出支援的方法

429 要求過多

500 內部伺服器錯誤

503 服務無法使用

媒體類型 application/json

assets

array<object> 必填

目前有預測的資產：股票、大宗商品與指數排在前面，接著是加密貨幣；各類別內依討論熱度由高至低排序。

assets[].as_of

string (date-time) 必填

該資產目前預測的 UTC 起始時間：即用來計算的最後一個完整 15 分鐘區間的結束時間。

assets[].asset_class

string 必填

資產的類別：equity（股票與 ETF）、commodity、index 或 crypto。請在每個以資產為範圍的要求中，與 asset_id 一併送出。

允許的值

equitycommodityindexcrypto

assets[].asset_id

string 必填

標準的公開資產識別碼：股票、商品與指數為 ticker 或市場代號，crypto 則為 CoinGecko slug（若無 slug，則為數字 id）。

assets[].name

string 必填

人類可讀的名稱。

assets[].symbol

string 必填

顯示用的 ticker 或市場代號。

has_more

boolean 必填

若傳回的記錄之後還有其他頁面可用，則為 true。

limit

integer 必填

要求的記錄數上限。

offset

integer 必填

略過的相符記錄數。

total

integer 必填

跨所有頁面符合要求的資產數量。

{
  "assets": [
    {
      "as_of": "2026-09-14T14:15:00Z",
      "asset_class": "equity",
      "asset_id": "NVDA",
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "as_of": "2026-09-14T14:15:00Z",
      "asset_class": "equity",
      "asset_id": "TSLA",
      "name": "Tesla, Inc.",
      "symbol": "TSLA"
    },
    {
      "as_of": "2026-09-14T14:15:00Z",
      "asset_class": "equity",
      "asset_id": "AMZN",
      "name": "Amazon.com, Inc.",
      "symbol": "AMZN"
    }
  ],
  "has_more": true,
  "limit": 100,
  "offset": 0,
  "total": 3206
}