{"openapi":"3.1.0","info":{"title":"Craps Odds API","version":"1.0.0","description":"Craps odds maths as an API, computed locally and deterministically and exactly — the dice probabilities behind the table, derived from the 36 ways two dice fall, not pulled from a chart. The come-out endpoint gives the come-out roll: the pass line wins on a 7 or 11 (8 of 36, 22.2 %), loses on craps 2, 3 or 12 (4 of 36, 11.1 %), and otherwise sets a point (24 of 36, 66.7 %). The point endpoint gives the odds of making a point before a seven — probability = ways(point) ÷ (ways(point) + 6) — so a 6 or 8 makes 45.5 % of the time and a 4 or 10 only 33.3 %, with the TRUE odds (2:1, 3:2, 6:5) the free odds bet behind the line pays at zero house edge. The bet endpoint gives the house edge of the main bets: the line bets at 1.41 % (pass) and 1.36 % (don't) and place 6/8 at 1.52 % are the table's best, while place 4/10 (6.67 %), the field and proposition bets like any seven (16.67 %) bleed you. Everything is computed locally and deterministically, so it is instant and exact. Ideal for craps and casino-game apps, gambling-education and odds tools, game-design back-ends, and probability teaching. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 compute endpoints. Educational — not betting advice; back the line with free odds.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/craps-api","description":"oanor gateway"}],"tags":[{"name":"Craps"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/bet":{"get":{"operationId":"get_v1_bet","tags":["Craps"],"summary":"House edge of a bet","description":"","parameters":[{"name":"bet_type","in":"query","required":true,"description":"pass | dontpass | come | dontcome | place4-10 | field | any7 | anycraps","schema":{"type":"string"},"example":"pass"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"bet":"pass line","note":"House edge per bet resolved. The line bets (pass/come 1.41 %, don't 1.36 %) and place 6/8 (1.52 %) are the best on the table; place 4/10 (6.67 %), the field and proposition bets like any seven (16.67 %) are sucker bets. Back the line with free odds to dilute the edge toward zero.","inputs":{"bet_type":"pass"},"house_edge_pct":1.41,"win_probability_pct":49.29},"meta":{"timestamp":"2026-06-06T23:54:02.897Z","request_id":"b4e775f2-f1b4-4d4e-9274-16b7e267e1a2"},"status":"ok","message":"Bet edge","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/come-out":{"get":{"operationId":"get_v1_come_out","tags":["Craps"],"summary":"Come-out roll probabilities","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"On the come-out roll the pass line wins on a 7 or 11 (8 of 36 = 22.2 %), loses on craps 2, 3 or 12 (4 of 36 = 11.1 %), and otherwise sets a point (24 of 36 = 66.7 %). Don't-pass is the mirror, except a 12 pushes (the bar) — which is where its tiny edge comes from.","craps_lose_pct":11.11,"natural_win_pct":22.22,"point_established_pct":66.67},"meta":{"timestamp":"2026-06-06T23:54:02.981Z","request_id":"45955e5e-33c4-4e26-b9cb-e009d30de44a"},"status":"ok","message":"Come-out roll","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/point":{"get":{"operationId":"get_v1_point","tags":["Craps"],"summary":"Odds of making a point","description":"","parameters":[{"name":"point","in":"query","required":true,"description":"Point number (4,5,6,8,9,10)","schema":{"type":"string"},"example":"6"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Once a point is set, only that number or a seven matters — the point makes with probability ways(point) ÷ (ways(point) + 6). A 6 or 8 makes 5 of 11 times (45.5 %), a 4 or 10 only 3 of 9 (33.3 %). The free 'odds' bet behind the line pays these TRUE odds with zero house edge — always take it.","inputs":{"point":6},"true_odds":"6:5","ways_to_roll":5,"probability_make_point_pct":45.45},"meta":{"timestamp":"2026-06-06T23:54:03.072Z","request_id":"c330090d-d87b-44d8-a51a-bbad1e11ead6"},"status":"ok","message":"Point odds","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"Two fair dice (36 outcomes). Come-out: win 8/36, lose 4/36, point 24/36. Point makes ways/(ways+6); true odds 4/10 2:1, 5/9 3:2, 6/8 6:5. Pass edge 1.41 %. Educational — not betting advice.","service":"craps-api","endpoints":{"GET /v1/bet":"House edge and win probability for a craps bet.","GET /v1/meta":"This document.","GET /v1/point":"Odds of making a point before a seven, with the true odds.","GET /v1/come-out":"Come-out roll outcome probabilities (natural/craps/point)."},"description":"Craps maths: come-out roll probabilities, the odds of making a point before a seven with true odds, and the house edge of the main bets."},"meta":{"timestamp":"2026-06-06T23:54:03.168Z","request_id":"e19ccef3-899c-4bee-952b-ec853ddc4a92"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":8500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":415,"monthly_call_quota":102000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1270,"monthly_call_quota":410000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3800,"monthly_call_quota":1800000,"rps_limit":48,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/craps-api"}