Kahyna
Sign inStart free, no card →
DEVELOPERS

Kahyna API and MCP server for prediction markets

Kahyna has a Data API at https://kahyna.com/api/v1/data and an MCP server at https://kahyna.com/api/v1/mcp, so your code or MCP clients such as Claude can read the wallets Kahyna follows, their records, where they agree and Kahyna’s own track record, with a key from your account page sent as a Bearer token or an X-API-Key header. A free key reads the track record, 10 requests a week; a paid Pro subscription opens the wallets, their records, the Following list, positions and convergence, 100 a week, and Max, not on sale yet, will carry 10,000. A new account’s free days of Pro do not raise a key’s allowance, and responses never include a wallet address or a venue price.

Get a key

Sign in, open your account page and create a key. It needs a confirmed email, and it is shown once, so copy it then. Send it on every request as Authorization: Bearer khy_…, or as X-API-Key: khy_…. The shell examples below read it from KAHYNA_API_KEY, so set that first (export KAHYNA_API_KEY=khy_…) and it never lands in your shell history. Revoke a key there at any time.

Your weekly allowance

Free10 requests a week
Pro100 requests a week, plus the wallets, their records, your Following list, positions and convergence
Max10,000 requests a week, when Max opens: it is not on sale yet

The allowance resets every Monday at 00:00 UTC. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. A refused request (no key, a Pro endpoint on a free key, a bad parameter) costs nothing. See Pro.

A new account’s free days of Pro open the site, not the API: a key stays on the Free allowance until the account subscribes.

Endpoints

Endpoints are under https://kahyna.com/api/v1/data and answer JSON in the same envelope as the rest of Kahyna. All are GET except following a wallet (PUT) and unfollowing it (DELETE).

PathPlanWhat it returns
/walletsProThe wallets we follow, ranked: settled bets, win rate, how far each beat the odds, P&L and return on money staked. One row per wallet and desk.
  • desk sports, esports, politics, world, crypto, equity, macro, weather or other
  • sort evidence (default, most reliable first), pnl, win_rate or beats_odds
  • limit 1 to 100, default 25
  • offset for the next page, default 0
/wallets/{wallet_id}ProOne wallet in full: its record, its desks, its last ten results, typical hold, profit factor, how much of its profit came from one bet, and its $100-a-bet curve.
/track-recordFreeKahyna’s own public record: calls logged, settled calls won and lost, and the win rate over them, losses included.
/usageFree, not chargedThis week’s allowance: used, remaining, and when it resets. Reading it costs nothing.
/wallets/{wallet_id}/positionsProWhat one wallet holds now: market, side, its average entry price and the share of its open book.
/convergenceProMarkets several followed wallets hold together: the side most are on, how strongly they agree, what each side’s shares pay if it wins and the price they paid, and Kahyna’s probability where it has one.
  • desk as above
  • limit 1 to 100, default 25
  • sort agreement (default), return, profit, wallets, money or closing
/followingProThe wallets this account follows, newest first, each with its main desk’s record and how many positions it is live in where we track that.
PUT /following/{wallet_id}ProFollow a wallet. Following one already on the list changes nothing. An account follows at most 50.
DELETE /following/{wallet_id}ProStop following a wallet. Not an error if it was not on the list.
/following/positionsProWhat the followed wallets hold now: market, wallet, side, average entry price and share of that wallet’s open book.
/activityProThe newest trades of the verified wallets, or of your list: market, outcome, shares, average fill price and money, with the wallet’s record. The last 12 hours, newest first.
  • scope all (every verified wallet) or following (your list), default all
  • desk as above
  • side bought or sold
  • min_usd 0, 100, 1000 or 10000: the smallest trade shown, default 0
  • limit 1 to 100, default 50

An example

curl -H "Authorization: Bearer $KAHYNA_API_KEY" \
  "https://kahyna.com/api/v1/data/wallets?sort=evidence&limit=2"
{
  "data_mode": "production",
  "as_of": "2026-09-26T16:00:00+00:00",
  "ttl_s": 0,
  "data": {
    "sort": "evidence", "desk": null, "limit": 2, "offset": 0, "next_offset": 2,
    "wallets": [
      { "wallet_id": "5f1c09a2b7e84d3c", "label": "0x4a467cd9", "desk": "sports",
        "settled_bets": 212, "wins": 151, "win_rate": 0.7123,
        "beats_odds_pts": 18.4, "pnl_usd": 21155.0, "staked_usd": 38000.0,
        "return_on_capital": 0.5567 }
    ]
  }
}

Errors

Errors are application/problem+json with a title and a plain explanation.

MCP, for AI assistants

The same reads are MCP tools at https://kahyna.com/api/v1/mcp, with the same key and the same allowance: one tool call is one request. Connecting and listing the tools need no key and cost nothing; every tool call needs one. In Claude Code:

claude mcp add --transport http kahyna https://kahyna.com/api/v1/mcp \
  --header "Authorization: Bearer $KAHYNA_API_KEY"

In Claude Desktop, through mcp-remote:

{
  "mcpServers": {
    "kahyna": {
      "command": "npx",
      "args": ["mcp-remote", "https://kahyna.com/api/v1/mcp",
               "--header", "Authorization: Bearer khy_YOUR_KEY"]
    }
  }
}

What the data is, and is not

Questions people ask

Can I use Kahyna with ChatGPT or Claude?

Kahyna works with MCP clients such as Claude: its MCP server at https://kahyna.com/api/v1/mcp takes an API key from your account page, sent as a Bearer token or an X-API-Key header, kahyna.com/developers shows the setup for Claude Code and Claude Desktop, and any MCP-capable assistant that can send that key can use it. A free key reads Kahyna’s track record, 10 requests a week. Pro opens the wallets Kahyna follows, 100 a week, with a paid subscription only: a new account’s free days of Pro do not raise a key’s allowance.