---
title: Kalshi
description: Accede a mercados de predicción y opera en Kalshi
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="kalshi"
  color="#09C285"
/>

{/* MANUAL-CONTENT-START:intro */}
[Kalshi](https://kalshi.com) es un mercado regulado federalmente donde los usuarios pueden operar directamente sobre los resultados de eventos futuros—mercados de predicción. La robusta API de Kalshi y la integración con Sim permiten a los agentes y flujos de trabajo acceder programáticamente a todos los aspectos de la plataforma, admitiendo desde investigación y análisis hasta operaciones automatizadas y monitoreo.

Con la integración de Kalshi en Sim, puedes:

- **Datos de mercados y eventos:** Buscar, filtrar y obtener datos en tiempo real e históricos de mercados y eventos; obtener detalles granulares sobre el estado del mercado, series, agrupaciones de eventos y más.
- **Gestión de cuentas y saldos:** Acceder a saldos de cuenta, fondos disponibles y monitorear posiciones abiertas en tiempo real.
- **Gestión de órdenes y operaciones:** Colocar nuevas órdenes, cancelar las existentes, ver órdenes abiertas, obtener un libro de órdenes en vivo y acceder a historiales completos de operaciones.
- **Análisis de ejecución:** Obtener operaciones recientes, ejecuciones históricas y datos de velas para backtesting o investigación de estructura de mercado.
- **Monitoreo:** Verificar el estado de todo el mercado o a nivel de series, recibir actualizaciones en tiempo real sobre cambios en el mercado o interrupciones de operaciones, y automatizar respuestas.
- **Listo para automatización:** Construir agentes automatizados y paneles de control de extremo a extremo que consuman, analicen y operen con probabilidades de eventos del mundo real.

Al utilizar estas herramientas y puntos de acceso unificados, puedes incorporar sin problemas los mercados de predicción de Kalshi, capacidades de operación en vivo y datos profundos de eventos en tus aplicaciones impulsadas por IA, paneles de control y flujos de trabajo, permitiendo una toma de decisiones sofisticada y automatizada vinculada a resultados del mundo real.
{/* MANUAL-CONTENT-END */}

## Instrucciones de uso

Integra los mercados de predicción de Kalshi en el flujo de trabajo. Puede obtener mercados, mercado específico, eventos, evento específico, saldo, posiciones, órdenes, libro de órdenes, operaciones, gráficos de velas, ejecuciones, series, estado del intercambio y realizar/cancelar/modificar operaciones.

## Herramientas

### `kalshi_get_markets`

Obtener una lista de mercados de predicción de Kalshi con filtrado opcional

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `status` | string | No | Filtrar por estado \(unopened, open, closed, settled\) |
| `seriesTicker` | string | No | Filtrar por ticker de serie |
| `eventTicker` | string | No | Filtrar por ticker de evento |
| `limit` | string | No | Número de resultados \(1-1000, predeterminado: 100\) |
| `cursor` | string | No | Cursor de paginación para la siguiente página |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `markets` | array | Array de objetos de mercado |
| `paging` | object | Cursor de paginación para obtener más resultados |

### `kalshi_get_market`

Obtener detalles de un mercado de predicción específico por ticker

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `ticker` | string | Sí | El ticker del mercado \(p. ej., "KXBTC-24DEC31"\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `market` | object | Objeto de mercado con detalles |

### `kalshi_get_events`

Obtener una lista de eventos de Kalshi con filtrado opcional

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `status` | string | No | Filtrar por estado \(open, closed, settled\) |
| `seriesTicker` | string | No | Filtrar por ticker de serie |
| `withNestedMarkets` | string | No | Incluir mercados anidados en la respuesta \(true/false\) |
| `limit` | string | No | Número de resultados \(1-200, predeterminado: 200\) |
| `cursor` | string | No | Cursor de paginación para la siguiente página |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `events` | array | Array de objetos de eventos |
| `paging` | object | Cursor de paginación para obtener más resultados |

### `kalshi_get_event`

Recuperar detalles de un evento específico por ticker

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `eventTicker` | string | Sí | El ticker del evento |
| `withNestedMarkets` | string | No | Incluir mercados anidados en la respuesta \(true/false\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `event` | object | Objeto de evento con detalles |

### `kalshi_get_balance`

Recuperar el saldo de tu cuenta y el valor de la cartera desde Kalshi

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Sí | Tu ID de clave API de Kalshi |
| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `balance` | number | Saldo de la cuenta en centavos |
| `portfolioValue` | number | Valor del portafolio en centavos |

### `kalshi_get_positions`

Recuperar tus posiciones abiertas desde Kalshi

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Sí | Tu ID de clave API de Kalshi |
| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) |
| `ticker` | string | No | Filtrar por ticker de mercado |
| `eventTicker` | string | No | Filtrar por ticker de evento \(máximo 10 separados por comas\) |
| `settlementStatus` | string | No | Filtrar por estado de liquidación \(all, unsettled, settled\). Predeterminado: unsettled |
| `limit` | string | No | Número de resultados \(1-1000, predeterminado: 100\) |
| `cursor` | string | No | Cursor de paginación para la siguiente página |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `positions` | array | Array de objetos de posición |
| `paging` | object | Cursor de paginación para obtener más resultados |

### `kalshi_get_orders`

Recupera tus órdenes de Kalshi con filtrado opcional

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Sí | Tu ID de clave API de Kalshi |
| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) |
| `ticker` | string | No | Filtrar por ticker de mercado |
| `eventTicker` | string | No | Filtrar por ticker de evento \(máximo 10 separados por comas\) |
| `status` | string | No | Filtrar por estado \(en espera, cancelado, ejecutado\) |
| `limit` | string | No | Número de resultados \(1-200, predeterminado: 100\) |
| `cursor` | string | No | Cursor de paginación para la siguiente página |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `orders` | array | Array de objetos de órdenes |
| `paging` | object | Cursor de paginación para obtener más resultados |

### `kalshi_get_order`

Recupera detalles de una orden específica por ID desde Kalshi

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Sí | Tu ID de clave API de Kalshi |
| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) |
| `orderId` | string | Sí | El ID de la orden a recuperar |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `order` | object | Objeto de orden con detalles |

### `kalshi_get_orderbook`

Recupera el libro de órdenes (ofertas de sí y no) para un mercado específico

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `ticker` | string | Sí | Ticker del mercado \(p. ej., KXBTC-24DEC31\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `orderbook` | object | Libro de órdenes con ofertas y demandas de sí/no |

### `kalshi_get_trades`

Recupera operaciones recientes de todos los mercados

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `limit` | string | No | Número de resultados \(1-1000, predeterminado: 100\) |
| `cursor` | string | No | Cursor de paginación para la siguiente página |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `trades` | array | Array de objetos de operaciones |
| `paging` | object | Cursor de paginación para obtener más resultados |

### `kalshi_get_candlesticks`

Obtener datos de velas OHLC para un mercado específico

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `seriesTicker` | string | Sí | Ticker de serie |
| `ticker` | string | Sí | Ticker del mercado \(p. ej., KXBTC-24DEC31\) |
| `startTs` | number | Sí | Marca de tiempo inicial \(segundos Unix\) |
| `endTs` | number | Sí | Marca de tiempo final \(segundos Unix\) |
| `periodInterval` | number | Sí | Intervalo de período: 1 \(1min\), 60 \(1hora\), o 1440 \(1día\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `candlesticks` | array | Array de datos de velas OHLC |

### `kalshi_get_fills`

Recuperar tu portafolio

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Sí | Tu ID de clave API de Kalshi |
| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) |
| `ticker` | string | No | Filtrar por ticker de mercado |
| `orderId` | string | No | Filtrar por ID de orden |
| `minTs` | number | No | Marca de tiempo mínima \(milisegundos Unix\) |
| `maxTs` | number | No | Marca de tiempo máxima \(milisegundos Unix\) |
| `limit` | string | No | Número de resultados \(1-1000, predeterminado: 100\) |
| `cursor` | string | No | Cursor de paginación para la siguiente página |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `fills` | array | Array de objetos de ejecuciones/operaciones |
| `paging` | object | Cursor de paginación para obtener más resultados |

### `kalshi_get_series_by_ticker`

Obtener detalles de una serie de mercado específica por ticker

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `seriesTicker` | string | Sí | Ticker de la serie |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `series` | object | Objeto de serie con detalles |

### `kalshi_get_exchange_status`

Obtener el estado actual del intercambio Kalshi (actividad de trading y del intercambio)

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `status` | object | Estado del exchange con indicadores trading_active y exchange_active |

### `kalshi_create_order`

Crear una nueva orden en un mercado de predicción de Kalshi

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Sí | Tu ID de clave API de Kalshi |
| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) |
| `ticker` | string | Sí | Ticker del mercado \(p. ej., KXBTC-24DEC31\) |
| `side` | string | Sí | Lado de la orden: 'yes' o 'no' |
| `action` | string | Sí | Tipo de acción: 'buy' o 'sell' |
| `count` | string | Sí | Número de contratos \(mínimo 1\) |
| `type` | string | No | Tipo de orden: 'limit' o 'market' \(predeterminado: limit\) |
| `yesPrice` | string | No | Precio de 'yes' en centavos \(1-99\) |
| `noPrice` | string | No | Precio de 'no' en centavos \(1-99\) |
| `yesPriceDollars` | string | No | Precio de 'yes' en dólares \(p. ej., "0.56"\) |
| `noPriceDollars` | string | No | Precio de 'no' en dólares \(p. ej., "0.56"\) |
| `clientOrderId` | string | No | Identificador personalizado de la orden |
| `expirationTs` | string | No | Marca de tiempo Unix para la expiración de la orden |
| `timeInForce` | string | No | Tiempo en vigor: 'fill_or_kill', 'good_till_canceled', 'immediate_or_cancel' |
| `buyMaxCost` | string | No | Costo máximo en centavos \(habilita automáticamente fill_or_kill\) |
| `postOnly` | string | No | Establecer como 'true' para órdenes solo maker |
| `reduceOnly` | string | No | Establecer como 'true' solo para reducción de posición |
| `selfTradePreventionType` | string | No | Prevención de auto-negociación: 'taker_at_cross' o 'maker' |
| `orderGroupId` | string | No | ID de grupo de órdenes asociado |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `order` | object | El objeto de orden creada |

### `kalshi_cancel_order`

Cancelar una orden existente en Kalshi

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Sí | Tu ID de clave API de Kalshi |
| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) |
| `orderId` | string | Sí | El ID de la orden a cancelar |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `order` | object | El objeto de orden cancelada |
| `reducedBy` | number | Número de contratos cancelados |

### `kalshi_amend_order`

Modificar el precio o la cantidad de una orden existente en Kalshi

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `keyId` | string | Sí | Tu ID de clave API de Kalshi |
| `privateKey` | string | Sí | Tu clave privada RSA \(formato PEM\) |
| `orderId` | string | Sí | El ID de la orden a modificar |
| `ticker` | string | Sí | Ticker del mercado |
| `side` | string | Sí | Lado de la orden: 'yes' o 'no' |
| `action` | string | Sí | Tipo de acción: 'buy' o 'sell' |
| `clientOrderId` | string | Sí | El ID de orden original especificado por el cliente |
| `updatedClientOrderId` | string | Sí | El nuevo ID de orden especificado por el cliente después de la modificación |
| `count` | string | No | Cantidad actualizada para la orden |
| `yesPrice` | string | No | Precio actualizado para 'yes' en centavos \(1-99\) |
| `noPrice` | string | No | Precio actualizado para 'no' en centavos \(1-99\) |
| `yesPriceDollars` | string | No | Precio actualizado para 'yes' en dólares \(p. ej., "0.56"\) |
| `noPriceDollars` | string | No | Precio actualizado para 'no' en dólares \(p. ej., "0.56"\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `order` | object | El objeto de orden modificada |
