Вся документация Документация Nebula Все эндпоинты Интерактивная документация Markdown OpenAPI JSON
  1. REST API
  2. Поиск

Поиск

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_id в каждом запросе, ограниченном активом.

results[].asset_id
string необязательный

Канонический публичный идентификатор актива: тикер или рыночный символ для акций, товаров и индексов, а для криптовалют — слаг 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"
    }
  ]
}