すべてのドキュメント Nebula ドキュメント すべてのエンドポイント インタラクティブドキュメント Markdown OpenAPI JSON
  1. REST API
  2. ルックアップ

テキストからアセットID

GET /assets
ListAssets

株式（stocks と ETFs）、コモディティ、インデックス、crypto を名前またはティッカーで検索し、すべてのアセットエンドポイントが受け取る 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

結果を 1 つのクラスに限定します: 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> 必須

指定された discovery フィルターに一致するアセット。
assets[].asset_class
string 必須

アセットのクラス: equity（株式および ETF）、commodity、index、crypto のいずれか。asset を対象とするすべてのリクエストで asset_id とともに送信してください。

指定可能な値
equitycommodityindexcrypto
assets[].asset_id
string 必須

公開アセットの正規識別子: 株式、コモディティ、インデックスの場合はティッカーまたは市場シンボル、crypto の場合は CoinGecko スラッグ（スラッグがない場合は数値 id）。

assets[].handle
string 任意

利用可能な場合は主要なソーシャルハンドル。

assets[].market_cap_usd
number (double) 任意

米ドルでの最新の時価総額。crypto では報告され、stocks、commodities、indices では存在しません。

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
}