検索

GET /search
検索

アセット、人物、アカウント、トピックを横断する単一の検索です。各結果がどれに該当するかはkindが示します。アセットにはasset_idとasset_classが付き、サブジェクトにはsubject_idが付きます。片方だけを検索するにはkindを送信します。

ウォレット支払いは https://nebula-api.hiddensystems.ai/api/v1/x402/search で利用できます。Nebula アカウントや API キーは不要です。署名する前に支払いオファーを確認してください。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 クレジットを使い切りました。レスポンスには更新時期と購入済みクレジット残高が含まれます
403 アクセス拒否
404 見つかりません
405 メソッドが許可されていません。Allow ヘッダーにサポートされているメソッドが記載されています。
429 リクエストが多すぎます
500 内部サーバーエラー
503 サービス利用不可

メディアタイプ application/json

query
string 必須

解決されたフリーテキスト文字列をそのまま返します。

results
array<object> 必須

ランク付けされた結果。上位から順に並びます。

results[].asset_class
string 任意

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

results[].asset_id
string 任意

公開アセットの正規識別子: 株式、コモディティ、インデックスの場合はティッカーまたは市場シンボル、crypto の場合は CoinGecko スラッグ(スラッグがない場合は数値 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"
    }
  ]
}