> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pacifica.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Order Strategy Timeline

> This endpoint allows users to get the lifecycle, order, and trade events of one order strategy.

```http theme={null}
GET /api/v1/order_strategies/{strategy_id}/timeline
```

Returns the strategy's lifecycle changes, the orders it placed, and the trades of those orders, oldest first.

#### Query Parameters

<table><thead><tr><th width="176">Field</th><th width="98">Type</th><th width="95">Need</th><th width="189">Description</th><th>Example</th></tr></thead><tbody><tr><td>`"strategy_id"`</td><td>string</td><td>required</td><td>Strategy ID (UUID), in the path</td><td>`0f8e7c2a-...`</td></tr><tr><td>`"account"`</td><td>string</td><td>required</td><td>Account address that owns the strategy</td><td>`42trU9A5...`</td></tr></tbody></table>

```
/api/v1/order_strategies/0f8e7c2a-4b1d-4e5f-9a3b-2c1d0e9f8a7b/timeline?account=42trU9A5...
```

#### Response

* Status 200: Successfully retrieved the timeline

```json theme={null}
{
  "success": true,
  "data": [
    {
      "kind": "lifecycle",
      "lifecycle": "active",
      "terminal_reason": null,
      "created_at": "2026-10-20T08:00:00Z"
    },
    {
      "kind": "order",
      "order_id": 315979358,
      "order_status": "filled",
      "order_type": "market",
      "price": "66012",
      "amount": "0.01",
      "created_at": "2026-10-20T09:14:02Z"
    },
    {
      "kind": "trade",
      "order_id": 315979358,
      "price": "66012",
      "amount": "0.01",
      "created_at": "2026-10-20T09:14:02Z"
    },
    {
      "kind": "lifecycle",
      "lifecycle": "completed",
      "terminal_reason": null,
      "created_at": "2026-10-20T09:14:02Z"
    }
  ],
  "error": null,
  "code": null
}
```

Each entry has a `kind` and the fields for that kind:

| `kind` | Fields |
| - | - |
| `lifecycle` | `lifecycle`, `terminal_reason`, `created_at` |
| `order` | `order_id`, `order_status` (`open`, `partially_filled`, `filled`, `cancelled`, `rejected`), `order_type`, `price`, `amount`, `created_at` |
| `trade` | `order_id`, `price`, `amount`, `created_at` |

`created_at` is an ISO 8601 timestamp.

> [!NOTE]
>
> Timeline `lifecycle` values are more detailed than the `lifecycle` field of a strategy: `pending`, `active` (waiting for a trigger), `running`, `paused`, `completed`, `cancelled`, `trigger_failed`, `expired`, and `failed`.

* Status 404: Strategy not found, or it belongs to another account
* Status 500: Internal server error

#### Code Example (Python)

```python theme={null}
import requests

response = requests.get(
    "/api/v1/order_strategies/0f8e7c2a-4b1d-4e5f-9a3b-2c1d0e9f8a7b/timeline?account=42trU9A5...",
    headers={"Accept": "*/*"},
)

data = response.json()
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.