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

# GET /v2/trade/perps/fills: Fills

> The user's Polymarket Perps fills, filtered by instrument and time. Scope perps.read.

> [!NOTE]
>
> Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use [request signing examples](https://docs.bravadotrade.com/authentication-examples.md).

The user's fills. Scope `perps.read`.

```text theme={null}
GET https://partner-api.bravadotrade.com/v2/trade/perps/fills
```

### Query Parameters

**instrument\_id** `integer`

Only fills on this instrument.

**start\_timestamp** `integer`

Epoch milliseconds, inclusive.

**end\_timestamp** `integer`

Epoch milliseconds.

**sort** `string`

`asc` or `desc`.

**cursor** `string`

Opaque. Pass back the previous page's `next_cursor`.

`limit` is not supported here, and is refused with `400 INVALID_BODY`.

### Response

The user's fills. When there are more, pass the page's `next_cursor` back as `cursor`.

### Example

```bash cURL theme={null}
curl -G https://partner-api.bravadotrade.com/v2/trade/perps/fills \
  -H "X-BRAVADO-API-KEY: $BRAVADO_API_KEY" \
  -H "X-BRAVADO-TIMESTAMP: <unix-ms>" \
  -H "X-BRAVADO-SIGNATURE: <signature-for-this-request>" \
  -d instrument_id=1 \
  -d start_timestamp=1792713600000 \
  -d sort=desc
```

## Related

* [`GET /v2/trade/perps/funding`](https://docs.bravadotrade.com/api/trade/perps/funding) for funding payments.
* [`GET /v2/trade/perps/orders`](https://docs.bravadotrade.com/api/trade/perps/orders) for open orders, or one order.


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