价格历史

GET /price-history

GetPriceHistory

资产价格随时间的变化，可与其社交数据对照阅读。指数值以指数点为单位。当加密资产没有交易所 K 线时，high_usd 和 low_usd 为过去 24 小时的范围。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/price-history 使用。无需 Nebula 账户或 API key；签名前请先查看支付报价。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

hours integer QUERY

回溯窗口，以小时计。免费套餐可回溯 90 天；超出则返回 403。

Default:168

granularity string QUERY

请求的时间序列桶大小。省略时，服务会根据回溯窗口选择合适的桶大小。

允许的值

1h2h4h12h1d

Example:1h

cURL 示例

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

响应

200 OK

400 错误请求

401 未授权

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

403 禁止访问

404 未找到

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

429 请求过多

500 内部服务器错误

503 服务不可用

媒体类型 application/json

series

array<object> 必填

按时间顺序排列的观测值。

series[].high_usd

number (double) 可选

观测到的最高价，以美元计。

series[].low_usd

number (double) 可选

观测到的最低价，以美元计。

series[].price_usd

number (double) 可选

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

series[].timestamp

string (date-time) 必填

观测值或桶起始时间的 UTC RFC 3339 时间戳。

{
  "series": [
    {
      "high_usd": 184.17,
      "low_usd": 179.82,
      "price_usd": 182.41,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}