Безкоштовний API ринкових даних без ключа

Strasmore надає безкоштовний API для ринкових даних, який не потребує ключа або реєстрації. Він надає зростаючий набір підготовлених запитів лише для читання щодо акцій та опціонів США у форматі JSON через HTTPS. Сервіс спеціально розроблений для використання як людьми, так і AI-агентами. Це також демонстрація рідкісного рішення без використання ключів: безкоштовного SQL API, де користувач з безкоштовним обліковим записом може самостійно створювати запити. На цій сторінці описано кожен endpoint, наведено приклади робочих викликів та наведено графіки тих самих даних, які повертає API.

Що надає безкоштовний API

Кожен ключ відповідає на конкретне запитання ринкового аналітика. Каталог станом на момент написання:

• spy_qqq: нормалізована прибутковість SPY та QQQ за останні 45 сесій
• dividend_yield_leaders: найвищі дивідендна доходність серед компаній з великою капіталізацією на останній сесії
• upcoming_ex_dividends: майбутні дати виплат дивідендів у США з сумами виплат та датами виплат
• short_interest_watch: лідери за показником days-to-cover за останніми даними розрахунку коротких позицій
• iv_leaders: лідери за показником implied-volatility на кінець дня серед ліквідних активів для опціонів
• recent_ipos: лістинги в США за останні 180 днів з ціною пропозиції та обсягом
• latest_market_news: останні ринкові заголовки та згадувані в них тікери
• biggest_movers: найбільші коливання за останню регулярну сесію серед ліквідних активів
• revenue_leaders: найбільші компанії США за останнім річним доходом та чистим прибутком
• most_active_options: концентрація обсягу опціонів з середньою implied volatility
• put_call_ratio: співвідношення обсягів put/call для найбільш активних активів
• upcoming_splits: нещодавні та заплановані спреди акцій
• market_holidays: майбутні закриття та ранні закриття біржі NYSE

Ціни на акції затримані. Параметри greeks та implied volatility є значеннями на кінець дня. Кожен пакет даних містить точний SQL-запит, який його сформував, тому будь-яке число можна перевірити через відповідний запит.

Як зробити запит

Один GET-запит, заголовки не потрібні:

curl "https://ai.strasmore.com/api/demo?q=dividend_yield_leaders"

Ендпоінт каталогу містить усі доступні ключі з готовими URL-адресами для отримання даних, зрозумілим описом кожного запиту та примітками щодо використання. Використовуйте його першим, якщо ви здійснюєте програмне вивчення API:

curl "https://ai.strasmore.com/api/demo/catalog"

Відповідь містить розгорнутий ключ, питання, на яке він відповідає, SQL-запит, назви стовпців, рядки та два поля-вказівники. Структура (значення пропущені):

{
  "key": "dividend_yield_leaders",
  "label": "Highest dividend yields, large caps, latest session",
  "nl": "Which large-cap US stocks currently have the highest dividend yields?",
  "sql": "SELECT ...",
  "columns": ["as_of", "ticker", "dividend_yield_pct", "..."],
  "rows": ["..."],
  "source": "Strasmore Research",
  "more": "Get more at https://www.strasmore.com ..."
}

Якщо передати неіснуючий ключ, повернеться запит за замовчуванням, а замість помилки буде додано поле fallback_from. Використовуйте це поле як сигнал про помилку в написанні, а каталог вважайте першоджерелом достовірних ключів.

Розроблено для агентів та LLM

Демонстраційна версія призначена для виклику програмним забезпеченням, яке вам не потрібно писати сьогодні. Відповіді встановлюють access-control-allow-origin: *, а попередні запити CORS дозволяють доступ з будь-якого джерела, тому браузерні додатки, блокноти та LLM агенти можуть отримувати дані напряму. На рівні архітектури кожен запит перераховується не частіше ніж раз на десять хвилин і видається з пам'яті за кілька мілісекунд.

Машиночитані точки входу у порядку, в якому їх має зчитувати агент:

1. https://www.strasmore.com/llms.txt об'єднує індекс контенту та API демо-версії в одному короткому файлі.
2. https://ai.strasmore.com/api/demo/catalog перелічує кожен запит із відповідним URL.
3. Поле more у кожній відповіді посилається назад на каталог та повний продукт.

Два примітки щодо правил використання. Дані кожного запиту оновлюються не частіше ніж раз на десять хвилин, тому частіші запити повернуть ідентичні дані. Поле source у кожному пакеті даних вказує на джерело даних; зберігайте його видимим там, де це практично можливо, при повторній публікації показника.

Дані для демонстрації

Відповіді API отримуються з того самого сховища, яке використовується в цьому блозі. Наведені нижче панелі виконують запити демонстрації через конвеєр блогу; під кожною панеллю відкритий SQL-код.

Ключ spy_qqq нормалізує ціни закриття SPY та QQQ, перетворюючи їх на відсоткову прибутковість за 45-денне вікно. За 30 сесій у поточному вікні кумулятивна зміна SPY відображає -1.6%, а QQQ — -5.69%.

SELECT day,
       round((spy / first_value(spy) OVER (ORDER BY day ASC) - 1) * 100, 2) AS spy_return_pct,
       round((qqq / first_value(qqq) OVER (ORDER BY day ASC) - 1) * 100, 2) AS qqq_return_pct
FROM (
    SELECT toDate(window_start) AS day,
           argMaxIf(close, window_start, ticker = 'SPY') AS spy,
           argMaxIf(close, window_start, ticker = 'QQQ') AS qqq
    FROM global_markets.delayed_stocks_minute_aggs
    WHERE ticker IN ('SPY', 'QQQ') AND window_start >= now() - INTERVAL 45 DAY
    GROUP BY day
)
ORDER BY day

Ключ dividend_yield_leaders фільтрує активи з доходністю від 2% до 15% та ринковою капіталізацією понад $2 мільярди. Нижня межа усуває статистичний шум, а верхня — артефакти спеціальних дивідендів, які створюють показники доходності, непідтримувані компаніями на постійній основі. Станом на Jul 17 лідером у фільтрі є STRC з показником 13.45%. Щоб дізнатися про динаміку виплат окремої компанії протягом десятиліть, перегляньте історію дивідендів Microsoft.

SELECT ticker,
       round(dividend_yield * 100, 2) AS dividend_yield_pct,
       formatDateTime(date, '%b %e') AS as_of_label
FROM global_markets.stocks_ratios
WHERE date = (SELECT max(date) FROM global_markets.stocks_ratios)
  AND dividend_yield BETWEEN 0.02 AND 0.15
  AND market_cap > 2e9
  AND ticker NOT IN ('SPCX')
ORDER BY dividend_yield DESC
LIMIT 12

Ключ iv_leaders розраховує середню беззтримуючу волатильність (implied volatility) на кінець дня для кожного базового активу за всіма доступними страйками та датами експірації, залишає лише активи зі значним обсягом опціонів та ранжує їх. Поточним лідером є SNXX з середньою беззтримуючою волатильністю 299.1%. Високі показники в цьому фільтрі вказують на активи, де ринок опціонів закладає значні коливання; фільтр відображає рівень, а інтерпретацію ви здійснюєте самостійно.

SELECT underlying_symbol AS ticker,
       round(avg(implied_volatility) * 100, 1) AS avg_iv_pct
FROM global_markets.options_greeks
WHERE date = (SELECT max(date) FROM global_markets.options_greeks)
  AND iv_converged
  AND underlying_symbol NOT IN ('SPCX')
GROUP BY underlying_symbol
HAVING sum(volume) > 10000
ORDER BY avg_iv_pct DESC
LIMIT 12

Ключ short_interest_watch ранжує кількість днів для покриття (days-to-cover) на основі того ж набору даних FINRA, що описаний у нашому посібнику з даних про короткі позиції, а ключ upcoming_ex_dividends зчитує календар корпоративних подій. Обидва ключі працюють за наведеною вище схемою: фікрований фільтр, обмежений результат та SQL-код у корисній навантаженні.

Від демо-версії до повноцінного сховища

Запити в демо-версії обмежені навмисно: вони залишаються дешевими, кешуються та є безпечними для загального доступу. Сховище, що стоїть за ними, містить дані про акції США за 22 роки та історію опціонів за 12 років. Безкоштовний акаунт (без прив'язки картки) дозволяє виконувати власні SQL-запити до бази, обмежені 100 запитами на день. Платні рівні надають доступ до повної історії, тикових даних та програмних API-ключів. Коли стандартного інтерфейсу стає недостатньо, наступним кроком є безкоштовний рівень SQL.

FAQ

Чи дійсно API ринкових даних Strasmore є безкоштовним?

Так. Демонстраційні ендпоінти не потребують ключа, реєстрації або платіжних даних. Вони обробляють лише фіксовані запити; довільні запити доступні лише у повноцінному продукті.

Чи потрібен мені API key або автентифікація?

Ні. Кожен демонстраційний ендпоінт відповідає на звичайні неавтентифіковані GET-запити. Ключі існують лише для платного programmatic API, який виконує індивідуальні запити.

Наскільки актуальні демонстраційні дані?

Ціни на акції (equity) є затриманими, а не в режимі реального часу. Коефіцієнти, короткий інтерес (short interest) та корпоративні дії оновлюються з частотою своїх джерел. Greeks та імпліцитна волатильність надаються за результатами дня. Результат кожного запиту оновлюється не частіше ніж раз на десять хвилин.

Чи може мій LLM агент або браузерний додаток викликати його безпосередньо?

Так. Відповіді повертаються з відкритим CORS з будь-якого джерела, preflight-запити проходять усюди, а каталог за посиланням /api/demo/catalog описує кожен запит у форматі JSON, який агент може прочитати без документації.

Що станеться, якщо я запитаю ключ, якого не існує?

API поверне запит за замовчуванням spy_qqq і додасть поле fallback_from, що вказує на ваш запит. Перегляньте каталог, щоб отримати список дійсних ключів.

Кожна панель на цій сторінці є живим збереженим запитом, і та сама база даних відповідає на запитання, які ви пишете самостійно мовою SQL або звичайною англійською мовою у терміналі Strasmore.