# Boros positions of an account

Endpoint reference for the 1delta API. Index: https://docs.1delta.io/llms.txt · every endpoint: https://docs.1delta.io/llms-full.txt

---

### GET /v1/data/boros/positions

- operationId: `boros-positions`
- docs: https://docs.1delta.io/1delta-api/boros-positions/
- markdown: https://docs.1delta.io/1delta-api/boros-positions.md
- tags: Boros (Data)

Boros positions of an account

Open positions (main account, every collateral) with fixed APR, PnL, margin and Boros's own liquidation APR, plus the cross account of each collateral the wallet uses: cash, free margin and `healthRatio` (liquidation at ≤ 1). Source: the Boros indexer (seconds of lag).

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `account` | query | string | yes | The wallet (sends every transaction on Arbitrum) |

**Response `200`** — `{ account, positions[], crossAccounts[] }`

| Field | Type | Description |
| --- | --- | --- |
| `success` | true |  |
| `data` | object | Informational payload. `null` when the endpoint only builds calldata. |
| `actions` | null |  |

**Example response**

```json
{
  "success": true,
  "data": {}
}
```

**Response `400`** — Validation error

**Response `429`** — Rate limited. Unauthenticated callers share a per-IP budget; send an `x-api-key` header to lift it. Retry with exponential backoff.

**Response `500`** — Unexpected server error. Safe to retry with backoff.

**Response `502`** — An upstream data source or protocol origin failed (`error.code` is `ORIGIN_FAILED`). `error.details` carries the per-origin status. This is also what a missing or malformed required parameter currently returns, rather than a 400.
