API Reference

NexusGTO API

Integrate 6-player GTO strategies directly into your poker training platform, poker room, or coaching tool. Preflop lookups, real-time postflop solving, and hand history parsing, all via a simple REST API.

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/v1

All 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.

API keys are currently issued manually during the beta period. Request access below to get started.

Preflop Lookup

GET/v1/preflop/{position}

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

NameTypeDescription
positionstringOne of: UTG, MP, CO, BTN, SB, BB

Query Parameters

NameTypeDescription
scenariostringAction sequence leading to this node. Default: "open" (first to act)
stack_depthnumberStack 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

POST/v1/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

POST/v1/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.

PlanPricePreflopPostflop
DeveloperFree1,000 req/day-
Starter$299/mo50,000 req/day500 solves/day
Pro$999/moUnlimited5,000 solves/day
Enterprise$4,999/moUnlimitedUnlimited + 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