> For the complete documentation index, see [llms.txt](https://docs.overtime.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overtime.io/overtime-v2-integration/overtime-v2-liquidity-protected.md).

# Overtime V2 liquidity (protected)

Get the max stake and available liquidity for every open position (pre-game and live) on a network.

## REST API <a href="#rest-api" id="rest-api"></a>

<mark style="color:green;">`GET`</mark>  `https://api.overtime.io/overtime-v2/networks/{{networkId}}/liquidity`

See liquidity API endpoint with request/response examples under [Postman documentation](https://documenter.getpostman.com/view/1435701/2sA3XY5Hao#9fcc2bb5-9128-47f8-a501-e5bcd32f3e6d).

All requests to this route must include a valid API key for authentication. The API key should be provided in the request header as `x-api-key`.

{% hint style="info" %}
Access to the Overtime API is restricted and requires an approved API key.\
\
API keys are issued only to teams or organizations that can clearly demonstrate how their intended use of the API delivers meaningful value to Overtime, its users, or its ecosystem. Requests must include a concrete description of the proposed use case, scope, and anticipated impact.\
\
**The Overtime API is not intended for experimental, hobbyist, or small personal projects. Requests that do not meet these criteria will not be approved.**
{% endhint %}

{% hint style="warning" %}
Data refreshes about every 5 minutes. A position missing from the response has no liquidity data, for example because its odds are zero.
{% endhint %}

### Example Request

<https://api.overtime.io/overtime-v2/networks/10/liquidity>

### Example Response

{% tabs %}
{% tab title="200 OK" %}

```json
{
  "0x3430343338333700000000000000000000000000000000000000000000000000|9016|0|0|0|0": {
    "maxStake": 1250.5,
    "liquidity": 8400,
    "lastUpdate": 1718667622606
  },
  "0x3430343338333700000000000000000000000000000000000000000000000000|9016|10002|0|-150|1": {
    "maxStake": 600,
    "liquidity": 3200,
    "lastUpdate": 1718667622606
  }
}

```

{% endtab %}
{% endtabs %}

### Response Key

Each key identifies a single position and is made of pipe-separated (`|`) values: `gameId|sportId|typeId|playerId|line|position`

<table><thead><tr><th width="125">Name</th><th width="100">Type</th><th>Description</th></tr></thead><tbody><tr><td>gameId</td><td>string</td><td>Game ID (bytes32 hex)</td></tr><tr><td>sportId</td><td>number</td><td>Sport / league ID (sub-league ID for child leagues), see <a href="/overtime-v2-integration/overtime-v2-sports.md">Sports</a></td></tr><tr><td>tupyId</td><td>number</td><td>Market type ID, see <a href="/overtime-v2-integration/overtime-v2-market-types.md">Market Types</a></td></tr><tr><td>playerId</td><td>number</td><td>Player ID for player props, <code>0</code> otherwise</td></tr><tr><td>line</td><td>number</td><td>Market line <strong>multiplied by 100</strong> (e.g. <code>-1.5</code> → <code>-150</code>, <code>215.5</code> → <code>21550</code>)</td></tr><tr><td>position</td><td>number</td><td>Position index on the market (e.g. <code>0</code> home, <code>1</code> away, <code>2</code> draw)</td></tr></tbody></table>

### Response Parameters <a href="#response-parameters" id="response-parameters"></a>

<table><thead><tr><th width="125">Name</th><th width="100">Type</th><th>Description</th></tr></thead><tbody><tr><td>maxStake</td><td>number</td><td>Max stake allowed on this position, in USDC</td></tr><tr><td>liquidity</td><td>number</td><td>Available liquidity for this position, in USDC</td></tr><tr><td>lastUpdate</td><td>number</td><td>Timestamp (ms) of the last refresh</td></tr></tbody></table>