Response Format

Docs

Response Format

Complete API response structure and field descriptions.

Full Response Example

{
  "success": true,
  "generated_at": "2026-02-02T16:59:17.318117Z",
  "investment_amount": 100,
  "min_profit_filter": 1.9,
  "total_markets_analyzed": 437,
  "total_arbitrages_found": 314,
  "markets_skipped": 123,
  "skip_reasons": {
    "No valid orderbook data (empty asks)": 123
  },
  "profitable_count": 26,
  "profitable_arbitrages": [...]
}

Top-Level Fields

Field	Type	Description
`success`	boolean	Whether the request succeeded
`generated_at`	string	ISO timestamp when data was generated
`investment_amount`	number	Your investment parameter (USD)
`min_profit_filter`	number	Your minimum profit filter (USD)
`total_markets_analyzed`	number	Total markets scanned across platforms
`total_arbitrages_found`	number	All arbitrage opportunities detected
`markets_skipped`	number	Markets skipped due to data issues
`skip_reasons`	object	Breakdown of why markets were skipped
`profitable_count`	number	Opportunities meeting your min_profit
`profitable_arbitrages`	array	Array of profitable opportunities

Arbitrage Object

Each item in profitable_arbitrages:

{
  "kalshi_id": "KXVENEZUELALEADER-26DEC31-EGON",
  "poly_clob_token_ids": [
    "85482789936744260311999371350699987044247644306653001528276695717482676507600",
    "70138439134789940151293221562290156019511842004756860386379046881297155754497"
  ],
  "market_name_a": "Who will lead Venezuela at the end of 2026? - Dec 31, 2026 - Edmundo González",
  "market_name_b": "Will Edmundo González be the leader of Venezuela end of 2026? - Edmundo González",
  "platform_a": "Kalshi",
  "platform_b": "Polymarket",
  "url_a": "https://kalshi.com/events/KXVENEZUELALEADER-26DEC31",
  "url_b": "https://polymarket.com/event/venezuela-leader-end-of-2026/...",
  "volume_a": 315283,
  "volume_b": 230198.937641,
  "best_arbitrage": {...}
}

Field	Type	Description
`kalshi_id`	string	Kalshi market ticker
`poly_clob_token_ids`	array	Polymarket CLOB token IDs (Yes/No)
`market_name_a`	string	Market name on Kalshi
`market_name_b`	string	Market name on Polymarket
`platform_a`	string	First platform (always "Kalshi")
`platform_b`	string	Second platform (always "Polymarket")
`url_a`	string	Direct link to Kalshi market
`url_b`	string	Direct link to Polymarket market
`volume_a`	number	Trading volume on Kalshi (USD)
`volume_b`	number	Trading volume on Polymarket (USD)
`best_arbitrage`	object	Optimal bet combination details

Best Arbitrage Object

The best_arbitrage field contains the calculated bet strategy:

{
  "combination": "Buy No on Kalshi, Buy Yes on Polymarket",
  "platform_1": "Kalshi",
  "side_1": "No",
  "price_1": 0.89,
  "bet_amount_1": 93.68,
  "payout_1": 105.26,
  "platform_2": "Polymarket",
  "side_2": "Yes",
  "price_2": 0.06,
  "bet_amount_2": 6.32,
  "payout_2": 105.26,
  "total_prob": 95,
  "gross_profit": 5.26,
  "net_profit": 5.26,
  "roi_percent": 5.26,
  "fees": 0
}

Field	Type	Description
`combination`	string	Human-readable strategy description
`platform_1`	string	First platform to bet on
`side_1`	string	Bet side on first platform ("Yes" or "No")
`price_1`	number	Price per share on first platform (0-1)
`bet_amount_1`	number	Amount to bet on first platform (USD)
`payout_1`	number	Payout if this side wins (USD)
`platform_2`	string	Second platform to bet on
`side_2`	string	Bet side on second platform ("Yes" or "No")
`price_2`	number	Price per share on second platform (0-1)
`bet_amount_2`	number	Amount to bet on second platform (USD)
`payout_2`	number	Payout if this side wins (USD)
`total_prob`	number	Combined implied probability (%)
`gross_profit`	number	Profit before fees (USD)
`net_profit`	number	Profit after fees (USD)
`roi_percent`	number	Return on investment (%)
`fees`	number	Total fees (USD)

Understanding the Strategy

The combination field tells you exactly what to do:

"Buy No on Kalshi, Buy Yes on Polymarket": Place a "No" bet on Kalshi and a "Yes" bet on Polymarket
"Buy Yes on Kalshi, Buy No on Polymarket": Place a "Yes" bet on Kalshi and a "No" bet on Polymarket

Both payouts are equal (payout_1 = payout_2), so regardless of outcome, you receive the same amount and profit the net_profit value.

Notifications Error Handling