No Limit Holdem API Access Summary

API documentation for integrating with the NL Hold'em game AI service.

Overview

The Strategy API offers a set of endpoints that receive a poker game context and return a complete action strategy, along with additional information relevant to that situation. The following section describes everything required to make a request to the service. For guidance on how to construct the game context, please refer to the No-Limit Texas Hold’em Game Context documentation.

Authentication and Base URL

All API requests require authentication using a Bearer token included in the Authorization header:

Authorization: Bearer YOUR_API_KEY

The base URLs and authorization tokens are provided separately.

Endpoint

Health check

The endpoint is used exclusively to confirm that the service is available and running.

Endpoint: GET /health

It is a simple GET request that returns the following structure:

{
    "status": "OK",
    "commit_hash": "e07a5c00e7949a8cb84e4711c1df6c5fa141df1b",
    "build_num": "1925",
    "build_time": "1970-01-01T00:00:00Z"
}

Get Strategy Recommendation

Request AI strategy recommendation for the current game state.

Endpoint: POST /lookup

Request Headers:

Request Body

{
    request_id: str
    hand: GameHand
}

Success Response

{
    "request": {...},
    "solution_information": {...},
    "strategy": {...},
    "suggested_action": {...},
    "strategy_profile": null
}

Request and response fields

For detailed information about response and request fields, please refer to No Limit Holdem API documentation page.

Access Error Response

{
    "detail": "<message>"
}

For game state error handling please refer to