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

REST API
查詢

文字轉資產 ID

GET /assets

ListAssets

依名稱或 ticker 查詢股票（stocks 與 ETFs）、大宗商品、指數與加密貨幣，並取得每個資產端點都接受的 asset_id 與 asset_class。送出 query 可搜尋、送出 asset_id 可精確比對，或兩者皆不送以瀏覽最活躍的資產。

參數規則：

asset_id 必須與 asset_class 一起傳送。
asset_id 不能與 query 合併使用。

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

參數

asset_id string QUERY

來自 /assets 或 /search 的資產 ID，例如 NVDA、GLD、SPX 或 bitcoin。請與一併回傳的 asset_class 一起送出。

Example:NVDA

asset_class string QUERY

將結果限制為單一類別：equity（stocks 與 ETFs）、commodity、index 或 crypto。送出 asset_id 時為必填。

允許的值

equitycommodityindexcrypto

Example:equity

query string QUERY

對公開識別碼與名稱進行不分大小寫的搜尋。

Example:NVIDIA

limit integer QUERY

傳回的結果數量上限。

Default:50

offset integer QUERY

略過的結果數量。

Default:0

cURL 範例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/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[].asset_class

string 必填

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

允許的值

equitycommodityindexcrypto

assets[].asset_id

string 必填

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

assets[].handle

string 選填

主要社群帳號（若有）。

assets[].market_cap_usd

number (double) 選填

最新市值，以美元計。加密貨幣會回報；stocks、commodities 與 indices 則不會。

assets[].name

string 必填

人類可讀的名稱。

assets[].price_change_24h_pct

number (double) 選填

24 小時內的原始市場價格變動，以百分點為單位。

assets[].price_usd

number (double) 選填

最新或觀測到的市場價格，以美元計。

assets[].symbol

string 必填

顯示用的 ticker 或市場代號。

has_more

boolean 必填

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

limit

integer 必填

要求的記錄數上限。

offset

integer 必填

略過的相符記錄數。

{
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "name": "NVIDIA Corporation",
      "price_change_24h_pct": 2.37,
      "price_usd": 182.41,
      "symbol": "NVDA"
    },
    {
      "asset_class": "commodity",
      "asset_id": "GLD",
      "name": "SPDR Gold Shares",
      "symbol": "GLD"
    },
    {
      "asset_class": "index",
      "asset_id": "SPX",
      "name": "S&P 500",
      "symbol": "SPX"
    }
  ],
  "has_more": false,
  "limit": 50,
  "offset": 0
}