Let your agent build it

Describe what you want. Your coding agent reads the KashRock skill, checks your key and plan, and calls the right endpoints. No endpoint pages to read first.

Add esports data to my app: kashrock.com/SKILL.md

Step 1

Get a key

Sign in and copy a Sandbox key from the console. It is free: 1,500 credits a day, no card. Put it in.envas KASHROCK_API_KEY and never paste it into a chat.

Just looking? https://kashrock.up.railway.app/v6/demo/cs2-prop returns one live prop with no key.

Step 2

Connect your agent

  1. Paste this into Claude Code, Cursor, Codex or any agent that can read a URL:
Add esports data to my app: kashrock.com/SKILL.md

Get your key at kashrock.com/console → API keys. Never paste it into chat.

Step 3

Check a real response

curl -s "https://kashrock.up.railway.app/v7/meta" -H "x-api-key: $KASHROCK_API_KEY"
  • plan in the response is your key’s plan. Pick tools that plan includes.
  • Then call the feature you are building and check for real rows: a kr_match_id that starts with kr_<sport>_, players, prices.
  • Take every ID from a list call. Never build one by hand.

Step 4

Pick a goal

CS2 live dashboard

Hobby and up

A page that lists live CS2 matches and shows each one’s scoreboard as it plays. Hobby works with a 15 second delay. Builder makes it real time and adds the WebSocket so you can stop polling.

Read https://www.kashrock.com/SKILL.md, then build me a CS2 live dashboard: list live matches and show each scoreboard.
  1. 1v7_metaConfirm the key works and read your plan.
  2. 2GET /v7/cs2/matches?status=liveList live matches and take each kr_match_id.
  3. 3GET /v7/cs2/live?game={kr_match_id}&include=boxscoreRead the scoreboard: score, kills, deaths, assists, round state.
  4. 4WS /v7/live/ws (Builder and up)Subscribe to the same match for push updates instead of polling.

How to tell it worked

  • Each match in the list has status "live" and a kr_match_id that starts with kr_cs2_.
  • An empty list means no CS2 match is live right now. That is not an error, and no plan changes it.
  • On Hobby the response carries a data_delay block. That is the 15 second delay, not stale data.

Dota 2 live tracker

Hobby and up

A tracker that follows one Dota 2 match: score, kills and tower events as they happen. Hobby is 15 seconds behind. Builder and up are real time.

Read https://www.kashrock.com/SKILL.md, then build me a Dota 2 live tracker that follows one match and its in-game events.
  1. 1GET /v7/dota2/matches?status=livePick a live match and take its kr_match_id.
  2. 2GET /v7/dota2/live?game={kr_match_id}&include=boxscoreRead the scoreboard for that match.
  3. 3GET /v7/dota2/live?game={kr_match_id}&include=eventsRead in-game events: kills and towers, with team side and time.

How to tell it worked

  • The kr_match_id you pass came from the matches list. Never build one by hand.
  • Check has_live_stats on each game. When it is false, reason says why (for example feed_stale). Show the match without stats; do not retry in a loop.

Odds movement alerts

Hobby and up

A bot that posts when a line moves hard or one book is slow to follow. Hobby polls line moves (flow). Builder adds first-mover plays (momentum). Pro adds signal alerts. Quant adds webhooks so alerts come to you.

Read https://www.kashrock.com/SKILL.md, then build me a bot that alerts when esports odds move, using the best tool my plan allows.
  1. 1v7_metaRead your plan so the bot picks the right tool.
  2. 2GET /v7/cs2/flow (Hobby and up)Steam, shifts and volume moves on the lines board.
  3. 3GET /v7/cs2/momentum?window_minutes=60 (Builder and up)One book moved first; the others still show the old price.
  4. 4GET /v7/cs2/signals (Pro and up)Mispricing, steam and arbitrage alerts in one feed.

How to tell it worked

  • A quiet market returns an empty list. Alert only on what comes back.
  • A 403 with code plan_required names the plan you need in required_plan. Do not retry it.

Tools your agent can call

Tools follow the same plan rules as the REST API. A tool outside your plan answers with the plan that has it.

37 tools, read live from kashrock 1.30.0. Call v7_meta first.

  • v7_matchesEvery plan

    Matches for one sport, or sport=all. status is live, upcoming, or finished. date is YYYY-MM-DD. date_from and date_to are a range (YYYY-MM-DD, both inclusive); with status=finished the range reads full history and pages with offset, so the total counts the range rather than one board page. team filters by name. include is boxscore, prep, veto, maps, player_board, lines, streams, h2h, or sim (CS2 map Monte Carlo, Builder+; pass map= and optional n_sims= up to 1000000; single-match also returns kill prop_fairs vs the Redis board). Replaces get_matches, get_match, search_matches, get_match_prep, get_match_veto, get_player_board, get_tournament_maps, get_boxscore, get_streams.

  • v7_propsEvery plan

    Player props. board is dfs, main, or all. view is groups, rows, or both. Replaces get_props and get_player_props.

  • v7_linesHobby and up

    Team lines for one sport. view is consensus or moneyline. With no market, only the main markets return (match_winner, map_winner, total_maps, team_total_maps, map_handicap, correct_score, dfs_team_pick); round and kill markets need market= (round_handicap, total_rounds, kill_handicap, total_kills), tournament futures need market=outright (every listed pick with each book's own price, no consensus), BetWhale also lists map objectives (market=objective — xth baron/dragon/tower) and in-play round winners (market=round_winner, the round index is the line), and Rivalry lists the long tail: odd_even, yes_no, team_total_rounds, team_total_kills, total_duration, total_towers, towers_winner, half_winner, race_to, pistol_score, player_prop, player_duel and combo (per-book outcome tables — duels name the two players, combos name team + total + direction; no cross-book consensus). format is slim (default) or full. limit caps how many events come back; total_events still states the board's real size. Replaces get_lines, get_moneylines, get_best_lines. Every price carries observed_at (when we last received it), price_changed_at (when this price first appeared in our feed, null when unknown), suspended (true when the book reports the market paused, null when it does not report state), and best_of (the series format when the book reports one).

  • v7_liquidity

    Fill / capacity quote for one exchange offer. Pass offer_id from v7_lines sources, or token_id. notional is USD to spend (buy) or receive (sell). Returns avg_price, contracts, levels walked, leftover. Builder+. Exchange books only (polymarket). Sportsbooks return unsupported_book.

  • v7_parlays

    Price a multi-leg main-line ticket or discover ranked independent parlays for one book. Pass ticket as comma-separated kr_match_id:market:selection to price; omit ticket to discover. size is 2 to 8 legs when discovering. Default discover is +EV only; include=all keeps negatives. Same-match (SGP) is not supported. Hobby+. price_source is computed (product of legs) or book when a native multi-leg price exists. placeable_basis is combo_eligible (Polymarket comboStatus) or book_price. Leg fair probability and EV exclude the leg's own book.

  • v7_flowHobby and up

    Money-behind, shift, steam, and whale Flow plays. kind is all, volume, shift, steam, or whale. Money is taker dollars per side from exchange trades; money_window_hours on a card is the hours it covers (24 at most). Volume needs money floor + lopsided side share. Shift is a side-share move of 10+ points in 6h. A steam play needs 2+ public books converging or one big exchange move, netted so one market never steams both ways. Whale is trade-level prints; is_cluster marks a card that fired on several prints adding up to the floor. limit is at most 100; offset pages through total. Hobby+.

  • v7_momentumBuilder and up

    First-mover +EV plays (Builder+). kind is all, line, or prop. One book moved first and is treated as the true price (devigged two-way); plays are the lag books still offering the old, better-than-fair price. Each play carries the move (book, from->to, moved_at, move_pct), fair odds, the best stale book with ev_pct, gap_pts, behind_seconds and deeplink, plus every stale book. book filters the lag book, mover the first mover, min_ev floors ev_pct, window_minutes is 5-360 (default 60).

  • v7_arbQuant and up

    Cross-venue arbs on the lines board (Quant+). Every two-outcome market whose best price per side sums under 100% implied: legs carry source, decimal, american, offer_id, deeplink and stake_share; stake= scales leg amounts. match is a kr_match_id or slug; market and min_margin filter; sorted by margin_pct desc. Legs must be at different operators -- book keys sharing a venue (polymarket + polymarket_us) are one counterparty and never count.

  • v7_uav

    One match overview, prematch through live. match is a kr_match_id or slug (required). Returns the match card, phase (prematch/live/finished), a WS subscribe hint, and optional include blocks: lines, prep, veto, maps, player_board, streams, h2h (prematch) and boxscore, events, frame, odds, odds_history (live), plus flow (the match's Flow plays). lines/odds/odds_history/flow need Hobby+; live blocks carry the plan's delay.

  • v7_liveHobby and up

    Live matches. sport=all returns every title in one call. game is a kr_match_id. include is boxscore, events, frame, odds, or odds_history. Live scores also stream on /v7/live/ws. Replaces get_live_games, get_live_boxscore, get_live_frame, get_live_events, get_live_odds, get_live_odds_history.

  • v7_playersHobby and up

    Players. sort=rank lists the rankings. include is research, gamelogs, stats, stats_full, history, or media. offset pages through the list with limit. Replaces search_players, get_player, get_player_stats, get_player_stats_full, get_rankings, get_gamelogs, research_player, get_media.

  • v7_teams

    Teams. id is kr_tm_*. q searches the directory by name and returns an empty page when nothing matches. include is form, roster, maps, h2h, main_lines, or upcoming. team1 and team2 return their meetings. offset pages with limit (same as HTTP). Replaces get_team_h2h.

  • v7_history

    Stored history. kind is contract or lines (Custom reads lines on its title). props is an alias of contract. kind=lines takes match as one kr_match_id or a comma list of up to 5; 6 or more is too_many_ids. One id returns that match's tape; several return a matches object keyed by the id you sent, with any id that could not be read listed under missing. A tape runs from 11 KB to 11 MB, so a list is read in one wave and the response carries up to 8 MB of tapes: an id the budget leaves no room for comes back as response_too_large, which means ask for it in a smaller list rather than retry the same one. kind=contract takes prop and book together and returns that contract's quote_tape. limit caps the tape; total_quote_tape still states how many ticks there were. prop also takes a comma list of up to 25 kr_prop ids; 26 or more is too_many_ids. One id returns that contract's body unchanged; several return a props object keyed by the id you sent, with any id that could not be read listed under missing. The list is read in one wave, so pulling a whole board's opening lines costs one call per 25 props instead of one call per prop. A prop whose tape is still being built keeps its own warming body and is counted in warming, with retry_after_seconds on the response: ask for the same list once more rather than for each prop in turn. The opening line is the first entry of each quote_tape, which is ordered oldest tick first. A match id carries its own sport, so take the sport from the id: asking one sport's route for another sport's id answers 400 reason=wrong_sport, with id_sport and route_sport naming both. Omitting book returns every book's quotes in one tape. Replaces get_history_tape and get_lines_history.

  • v7_resultsHobby and up

    Settled grades already stored for this sport. start and end are YYYY-MM-DD. Replaces get_results.

  • v7_breakdown

    Actionable fact bundle for a match, team, or H2H pair (odds, form, maps, starter props, targets). Pass match= (slug/kr_match_id), team= (name/kr_tm_*), or team1= and team2=. Builder+.

  • v7_meta

    Call first. Sports, books (each carries kind, supports, a logo URL, and aliases), markets, the routes table, and the caller's plan. include=boards adds which books have live lines per sport — answers 'which books have data' without probing endpoints. include also takes coverage, teams, tournaments, or changelog. Replaces list_sports, list_books, list_markets, get_coverage.

  • math_convert

    One price in, every spelling out. Send exactly one of american (+350→350, -120→-120), decimal (4.5), probability (0..1), or percent (0..100). Returns american, decimal, probability, percent.

  • math_kelly

    Kelly stake for a win chance and a price. fair_probability is your chance 0..1; send exactly one of decimal or american. fraction: 1=full, 0.5=half, 0.25=quarter (default), 0.125=eighth. bankroll adds stake_amount in dollars. Returns kelly_full_pct, stake_pct, ev_pct.

  • v7_signalsPro and up

    Signal alerts for one sport (Pro+). kind is mispricing, steam, arb, or all (default). match is a kr_match_id or slug; market is a registry market key; min_edge sets the floor in edge percentage points. When the served board is last-good, stale=true and as_of carry the board's own publish time.

  • v7_clvQuant and up

    Closing line value per bet, per book (Quant+). match is required (kr_match_id or slug). market and book filter (registry keys, e.g. ggbet); date_from/date_to are YYYY-MM-DD (inclusive).

  • v7_backtestQuant and up

    Backtest a flat-stake strategy against settled matches (Quant+). Defaults cover the last 30 days; date_from/date_to (YYYY-MM-DD) widen it up to 180 days. min_edge is the simulated bet trigger in edge percentage points; stake is flat per bet. Returns bets, summary (P&L, hit rate, ROI), and matches_scanned.

  • v7_portfolioQuant and up

    List tracked bets with auto-graded results and running P&L (Quant+). result filters win, loss, push, or pending; book and market filter; date_from/date_to bound placed_at. Track a bet via POST /v7/{sport}/portfolio/track; remove one via DELETE /v7/portfolio/{bet_id}.

  • v7_sgp_quoteBuilder and up

    Price a CS2 same-game parlay from one shared joint simulation (Builder+). match is a kr_match_id. legs is a JSON array, at least two entries, each {"market": "match_winner"|"map_winner"|"total_maps"|"total_rounds"|"player_kills", "selection": ..., "map": 1, "maps": [1], "line": 25.5, "direction": "over"}. selection is a kr_tm id for team markets, over/under for line markets, and a kr_pl id for player_kills. Only half-point lines and maps guaranteed to be played are priced. pricing is optional JSON {"source": "model"|"book", "books": {"pinnacle": 1.0}, "min_sources": 1}. operator is optional JSON {"margin_pct": 5, "max_legs": 6, "allowed_markets": [...], "max_decimal": 501, "price_override_decimal": null, "quote_ttl_seconds": 30}. The response carries the measured joint probability, the independence baseline, the correlation ratio, fair and priced decimals, and the scenario count behind the joint.

  • v7_sgp_ticket_recordBuilder and up

    Price and record a CS2 same-game ticket (Builder+). Same arguments as v7_sgp_quote; the price is recomputed server-side and stored immutably with the legs, so a caller can never record a price it chose. stake is optional and only used to compute the payout at settlement. Returns ticket_id.

  • v7_sgp_ticket_getBuilder and up

    Settle one recorded same-game ticket from KashRock's stored match, map and player-map results (Builder+). Every leg comes back hit, miss, void, pending or unresolved with the actual value it settled on, plus a final ticket status.

  • v7_sgp_ticketsBuilder and up

    Every recorded same-game ticket on this account, newest first (Builder+). Open tickets are graded from KashRock's stored results as they are read, so a ticket settles on the first read after its match finishes; counts summarises the set. Set settle=false to read the stored status without grading.

  • v7_tradersBuilder and up

    Ranked public wallets trading esports markets (Builder+). game is cs2, lol, dota2, valorant, or empty for all. period is 7d, 30d, 90d, or all. sort is score (default), pnl, roi, win_rate, or volume. profitable is true or false. market filters a market kind such as series or map_1. cursor is the opaque next_cursor from the prior page. Ranking is confidence-aware, not raw profit; every row carries flags naming its penalties.

  • v7_traderBuilder and up

    One public wallet's scores and, with include=performance, its reconstructed performance windows (Builder+). wallet is a 0x address. No wallet is attributed to a person without a verified public source.

  • v7_trader_historyBuilder and up

    One wallet's public executions, newest first (Builder+). Pages with the opaque next_cursor until null.

  • v7_smart_money_matchBuilder and up

    Qualified wallet activity for one KashRock match (Builder+). match is a kr_match_id. include picks timeline, flow, signals and consensus. The timeline is chart-ready: every point carries the execution's own timestamp and price.

  • v7_smart_money_flowBuilder and up

    Qualified net buying and selling over time (Builder+). bucket is 5m, 15m, 1h, 4h, or 1d. Only wallets above min_confidence count toward the flow.

  • v7_smart_money_signalsPro and up

    Detected qualified-wallet signals with evidence (Pro+). kind is cluster_entry, capital_before_move, sharp_exit, or consensus_divergence. match is a kr_match_id. Signals describe observed public behaviour, never proof of non-public information.

  • explain_error

    Turn an API/MCP error string into a plain-English next step.

  • get_live_frame

    Prefer v7_live with include=frame. Raw live NormalizedFrame + metadata for one game_id (kr_match_id from v7_live). Sandbox=all sports, 30-60s delayed; Hobby=all sports, 15s delayed; Builder+=real-time.

  • get_live_wsBuilder and up

    Live push WebSocket contract (Builder+). Returns URL, auth, subscribe ops — connect from your app; MCP cannot hold the socket. The v7 socket is /v7/live/ws; /v6/esports/live/ws is the legacy path serving the same contract.

  • get_trade_ws

    Auto-trade WebSocket contract (/v7/trade). Returns URL, auth, ops and the intent shape — connect from your app or run `kashrock trade`; MCP cannot hold the socket. Signed intents only; paper mode by default; plan priority applies.

  • get_defense_vs_role

    What teams allow to the opposing player in each role (Dota 2 lanes, Valorant agent classes): kills, deaths, assists, Dota 2 last hits, Valorant first kills and Underdog fantasy points, vs the league average, with rank (1 = allows the most). Omit team for the league table; team = kr_tm_* id, slug, or name. window = last_10, last_20 or last_50 maps. Sandbox=Last 10 only, last 7 days; Hobby=last 90 days; Builder+=full vault.

What each plan can call

PlanPriceCreditsRateLive
Sandbox$0/mo1,500 credits a day10 req/minNo live data
Hobby$29.99/mo1.5M credits a month30 req/min15s delay
Builder$99/mo5M credits a month100 req/minReal time
Pro$199/mo10M credits a month250 req/minReal time
Quant$299/mo20M credits a month500 req/minReal time

Full comparison on pricing, or pricing.md for agents.

When something goes wrong

Every error says what happened and what to do. The explain_error tool turns any of them into plain English.

StatusYou seeIt meansDo this
401error.code = "invalid_key"The key is missing, wrong, or turned off.Send it as the x-api-key header (Authorization: Bearer also works). Copy it again from the console.
403error.code = "plan_required"This endpoint is not in your plan. required_plan names the plan that has it.Do not retry. Tell the user which plan unlocks it; upgrade.url opens checkout with that plan picked.
402limit_type = "daily", "monthly" or "live_lines"Your credits for the day or month are spent.Wait for resets_at, add a credit pack (credits_url), or move up a plan. Retrying will not help.
429limit_type = "rpm", "concurrency" or "heavy_capacity"Too many requests at once. You still have credits.Wait the Retry-After seconds, then retry. Cache slow-changing data and poll live data no faster than you need.
200, emptyAn empty matches, live or plays listNothing matches right now: no live match, or a quiet market.Show an empty state. It is a real answer, not an error, and no plan changes it.
200, no statshas_live_stats = false with a reasonThe match is live but no live source is covering it right now.Show the match without stats. Upgrading does not add coverage for a match.
200, delayedA data_delay block on live dataYour plan reads live data with a delay (15 seconds on Hobby).Expected on Hobby. Builder and up are real time.