Overview
The NexusGTO API provides programmatic access to the world's first 6-player poker solver. All endpoints accept and return JSON. The base URL for all requests is:
https://api.nexusgto.com/v1All API responses follow a consistent envelope format:
{
"success": true,
"data": { ... },
"meta": {
"request_id": "req_abc123",
"latency_ms": 42
}
}Authentication
Authenticate requests by including your API key in the Authorization header:
curl https://api.nexusgto.com/v1/preflop/UTG \
-H "Authorization: Bearer ngto_sk_your_api_key"API keys are scoped to your organization and can be rotated at any time from the dashboard. Keys prefixed with ngto_sk_test_ hit the sandbox environment; ngto_sk_live_ hits production.
Preflop Lookup
Returns the complete GTO strategy for a given position at the specified decision point. Response includes 169 hands with per-action frequencies and optional EV data.
Path Parameters
| Name | Type | Description |
|---|---|---|
| position | string | One of: UTG, MP, CO, BTN, SB, BB |
Query Parameters
| Name | Type | Description |
|---|---|---|
| scenario | string | Action sequence leading to this node. Default: "open" (first to act) |
| stack_depth | number | Stack depth in big blinds. Default: 100 |
Example Request
curl https://api.nexusgto.com/v1/preflop/UTG \
-H "Authorization: Bearer ngto_sk_test_demo"Example Response
{
"success": true,
"data": {
"position": "UTG",
"actions": ["fold", "call", "raise_2.2", "raise_3.5", "allin"],
"strategies": [
{
"hand": "AA",
"actions": [
{ "action": "raise_2.2", "frequency": 0.85 },
{ "action": "raise_3.5", "frequency": 0.12 },
{ "action": "allin", "frequency": 0.03 }
]
},
{
"hand": "AKs",
"actions": [
{ "action": "raise_2.2", "frequency": 0.92 },
{ "action": "raise_3.5", "frequency": 0.08 }
]
}
]
}
}Postflop Solve
Runs a real-time postflop CFR solve for the given board, ranges, and pot geometry. Returns strategies for all active positions. Typical latency: 50–200ms depending on tree complexity.
Request Body
{
"board": "AhKsTd",
"positions": ["BTN", "BB"],
"pot": 6.5,
"stacks": { "BTN": 97, "BB": 93.5 },
"ranges": {
"BTN": { "AA": 1.0, "AKs": 0.92, "AKo": 0.85 },
"BB": { "AA": 0.15, "AKs": 0.70, "72o": 0.02 }
}
}Example Response
{
"success": true,
"data": {
"BTN": {
"strategies": [
{
"hand": "AA",
"actions": [
{ "action": "check", "frequency": 0.35 },
{ "action": "raise", "frequency": 0.65, "size": "75%" }
]
}
]
},
"BB": { "strategies": [...] }
},
"meta": { "latency_ms": 87, "iterations": 500 }
}Hand History Parse
Parses a hand history file or text block and returns structured data including player actions, pot sizes, and board cards. Supports PokerStars, 888poker, GGPoker, and Winamax formats.
Request Body
{
"text": "PokerStars Hand #123456789: ..."
}Or send a file via multipart/form-data with the file in the file field.
API Pricing
API access is billed separately from the consumer product. All plans include preflop lookups. Postflop solving is metered.
| Plan | Price | Preflop | Postflop |
|---|---|---|---|
| Developer | Free | 1,000 req/day | - |
| Starter | $299/mo | 50,000 req/day | 500 solves/day |
| Pro | $999/mo | Unlimited | 5,000 solves/day |
| Enterprise | $4,999/mo | Unlimited | Unlimited + SLA |
All plans include dedicated support and 99.9% uptime SLA (Pro and above). Enterprise includes custom bet sizing trees, dedicated compute, and a named account manager.
Request API Access
The NexusGTO API is currently in private beta. We're onboarding poker training platforms, poker rooms, and coaching tools on a rolling basis.
Get started with the API
Tell us about your platform and use case. We'll get back to you within 24 hours with API credentials and onboarding support.
Request API Access