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

REST API
Поиск

Текст в asset ID

GET /assets

ListAssets

Ищите акции (акции и ETF), сырьё, индексы и криптовалюты по названию или тикеру и получайте 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

Asset ID из /assets или /search, например NVDA, GLD, SPX или bitcoin. Передавайте его вместе с возвращённым рядом с ним asset_class.

Example:NVDA

asset_class string QUERY

Ограничивает результаты одним классом: equity (акции и ETF), 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> обязательный

Активы, соответствующие заданным фильтрам обнаружения.

assets[].asset_class

string обязательный

Класс актива: equity (акции и ETF), commodity, index или crypto. Передавайте его вместе с asset_id в каждом запросе, ограниченном активом.

Допустимые значения

equitycommodityindexcrypto

assets[].asset_id

string обязательный

Канонический публичный идентификатор актива: тикер или рыночный символ для акций, товаров и индексов, а для криптовалют — слаг CoinGecko (или, при его отсутствии, числовой id).

assets[].handle

string необязательный

Основной социальный аккаунт, если доступен.

assets[].market_cap_usd

number (double) необязательный

Последняя рыночная капитализация в долларах США. Указывается для криптовалют; отсутствует для акций, сырья и индексов.

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
}