全部文档 Nebula 文档 所有端点 交互式文档 Markdown OpenAPI JSON
  1. REST API
  2. 查询

文本转资产 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 key；签名前请先查看支付报价。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 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额
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 必填

规范的公开资产标识符：股票、商品和指数的股票代码或市场符号，以及加密货币的 CoinGecko slug（若无 slug，则为数字 id）。

assets[].handle
string 可选

可获取时返回的主要社交账号。

assets[].market_cap_usd
number (double) 可选

以美元计的最新市值。加密货币会报告该值；股票、大宗商品和指数则没有。

assets[].name
string 必填

人类可读的名称。

assets[].price_change_24h_pct
number (double) 可选

24 小时内的原始市场价格变化，以百分点计。

assets[].price_usd
number (double) 可选

最新或观测到的市场价格，以美元计。

assets[].symbol
string 必填

显示的股票代码或市场符号。

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
}