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

Распределение исходов сигналов

GET /calls/returns
GetCallReturns

Как показали себя недавние призывы: доля прибыльных, медианная и средняя доходность, а также распределение доходностей. Каждый призыв оценивается по движению цены за 24 часа после него, с точки зрения автора призыва, поэтому короткий призыв при падении на 10% даёт +10%. Отправьте clusters, чтобы сравнить группы, например smart_money против dumb_money.

Правила параметров:

  • Отправьте asset_class и asset_id вместе или ни одного.

Оплата кошельком доступна на https://nebula-api.hiddensystems.ai/api/v1/x402/calls/returns. Аккаунт Nebula или API-ключ не требуются; проверьте предложение об оплате перед подписанием. Руководство по оплате x402.

Параметры

asset_id string QUERY

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

Example:NVDA

asset_class string QUERY

Класс актива, указанного в asset_id: equity (акции и ETF), commodity, index или crypto. Передавайте asset_class, который /assets или /search вернули вместе с asset_id.

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

Example:equity

resolved_days integer QUERY

За сколько дней включать закрытые призывы: призывы, 24-часовой рубеж которых наступил в пределах этого числа дней. Бесплатные планы охватывают 90 дней; дальше возвращается 403.

Default:7

clusters array<string> QUERY

Кластеры авторов для чтения; повторяйте, чтобы объединить, например clusters=kols&clusters=media. Выбранные кластеры складываются, и автор может принадлежать к нескольким.

  • Callers: smart_money (лучшие по результатам), dumb_money (худшие по результатам), top_degens (лучшие в малой капитализации криптовалют)
  • Timing: early_movers (первыми говорят об активе по мере роста внимания), late_movers (приходят на пике или после)
  • Строители: developers, founders, team_leaders, project_accounts
  • Институты: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • Влияние: kols, celebrities, media, marketer, shiller
  • Аналитики: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • Трейдеры: position_trader, swing_trader, day_trader
  • Смещение: perma_bull, doomer, tribalist
  • Другое: political, nft, bots, automated_ai

Example:smart_money

Пример cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/calls/returns' \
  --header 'X-API-Key: YOUR_API_KEY'

Ответы

200 OK
400 Некорректный запрос
401 Не авторизован
402 Кредиты израсходованы; ответ содержит срок продления и баланс купленных кредитов
403 Доступ запрещён
404 Не найдено
405 Метод не поддерживается; поддерживаемые методы перечислены в заголовке Allow
429 Слишком много запросов
500 Внутренняя ошибка сервера
503 Сервис недоступен

Тип медиа application/json

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

Средняя доходность в направлении призыва по закрытым призывам, в процентных пунктах.

buckets
array<object> обязательный

Корзины распределения доходностей в порядке возрастания.
buckets[].call_count
integer (int64) обязательный

Закрытые призывы в этой корзине доходностей.

buckets[].capped_total_aligned_return_pct
number (double) обязательный

Сумма доходностей с учётом направления, при этом доходность каждого сигнала ограничена диапазоном ±100%, в процентных пунктах.

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

Понятная человеку метка интервала или индекса.

buckets[].lower_bound_pct
number (double) обязательный

Включающая нижняя граница доходности в процентных пунктах; null для первого, открытого интервала.

buckets[].total_aligned_return_pct
number (double) обязательный

Сумма доходностей с учётом направления в этом интервале, в процентных пунктах.

buckets[].upper_bound_pct
number (double) обязательный

Исключающая верхняя граница доходности в процентных пунктах; null для последнего, открытого интервала.

losses
integer (int64) обязательный

Закрытые сигналы с отрицательной доходностью с учётом направления.

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

Медианная доходность с учётом направления по закрытым сигналам, в процентных пунктах.

resolved_calls
integer (int64) обязательный

Количество сигналов с определённым исходом.

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

За сколько дней закрытые сигналы учитываются в статистике.

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

Доля выигрышных закрытых сигналов в процентах от 0 до 100.

wins
integer (int64) обязательный

Закрытые сигналы с положительной доходностью с учётом направления.

{
  "average_return_pct": 4.1,
  "buckets": [
    {
      "call_count": 91,
      "capped_total_aligned_return_pct": -228,
      "label": "-10% to 0%",
      "lower_bound_pct": -10,
      "total_aligned_return_pct": -342.5,
      "upper_bound_pct": 0
    }
  ],
  "losses": 174,
  "median_return_pct": 2.8,
  "resolved_calls": 412,
  "resolved_days": 7,
  "win_rate_pct": 57.77,
  "wins": 238
}