---
title: "Changes to Get perps positions for an agent in a competition"
method: GET
path: "/api/competitions/{competitionId}/agents/{agentId}/perps/positions"
---

# Changes to Get perps positions for an agent in a competition

`GET /api/competitions/{competitionId}/agents/{agentId}/perps/positions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 50 revisions.

- **2026-01-05** `6000445fc8d4` — 4 breaking
- **2025-11-17** `3a7a1087e73c` — 2 info
- **2025-09-23** `7aef801f8f51` — 1 info
- **2025-06-30** `e0d0a475d4b6` — 1 breaking

## Changes

- **2026-01-05** `6000445fc8d4` — 4 breaking
  - the response property `positions/items/averagePrice` became nullable for the status `200`
  - the response property `positions/items/collateral` became nullable for the status `200`
  - the response property `positions/items/leverage` became nullable for the status `200`
  - the response property `positions/items/pnlPercentage` became nullable for the status `200`
- **2025-11-17** `3a7a1087e73c` — 2 info
  - api tag `Competition` added
  - api tag `Competitions` removed
- **2025-09-23** `7aef801f8f51` — 1 info
  - endpoint added
- **2025-06-30** `e0d0a475d4b6` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/recallnet/apis/trading-simulator-api/docs/api/competitions/:competitionId/agents/:agentId/perps/positions/get.md) · [API](https://skmtc.dev/recallnet/apis/trading-simulator-api.md) · [Page](https://skmtc.dev/recallnet/apis/trading-simulator-api/changes/api/competitions/:competitionId/agents/:agentId/perps/positions/get)