Быстрый старт: Рыночные данные

Узнайте, как получить доступ к рыночным данным в режиме реального времени без аутентификации

Это руководство поможет вам получить доступ к публичным конечным точкам рыночных данных Kalshi без аутентификации. Вы узнаете, как получать информацию о сериях, событиях, рынках и данных книги заявок для популярного рынка «У кого будет больше чистого одобрения».

Выполнение запросов без аутентификации

Kalshi предоставляет несколько публичных конечных точек, не требующих ключей API. Эти конечные точки позволяют вам получать доступ к рыночным данным непосредственно с наших рабочих серверов по адресу https://api.elections.kalshi.com/trade-api/v2

Шаг 1: Получение информации о серии
Начнём с получения информации о серии KXHIGHNY (Самая высокая температура в Нью-Йорке сегодня?). Эта серия отслеживает самую высокую температуру, зарегистрированную в Центральном парке Нью-Йорка в определённый день. Мы будем использовать конечную точку «Получить информацию о серии».

import requests

# Get series information for KXHIGHNY
url = "https://api.elections.kalshi.com/trade-api/v2/series/KXHIGHNY"
response = requests.get(url)
series_data = response.json()

print(f"Series Title: {series_data['series']['title']}")
print(f"Frequency: {series_data['series']['frequency']}")
print(f"Category: {series_data['series']['category']}")

Шаг 2: Получите информацию о сегодняшних событиях и рынках

Теперь, когда у нас есть информация о серии, давайте получим информацию о рынках для этой серии. Мы используем конечную точку «Получить рынки» с фильтром по тикеру серии, чтобы найти все активные рынки.

 # Get all markets for the KXHIGHNY series
markets_url = f"https://api.elections.kalshi.com/trade-api/v2/markets?series_ticker=KXHIGHNY&status=open"
markets_response = requests.get(markets_url)
markets_data = markets_response.json()

print(f"\nActive markets in KXHIGHNY series:")
for market in markets_data['markets']:
    print(f"- {market['ticker']}: {market['title']}")
    print(f"  Event: {market['event_ticker']}")
    print(f"  Yes Price: {market['yes_price']}¢ | Volume: {market['volume']}")
    print()

# Get details for a specific event if you have its ticker
if markets_data['markets']:
    # Let's get details for the first market's event
    event_ticker = markets_data['markets'][0]['event_ticker']
    event_url = f"https://api.elections.kalshi.com/trade-api/v2/events/{event_ticker}"
    event_response = requests.get(event_url)
    event_data = event_response.json()

    print(f"Event Details:")
    print(f"Title: {event_data['event']['title']}")
    print(f"Category: {event_data['event']['category']}")

Шаг 3: Получение данных из книги ордеров
Теперь давайте получим книгу ордеров для конкретного рынка, чтобы увидеть текущие цены спроса и предложения, используя конечную точку «Получить рыночную книгу ордеров».

# Get orderbook for a specific market
# Replace with an actual market ticker from the markets list
market_ticker = markets_data['markets'][0]['ticker']
orderbook_url = f"https://api.elections.kalshi.com/trade-api/v2/markets/{market_ticker}/orderbook"

orderbook_response = requests.get(orderbook_url)
orderbook_data = orderbook_response.json()

print(f"\nOrderbook for {market_ticker}:")
print("YES BIDS:")
for bid in orderbook_data['orderbook']['yes'][:5]:  # Show top 5
    print(f"  Price: {bid[0]}¢, Quantity: {bid[1]}")

print("\nNO BIDS:")
for bid in orderbook_data['orderbook']['no'][:5]:  # Show top 5
    print(f"  Price: {bid[0]}¢, Quantity: {bid[1]}")


Работа с большими наборами данных
API Kalshi использует пагинацию на основе курсора для эффективной обработки больших наборов данных. Подробнее о навигации по ответам, разбитым на страницы, см. в нашем руководстве «Понимание пагинации».

Понимание ответов книги ордеров
Структура книги ордеров Kalshi уникальна из-за особенностей рынков бинарных прогнозов. API возвращает только биды (а не аски) из-за взаимной связи между позициями «ДА» и «НЕТ». Чтобы узнать больше об ответах книги ордеров и о том, почему они работают таким образом, см. в нашем руководстве «Ответы книги ордеров».

Дальнейшие шаги
Теперь, когда вы понимаете, как получить доступ к рыночным данным без аутентификации, вы можете:

1. Изучать другие публичные серии и события
2. Создавать инструменты мониторинга рынка в режиме реального времени
3. Создавать панели анализа рынка
4. Настраивать соединение WebSocket для обновления данных в режиме реального времени (требуется аутентификация)

Информацию об аутентифицированных конечных точках, позволяющих торговать и управлять портфелем, см. в нашем руководстве по ключам API.