kalshi

n8n node for Kalshi trading and market data

Package Information

Downloads: 206 weekly / 206 monthly
Latest Version: 1.1.0
Author: Your Name

Available Nodes

Kalshi icon
Kalshi
Interact with Kalshi prediction markets API

Documentation

n8n-nodes-kalshi

npm version
npm downloads
License: MIT

This is an n8n community node that lets you interact with the Kalshi prediction markets API in your n8n workflows.

Kalshi is a federally regulated prediction market exchange where you can trade on real-world events. This node enables you to:

  • 📊 Fetch market data and prices
  • 💰 Place and manage orders
  • 📈 Monitor your portfolio
  • 🔍 Scan markets for opportunities
  • 🤖 Build automated trading strategies
  • 📉 Analyze historical data

n8n is a fair-code licensed workflow automation platform.

Installation

Via n8n Community Nodes (Recommended)

  1. Go to Settings > Community Nodes in n8n
  2. Select Install
  3. Enter n8n-nodes-kalshi in Enter npm package name
  4. Agree to the risks and click Install

Manual Installation

npm install n8n-nodes-kalshi

Credentials

You need a Kalshi account to use this node.

Creating Credentials

  1. Demo Account (Testing):

  2. Production Account (Real Trading):

    • Sign up at kalshi.com
    • Complete verification
    • Fund your account

Setting Up in n8n

  1. In n8n, go to Credentials > New
  2. Search for Kalshi API
  3. Enter your credentials:
    • Email: Your Kalshi account email
    • Password: Your Kalshi account password
    • Environment: Demo or Production
  4. Click Create

Security Note: n8n securely encrypts and stores your credentials.

Operations

📊 Market Resource

Operation Description
Get Markets Retrieve multiple markets with extensive filters
Get Market Get detailed information about a specific market
Get Market Orderbook Get the current bid/ask spread and depth
Get Market Candlesticks Get historical price data
Get Trades Get recent trade history
Batch Get Candlesticks Get candlesticks for multiple markets

📅 Event Resource

Operation Description
Get Events List all events with filters
Get Event Get detailed event information
Get Event Metadata Get event metadata and rules
Get Event Candlesticks Get candlestick data for an event

💰 Order Resource

Operation Description
Create Order Place a new order (market or limit)
Get Orders Retrieve your orders with filters
Get Order Get details of a specific order
Cancel Order Cancel an existing order
Batch Create Orders Create multiple orders at once
Batch Cancel Orders Cancel multiple orders at once
Amend Order Modify an existing order
Decrease Order Decrease the quantity of an order

📈 Portfolio Resource

Operation Description
Get Balance Get your account balance
Get Positions Get your current positions
Get Fills Get your order execution history
Get Settlements Get settlement history

🏛️ Exchange Resource

Operation Description
Get Status Get current exchange status
Get Announcements Get exchange announcements
Get Schedule Get exchange operating schedule

📑 Series Resource

Operation Description
Get Series List Get list of all series
Get Series Get detailed series information

Quick Start

1. Get Exchange Status

Test your connection with a simple operation:

Resource: Exchange
Operation: Get Status

2. Browse Markets

See what's available to trade:

Resource: Market
Operation: Get Markets
Additional Fields:
  Status: open
  Limit: 100

3. Place Your First Order (Demo Only!)

Resource: Order
Operation: Create Order
Ticker: MARKET-TICKER-HERE
Action: buy
Side: yes
Type: limit
Count: 1
Yes Price: 50

Example Workflows

1. Price Monitoring Bot

Monitor a market and get alerted when price moves:

Nodes:

  1. Schedule Trigger (every 5 minutes)
  2. Kalshi - Get Market
  3. IF - Check price threshold
  4. Send Email/Slack notification

2. Automated Trading Strategy

Execute trades based on conditions:

Nodes:

  1. Schedule Trigger
  2. Kalshi - Get Markets (filter by criteria)
  3. Function - Analyze opportunities
  4. Kalshi - Create Order
  5. Database - Log trade

3. Portfolio Dashboard

Daily portfolio summary:

Nodes:

  1. Schedule Trigger (daily at 9 AM)
  2. Kalshi - Get Balance
  3. Kalshi - Get Positions
  4. Kalshi - Get Fills
  5. Google Sheets - Update dashboard
  6. Email - Daily summary

4. Market Scanner

Find trading opportunities:

Nodes:

  1. Kalshi - Get Markets (all open)
  2. Function - Filter by volume/spread
  3. Kalshi - Get Market Orderbook (for each)
  4. Function - Calculate metrics
  5. IF - Filter opportunities
  6. Notification - Alert on opportunities

See EXAMPLE_WORKFLOWS.md for detailed configurations!

Documentation

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/yourusername/n8n-nodes-kalshi.git
cd n8n-nodes-kalshi

# Install dependencies
npm install

# Build
npm run build

# Watch mode for development
npm run dev

Testing Locally

# Link the package
npm link

# In your n8n directory
npm link n8n-nodes-kalshi

# Restart n8n to see changes

Building

npm run build        # Build project
npm run lint         # Run linter
npm run lintfix      # Fix linting issues
npm run format       # Format code with Prettier

Publishing

# Update version
npm version patch    # 1.0.0 -> 1.0.1
npm version minor    # 1.0.0 -> 1.1.0
npm version major    # 1.0.0 -> 2.0.0

# Publish to npm
npm publish

Compatibility

  • n8n version: 0.198.0 or above
  • Node.js version: 18.0.0 or above
  • Tested with: n8n 1.0.0+

Resources

Kalshi

n8n

Support

Issues and Feature Requests

Please open an issue on GitHub.

Questions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Changelog

Version 1.0.0 (2025-01-11)

Features

  • ✨ Complete Kalshi API v2 integration
  • 📊 Market data operations (6 operations)
  • 📅 Event operations (4 operations)
  • 💰 Order management (8 operations including batch)
  • 📈 Portfolio tracking (4 operations)
  • 🏛️ Exchange info (3 operations)
  • 📑 Series operations (2 operations)
  • 🔐 Secure authentication with email/password
  • 🌍 Support for Demo and Production environments
  • 📝 Comprehensive documentation and examples
  • 🎯 30+ total operations

Documentation

  • Complete setup guide
  • 8 example workflows
  • Quick start guide
  • API reference

Roadmap

Future enhancements planned:

  • WebSocket support for real-time data
  • Advanced order types
  • Portfolio analytics
  • Strategy backtesting
  • Risk management tools
  • Multi-account support
  • Advanced filtering options
  • Export/import workflows

License

MIT

Copyright (c) 2025 n8n-nodes-kalshi Contributors

Disclaimer

⚠️ Important:

  • This is an unofficial community node
  • Not affiliated with Kalshi or n8n
  • Use at your own risk
  • Always test with Demo environment first
  • Understand the risks of automated trading
  • The authors are not responsible for any trading losses
  • Read and understand Kalshi's Terms of Service

Trading involves risk. Only trade with funds you can afford to lose.

Acknowledgments

  • Thanks to Kalshi for their excellent API
  • Thanks to n8n for the amazing automation platform
  • Thanks to all contributors and users of this node

Star History

If you find this project useful, please give it a ⭐ on GitHub!

Made with ❤️ for the n8n and Kalshi communities

Happy Trading! 🚀

Discussion