Returns the current signed position (`position_size`) per coin for a user, reconstructed from the latest funding snapshot per `(user, coin)` pair. Positive `position_size` indicates a long position, negative indicates a short. Each row also carries the funding rate applied at that snapshot and the snapshot timestamp.
Filter by `coin` for a single coin, or `dex` to return only positions on one venue (`xyz`, `cash`, etc.).
Caveat: positions opened and fully closed between two funding snapshots are never observed during settlement and will not appear here.
**Query Parameters:**
- **user** (Required): Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
- **coin**: Hyperliquid coin id. Perps: `BTC`. Spot: `@N` (`@107`). Builder DEXs: `xyz:SILVER`. Outcome coins (`#N`) are rejected — use `/v1/hyperliquid/outcomes/*`.<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
- **dex**: DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (`xyz`, `cash`, …). Outcome markets are served separately under `/v1/hyperliquid/outcomes/*`.<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted.
- **limit**: Number of items* returned in a single request.<br>*Plan restricted.
- **page**: Page number to fetch.<br>Empty `data` array signifies end of results.
**Responses:**
- **200** (Success): Successful Response
- Content-Type: `application/json`
- **Response Properties:**
- **request_time**: ISO 8601 datetime string
- **Example:**
```json
{
"data": [
{
"user": "string",
"coin": "string",
"market_name": "string",
"last_update": "2026-06-16 03:40:59",
"dex": "string",
"position_size": 1.5,
"funding_rate": 1.5
}
],
"statistics": {
"elapsed": 1.5,
"rows_read": 1.5,
"bytes_read": 1.5
},
"pagination": {
"previous_page": 1,
"current_page": 1
},
"request_time": "string",
"results": 1.5,
"duration_ms": 1.5
}
```
- **400**: Client side error
- Content-Type: `application/json`
- **Response Properties:**
- **Example:**
```json
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}
```
- **401**: Authentication failed
- Content-Type: `application/json`
- **Response Properties:**
- **Example:**
```json
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}
```
- **403**: Forbidden
- Content-Type: `application/json`
- **Response Properties:**
- **Example:**
```json
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}
```
- **404**: Not found
- Content-Type: `application/json`
- **Response Properties:**
- **Example:**
```json
{
"status": "unknown_type",
"code": "authentication_failed",
"message": "string"
}
```
- **500**: Server side error
- Content-Type: `application/json`
- **Response Properties:**
- **Example:**
```json
{
"status": "unknown_type",
"code": "bad_database_response",
"message": "string"
}
```