← Back to Skills Marketplace
brs999

kalshi api

by Ben · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
313
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install kalshi-api
Description
Read-only Kalshi API skill for market discovery, liquidity checks, and market validation. Use for scanning and ranking Kalshi opportunities. Pair with a sepa...
README (SKILL.md)

Kalshi API (Read-Only)

Use this skill for Kalshi scouting and market validation only.

Rules

  • Use OpenAPI read endpoints for market discovery and validation.
  • This skill does not place, amend, or cancel orders.
  • This skill does not include paper ledger execution scripts.

Primary Commands

Exchange status:

node {baseDir}/scripts/kalshi-api.mjs status --pretty

Broad market scan:

node {baseDir}/scripts/kalshi-api.mjs markets --status open --limit 1000 --pretty
node {baseDir}/scripts/kalshi-api.mjs events --limit 100 --pretty
node {baseDir}/scripts/kalshi-api.mjs series --limit 400 --pretty

Focused validation:

node {baseDir}/scripts/kalshi-api.mjs market --ticker \x3CTICKER> --pretty
node {baseDir}/scripts/kalshi-api.mjs trades --ticker \x3CTICKER> --limit 200 --pretty
node {baseDir}/scripts/kalshi-api.mjs orderbook --ticker \x3CTICKER> --pretty

Optional Integration: Paper Ledger Skill Required

If you want paper open/close workflows, install and use a separate paper-trading skill that provides the execution script. This Kalshi skill can supply candidate/market data to that separate skill.

node --experimental-strip-types skills/paper-trading/scripts/paper_trading.ts status --account kalshi --format json --pretty

Environment

Optional override (defaults to Kalshi production API):

export KALSHI_BASE_URL="https://api.elections.kalshi.com/trade-api/v2"

Tests

Run the Kalshi reader smoke tests:

node --test {baseDir}/tests/kalshi-api.test.mjs
Usage Guidance
This skill appears to do only read-only Kalshi API queries and is consistent with its description. Before installing, ensure you have a trusted Node runtime and network policy in place. Be cautious about setting KALSHI_BASE_URL to arbitrary URLs (only point it to trusted Kalshi or test endpoints), and review the small included script if you want extra assurance. Because disable-model-invocation is true, the skill cannot be invoked autonomously by the model — you'll need to call it explicitly.
Capability Analysis
Type: OpenClaw Skill Name: kalshi-api Version: 1.0.0 The kalshi-api skill is a legitimate read-only tool for querying Kalshi market data, including exchange status, market tickers, and order books. The implementation in scripts/kalshi-api.mjs is clean, uses standard Node.js fetch for GET requests to official Kalshi endpoints (api.elections.kalshi.com), and contains no evidence of credential theft, data exfiltration, or malicious command execution.
Capability Assessment
Purpose & Capability
Name/description (read-only market discovery, liquidity checks, validation) match the included Node script and test files. The script only issues GET requests to Kalshi OpenAPI endpoints and prints JSON; required binary 'node' is appropriate and proportional.
Instruction Scope
SKILL.md restricts usage to read endpoints and documents the exact CLI commands to run. The only scope caveat is an optional KALSHI_BASE_URL environment override (documented) which can redirect requests to a different HTTP endpoint for testing — this is expected for dev/testing but could be misused if pointed at an untrusted server.
Install Mechanism
No install spec; skill is instruction + small included scripts. No remote downloads or package installs are requested, minimizing install-time risk.
Credentials
No required environment variables or credentials. The single optional env var KALSHI_BASE_URL is documented and reasonable for testing; there are no hidden env accesses in the code.
Persistence & Privilege
Skill is not always-enabled and declares disable-model-invocation: true, so it cannot be autonomously invoked by the model. It does not modify other skills or system settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install kalshi-api
  3. After installation, invoke the skill by name or use /kalshi-api
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of kalshi-trades (v1.0.0): - Introduces a read-only Kalshi OpenAPI skill for market discovery, liquidity checks, and validation. - Enables users to scan, rank, and summarize Kalshi market opportunities using accessible CLI scripts. - Does not support order placement, amendment, or cancellation (no trading/execution features included). - Designed to pair with a separate skill for paper-trading execution if open/close workflows are needed. - Includes examples for broad market scans, focused market validation, and basic configuration.
Metadata
Slug kalshi-api
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is kalshi api?

Read-only Kalshi API skill for market discovery, liquidity checks, and market validation. Use for scanning and ranking Kalshi opportunities. Pair with a sepa... It is an AI Agent Skill for Claude Code / OpenClaw, with 313 downloads so far.

How do I install kalshi api?

Run "/install kalshi-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is kalshi api free?

Yes, kalshi api is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does kalshi api support?

kalshi api is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created kalshi api?

It is built and maintained by Ben (@brs999); the current version is v1.0.0.

💬 Comments