全部文档 Nebula 文档所有端点交互式文档 Markdown OpenAPI JSON

REST API
查询

搜索

GET /search

搜索

一次搜索即可覆盖资产、人物、账户和话题。每条结果的 kind 会标明其类型：资产带有 asset_id 和 asset_class，主体带有 subject_id。发送 kind 可只搜索其中一侧。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/search 使用。无需 Nebula 账户或 API key；签名前请先查看支付报价。x402 支付指南。

参数

query string QUERY 必填

要搜索的文本：股票代码、公司或代币名称、人物、账户或话题。

Example:NVIDIA

kind string QUERY

将结果限定为资产（股票、大宗商品、指数和加密货币）或主体（人物、账户和话题）。省略则同时搜索两者。

允许的值

assetsubject

Example:asset

limit integer QUERY

返回的最大结果数。

Default:10

cURL 示例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/search' \
  --data-urlencode 'query=NVIDIA' \
  --header 'X-API-Key: YOUR_API_KEY'

响应

200 OK

400 错误请求

401 未授权

402 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额

403 禁止访问

404 未找到

405 方法不被允许；Allow 响应头列出了支持的方法

429 请求过多

500 内部服务器错误

503 服务不可用

媒体类型 application/json

query

string 必填

被解析出的自由文本字符串，原样回显。

results

array<object> 必填

排名结果，最优者在前。

results[].asset_class

string 可选

资产的类别：equity（股票和 ETF）、commodity、index 或 crypto。在每个资产范围的请求中都要与 asset_id 一同发送。

results[].asset_id

string 可选

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

results[].kind

string 必填

结果类型：asset（使用 asset_id 和 asset_class 查询）或 subject（使用 subject_id 查询）。

允许的值

assetsubject

results[].matched_alias

string 可选

与查询匹配的名称或别名，便于你说明搜索为何落到该结果。

results[].name

string 必填

人类可读的名称。

results[].subject_id

string 可选

非资产的人物、账户或主题的规范标识符。

results[].symbol

string 可选

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

{
  "query": "nvidia",
  "results": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "kind": "asset",
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "kind": "subject",
      "matched_alias": "NVIDIA AI",
      "name": "NVIDIA AI",
      "subject_id": "handle:nvidiaai"
    }
  ]
}