---
title: "Get Database Positions"
method: GET
path: "/archived-bots/{db_path}/positions"
tags: ["Archived Bots"]
---

# Get Database Positions

`GET /archived-bots/{db_path}/positions`

Get paginated position history from an archived bot database.

Retrieves position records tracking the bot's open and closed positions over time.
Positions aggregate multiple orders and trades into logical position entries.

Use this endpoint to analyze position sizing, holding periods, or track the
bot's exposure over time.

## Path parameters

- `db_path` string, required

## Query parameters

- `limit` integer — Maximum number of positions to return (1-1000)
- `offset` integer — Number of positions to skip for pagination

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2025-12-20** `1005bcd47280` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hummingbot/apis/hummingbot-api/changes/archived-bots/:db_path/positions/get.md)

---

[API](https://skmtc.dev/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.dev/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/revisions/cb6b6935c8e2/schema)