Developer Platform

Integrate VariableChang.io into your applications with our powerful API

Platform Overview

The VariableChang.io API provides programmatic access to prediction market data, trading signals, portfolio management, and analytics. Build custom dashboards, automated trading bots, or integrate our insights into your existing applications.

API Access Tiers

Public API (No Auth)

Access market data, prices, orderbooks, and platform status without authentication.

  • • Market discovery and metadata
  • • Real-time price data
  • • Orderbook snapshots
  • • Public leaderboards

Authenticated API

Access your personal data and account information with API key authentication.

  • • Portfolio and positions
  • • Trading activity history
  • • Support tickets and messages
  • • Referral and points data

Restricted API (Approval Required)

Advanced features requiring admin approval and elevated permissions.

  • • Trade execution
  • • Automated trading
  • • Copy trading management
  • • High-frequency endpoints

Authentication

Generate API keys from your account dashboard. Include your API key in requests:

Authorization: Bearer YOUR_API_KEY

Security: Never share your API keys. Keys are hashed and cannot be recovered if lost. You can revoke and regenerate keys at any time.

Example Endpoints

Get Markets

GET /kalshi/markets?limit=10

Response:
{
  "markets": [...],
  "total": 150
}

Get Portfolio

GET /api/paper/positions
Authorization: Bearer YOUR_API_KEY

Response:
{
  "positions": [...],
  "total_value": 1250.50
}

Get Points Balance

GET /api/points/balance
Authorization: Bearer YOUR_API_KEY

Response:
{
  "total_points": 1500,
  "recent_activity": [...]
}

Rate Limits

API calls are rate-limited to ensure platform stability:

  • Public endpoints: 60 requests per minute
  • Authenticated endpoints: 100 requests per minute
  • Execution endpoints: 10 requests per minute

Rate limit headers are included in all responses. Contact support for higher limits.

Error Handling

All errors return a consistent JSON format:

{
  "detail": "Error message description"
}

Common status codes:
- 200: Success
- 401: Unauthorized (invalid/missing API key)
- 403: Forbidden (insufficient permissions)
- 422: Validation error (invalid input)
- 429: Rate limit exceeded
- 500: Server error

Get Started

Ready to start building? Follow these steps:

  1. 1. Create an account if you don't have one
  2. 2. Generate an API key from your dashboard
  3. 3. Make your first API call with your key
  4. 4. Request execution access if needed (requires approval)

Need help? Visit our Help Center or contact support.