Files

T

GLaDOS 2d608bd891 docs: sync Polymarket docs updates 2026-07-13 - add 90 new pages incl. Perps section

2026-07-13 01:40:25 +02:00

30 KiB

Raw Permalink Blame History

Documentation Index

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

Account Management

Monitor balances, positions, and account history

Use account reads to turn Perps activity into a reliable local view of account health, trading history, and performance.

Account management workflows require an [authenticated session](/perps/authenticated-sessions).

Review Account Health

Start with the account's current collateral and exposure when showing portfolio health or checking whether a trade fits the account's risk state.

Balances

Use balances to show collateral by asset and account value.

```ts theme={null} const balances = await session.fetchBalances(); ```

Use this shape to render collateral balances and account value by asset.

<Accordion title="Output: PerpsBalance[]">
  <CodeGroup>
    ```ts Type theme={null}
    type PerpsBalance = {
      asset: string;
      balance: string;
      value: string;
    };

    type Output = PerpsBalance[];
    ```

    ```json Example theme={null}
    [
      {
        "asset": "pUSD",
        "balance": "1000",
        "value": "1000"
      }
    ]
    ```
  </CodeGroup>
</Accordion>

```python theme={null} balances = await session.fetch_balances() ```

Use this shape to render collateral balances and account value by asset.

<Accordion title="Output: tuple[PerpsBalance, ...]">
  ```json theme={null}
  [
    {
      "asset": "pUSD",
      "balance": "1000",
      "value": "1000"
    }
  ]
  ```
</Accordion>

```bash theme={null} curl "https://api.perpetuals.polymarket.com/v1/account/balances" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " ```

Use this shape to render collateral balances and account value by asset.

<Accordion title="Output: Balances">
  ```json theme={null}
  [
    {
      "asset": "pUSD",
      "balance": "1000",
      "value": "1000"
    }
  ]
  ```
</Accordion>

Portfolio

Use the portfolio to show open positions, margin usage, withdrawable collateral, and liquidation state.

```ts theme={null} const portfolio = await session.fetchPortfolio(); ```

Use this shape to render positions, margin usage, and liquidation state.

<Accordion title="Output: PerpsPortfolio">
  <CodeGroup>
    ```ts Type theme={null}
    type PerpsPortfolio = {
      positions: Array<{
        instrumentId: number;
        symbol: string;
        size: string;
        entryPrice: string;
        leverage: number;
        cross: boolean;
        initialMargin: string;
        maintenanceMargin: string;
        positionValue: string;
        liquidationPrice: string;
        unrealizedPnl: string;
        returnOnEquity: string;
        cumulativeFunding: string;
      }>;
      margin: {
        totalAccountValue: string;
        totalInitialMargin: string;
        totalMaintenanceMargin: string;
        totalPositionValue: string;
      };
      withdrawable: string;
      inLiquidation: boolean;
      timestamp: number;
    };

    type Output = PerpsPortfolio;
    ```

    ```json Example theme={null}
    {
      "positions": [
        {
          "instrumentId": 1,
          "symbol": "BTC-PERP",
          "size": "0.01",
          "entryPrice": "65000",
          "leverage": 5,
          "cross": false,
          "initialMargin": "130",
          "maintenanceMargin": "65",
          "positionValue": "650",
          "liquidationPrice": "52000",
          "unrealizedPnl": "0",
          "returnOnEquity": "0",
          "cumulativeFunding": "0"
        }
      ],
      "margin": {
        "totalAccountValue": "1000",
        "totalInitialMargin": "130",
        "totalMaintenanceMargin": "65",
        "totalPositionValue": "650"
      },
      "withdrawable": "870",
      "inLiquidation": false,
      "timestamp": 1767000000000
    }
    ```
  </CodeGroup>
</Accordion>

```python theme={null} portfolio = await session.fetch_portfolio() ```

Use this shape to render positions, margin usage, and liquidation state.

<Accordion title="Output: PerpsPortfolio">
  ```json theme={null}
  {
    "positions": [
      {
        "instrument_id": 1,
        "symbol": "BTC-PERP",
        "size": "0.01",
        "entry_price": "65000",
        "leverage": 5,
        "cross": false,
        "initial_margin": "130",
        "maintenance_margin": "65",
        "position_value": "650",
        "liquidation_price": "52000",
        "unrealized_pnl": "0",
        "return_on_equity": "0",
        "cumulative_funding": "0"
      }
    ],
    "margin": {
      "total_account_value": "1000",
      "total_initial_margin": "130",
      "total_maintenance_margin": "65",
      "total_position_value": "650"
    },
    "withdrawable": "870",
    "in_liquidation": false,
    "timestamp": 1767000000000
  }
  ```
</Accordion>

```bash theme={null} curl "https://api.perpetuals.polymarket.com/v1/account/portfolio" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " ```

Use this shape to render positions, margin usage, and liquidation state.

<Accordion title="Output: Portfolio">
  ```json theme={null}
  {
    "positions": [
      {
        "instrument_id": 1,
        "symbol": "BTC-PERP",
        "size": "0.01",
        "entry_price": "65000",
        "leverage": 5,
        "cross": false,
        "initial_margin": "130",
        "maintenance_margin": "65",
        "position_value": "650",
        "liquidation_price": "52000",
        "unrealized_pnl": "0",
        "return_on_equity": "0",
        "cumulative_funding": "0"
      }
    ],
    "margin": {
      "total_account_value": "1000",
      "total_initial_margin": "130",
      "total_maintenance_margin": "65",
      "total_position_value": "650"
    },
    "withdrawable": "870",
    "in_liquidation": false,
    "timestamp": 1767000000000
  }
  ```
</Accordion>

Account Stats

Use account stats to review trailing 7-day trading activity such as volume and maker share. Stats are cached by UTC day and may be stale by up to 24 hours. See Fee Metrics for what each metric means.

```ts theme={null} const stats = await session.fetchStats(); ```

Use this shape to render trailing 7-day volume and maker-share activity.

<Accordion title="Output: PerpsAccountStats">
  <CodeGroup>
    ```ts Type theme={null}
    type PerpsAccountStats = {
      volume7d: string;
      takerVolume7d: string;
      makerVolume7d: string;
      accountMakerShare7d: string;
      entityMakerShare7d?: string;
      entityId?: number;
      entityName?: string;
    };
    ```

    ```json Example theme={null}
    {
      "volume7d": "5000000",
      "takerVolume7d": "3500000",
      "makerVolume7d": "1500000",
      "accountMakerShare7d": "0.35",
      "entityMakerShare7d": "0.40",
      "entityId": 42,
      "entityName": "desk"
    }
    ```
  </CodeGroup>
</Accordion>

```python theme={null} stats = await session.fetch_stats() ```

Use this shape to render trailing 7-day volume and maker-share activity.

<Accordion title="Output: PerpsAccountStats">
  ```json theme={null}
  {
    "volume_7d": "5000000",
    "taker_volume_7d": "3500000",
    "maker_volume_7d": "1500000",
    "account_maker_share_7d": "0.35",
    "entity_maker_share_7d": "0.40",
    "entity_id": 42,
    "entity_name": "desk"
  }
  ```
</Accordion>

```bash theme={null} curl "https://api.perpetuals.polymarket.com/v1/account/stats" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " ```

Use this shape to render trailing 7-day volume and maker-share activity.

<Accordion title="Output: Account Stats">
  ```json theme={null}
  {
    "volume_7d": "5000000",
    "taker_volume_7d": "3500000",
    "maker_volume_7d": "1500000",
    "account_maker_share_7d": "0.35",
    "entity_maker_share_7d": "0.40",
    "entity_id": 42,
    "entity_name": "desk"
  }
  ```
</Accordion>

Reconcile Orders and Fills

Use order state and fills to connect submitted orders with resting liquidity, executions, fees, and exposure changes.

Open Orders

Use open orders to show what is still resting on the book.

```ts theme={null} const openOrders = await session.fetchOpenOrders({ instrumentId: instrument.id, }); ```

Use this shape to render resting orders that can still fill or be canceled.

<Accordion title="Output: PerpsOrder[]">
  ```json theme={null}
  [
    {
      "id": 1234567890,
      "instrumentId": 1,
      "buy": true,
      "price": "65000",
      "quantity": "0.01",
      "timeInForce": "gtc",
      "postOnly": false,
      "status": "open",
      "restingQuantity": "0.01",
      "filledQuantity": "0",
      "createdTimestamp": 1767000010000,
      "updatedTimestamp": 1767000010000
    }
  ]
  ```
</Accordion>

```python theme={null} open_orders = await session.fetch_open_orders( instrument_id=instrument.id, ) ```

Use this shape to render resting orders that can still fill or be canceled.

<Accordion title="Output: tuple[PerpsOrder, ...]">
  ```json theme={null}
  [
    {
      "id": 1234567890,
      "instrument_id": 1,
      "side": "BUY",
      "price": "65000",
      "quantity": "0.01",
      "time_in_force": "gtc",
      "post_only": false,
      "status": "open",
      "resting_quantity": "0.01",
      "filled_quantity": "0",
      "created_at": 1767000010000,
      "updated_at": 1767000010000
    }
  ]
  ```
</Accordion>

```bash theme={null} curl -G "https://api.perpetuals.polymarket.com/v1/account/open-orders" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " \ --data-urlencode "instrument_id=1" ```

Use this shape to render resting orders that can still fill or be canceled.

<Accordion title="Output: Open Orders">
  ```json theme={null}
  [
    {
      "order_id": 1234567890,
      "instrument_id": 1,
      "buy": true,
      "price": "65000",
      "quantity": "0.01",
      "tif": "gtc",
      "post_only": false,
      "ro": false,
      "status": "open",
      "resting_quantity": "0.01",
      "filled_quantity": "0",
      "created_timestamp": 1767000010000,
      "updated_timestamp": 1767000010000
    }
  ]
  ```
</Accordion>

Orders

Use orders to inspect the latest known state for submitted orders.

```ts theme={null} const orders = await session.fetchOrders({ instrumentId: instrument.id, }); ```

Use this shape to reconcile submitted orders with their latest known state.

<Accordion title="Output: PerpsOrder[]">
  ```json theme={null}
  [
    {
      "id": 1234567890,
      "instrumentId": 1,
      "buy": true,
      "price": "65000",
      "quantity": "0.01",
      "timeInForce": "ioc",
      "postOnly": false,
      "status": "filled",
      "restingQuantity": "0",
      "filledQuantity": "0.01",
      "createdTimestamp": 1767000010000,
      "updatedTimestamp": 1767000010500
    }
  ]
  ```
</Accordion>

```python theme={null} orders = await session.fetch_orders( instrument_id=instrument.id, ) ```

Use this shape to reconcile submitted orders with their latest known state.

<Accordion title="Output: tuple[PerpsOrder, ...]">
  ```json theme={null}
  [
    {
      "id": 1234567890,
      "instrument_id": 1,
      "side": "BUY",
      "price": "65000",
      "quantity": "0.01",
      "time_in_force": "ioc",
      "post_only": false,
      "status": "filled",
      "resting_quantity": "0",
      "filled_quantity": "0.01",
      "created_at": 1767000010000,
      "updated_at": 1767000010500
    }
  ]
  ```
</Accordion>

```bash theme={null} curl -G "https://api.perpetuals.polymarket.com/v1/account/orders" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " \ --data-urlencode "instrument_id=1" ```

Use this shape to reconcile submitted orders with their latest known state.

<Accordion title="Output: Orders">
  ```json theme={null}
  [
    {
      "order_id": 1234567890,
      "instrument_id": 1,
      "buy": true,
      "price": "65000",
      "quantity": "0.01",
      "tif": "ioc",
      "post_only": false,
      "ro": false,
      "status": "filled",
      "resting_quantity": "0",
      "filled_quantity": "0.01",
      "created_timestamp": 1767000010000,
      "updated_timestamp": 1767000010500
    }
  ]
  ```
</Accordion>

Fills

Use fills to reconcile executions, fees, realized PnL, and exposure changes.

```ts theme={null} const fills = session.listFills({ start: Date.now() - 24 * 60 * 60 * 1000, end: Date.now(), });

for await (const page of fills) {
  // page.items: PerpsAccountFill[]
}
```

Each page returns execution records you can use to reconcile fees, PnL, and exposure.

<Accordion title="Output: PerpsAccountFill[]">
  ```json theme={null}
  [
    {
      "tradeId": 987654321,
      "orderId": 1234567890,
      "instrumentId": 1,
      "side": "long",
      "price": "65000",
      "quantity": "0.01",
      "taker": true,
      "fee": "0.26",
      "feeAsset": "pUSD",
      "previousSize": "0",
      "previousEntryPrice": "0",
      "pnl": "0",
      "liquidation": false,
      "timestamp": 1767000010500,
      "hash": "0x1111111111111111111111111111111111111111111111111111111111111111"
    }
  ]
  ```
</Accordion>

```python theme={null} from datetime import datetime, timedelta, timezone

end = datetime.now(timezone.utc)
start = end - timedelta(days=1)

fills = session.list_fills(start=start, end=end)

async for page in fills:
    # page.items: tuple[PerpsFill, ...]
    pass
```

Each page returns execution records you can use to reconcile fees, PnL, and exposure.

<Accordion title="Output: tuple[PerpsFill, ...]">
  ```json theme={null}
  [
    {
      "trade_id": 987654321,
      "order_id": 1234567890,
      "instrument_id": 1,
      "side": "long",
      "price": "65000",
      "quantity": "0.01",
      "taker": true,
      "fee": "0.26",
      "fee_asset": "pUSD",
      "previous_size": "0",
      "previous_entry_price": "0",
      "pnl": "0",
      "liquidation": false,
      "timestamp": 1767000010500,
      "hash": "0x1111111111111111111111111111111111111111111111111111111111111111"
    }
  ]
  ```
</Accordion>

```bash theme={null} curl -G "https://api.perpetuals.polymarket.com/v1/account/fills" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " \ --data-urlencode "start_timestamp=1766913600000" \ --data-urlencode "end_timestamp=1767000000000" ```

Use the response's `more` field to continue fetching older or newer records.

Each page returns execution records you can use to reconcile fees, PnL, and exposure.

<Accordion title="Output: Fills">
  ```json theme={null}
  {
    "data": [
      {
        "trade_id": 987654321,
        "order_id": 1234567890,
        "instrument_id": 1,
        "side": "long",
        "price": "65000",
        "quantity": "0.01",
        "taker": true,
        "fee": "0.26",
        "fee_asset": "pUSD",
        "previous_size": "0",
        "previous_entry_price": "0",
        "pnl": "0",
        "liquidation": false,
        "timestamp": 1767000010500,
        "hash": "0x1111111111111111111111111111111111111111111111111111111111111111"
      }
    ],
    "more": false
  }
  ```
</Accordion>

Reconcile Funding and Transfers

Funding, deposits, and withdrawals explain collateral changes that did not come from order fills. Use Fund Your Account for deposit and withdrawal submission workflows.

Funding Payments

Use funding payments to explain periodic funding debits or credits for a market.

```ts theme={null} const fundingPayments = session.listFundingPayments({ instrumentId: instrument.id, });

for await (const page of fundingPayments) {
  // page.items: PerpsAccountFundingPayment[]
}
```

Each page returns funding records you can use to explain non-trade PnL changes.

<Accordion title="Output: PerpsAccountFundingPayment[]">
  ```json theme={null}
  [
    {
      "instrumentId": 1,
      "size": "0.01",
      "fundingRate": "0.0001",
      "fundingAsset": "pUSD",
      "funding": "0.05",
      "timestamp": 1767000010000
    }
  ]
  ```
</Accordion>

```python theme={null} funding_payments = session.list_funding_payments( instrument_id=instrument.id, )

async for page in funding_payments:
    # page.items: tuple[PerpsFundingPayment, ...]
    pass
```

Each page returns funding records you can use to explain non-trade PnL changes.

<Accordion title="Output: tuple[PerpsFundingPayment, ...]">
  ```json theme={null}
  [
    {
      "instrument_id": 1,
      "size": "0.01",
      "funding_rate": "0.0001",
      "funding_asset": "pUSD",
      "funding": "0.05",
      "timestamp": 1767000010000
    }
  ]
  ```
</Accordion>

```bash theme={null} curl -G "https://api.perpetuals.polymarket.com/v1/account/funding" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " \ --data-urlencode "instrument_id=1" \ --data-urlencode "start_timestamp=1766913600000" \ --data-urlencode "end_timestamp=1767000000000" ```

Use the response's `more` field to continue fetching older or newer records.

Each page returns funding records you can use to explain non-trade PnL changes.

<Accordion title="Output: Funding Payments">
  ```json theme={null}
  {
    "data": [
      {
        "instrument_id": 1,
        "size": "0.01",
        "funding_rate": "0.0001",
        "funding_asset": "pUSD",
        "funding": "0.05",
        "timestamp": 1767000010000
      }
    ],
    "more": false
  }
  ```
</Accordion>

Deposits

Use deposits to reconcile collateral added to the Perps account.

```ts theme={null} const deposits = session.listDeposits();

for await (const page of deposits) {
  // page.items: PerpsDeposit[]
}
```

Each page returns deposits you can match against collateral arriving in the account.

<Accordion title="Output: PerpsDeposit[]">
  ```json theme={null}
  [
    {
      "hash": "0x2222222222222222222222222222222222222222222222222222222222222222",
      "asset": "pUSD",
      "amount": "100000000",
      "status": "confirmed",
      "from": "0x1234567890abcdef1234567890abcdef12345678",
      "to": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "confirmations": 12,
      "requiredConfirmations": 12,
      "createdTimestamp": 1767000010000,
      "confirmedTimestamp": 1767000030000
    }
  ]
  ```
</Accordion>

```python theme={null} deposits = session.list_deposits()

async for page in deposits:
    # page.items: tuple[PerpsDeposit, ...]
    pass
```

Each page returns deposits you can match against collateral arriving in the account.

<Accordion title="Output: tuple[PerpsDeposit, ...]">
  ```json theme={null}
  [
    {
      "hash": "0x2222222222222222222222222222222222222222222222222222222222222222",
      "asset": "pUSD",
      "amount": "100000000",
      "status": "confirmed",
      "from_address": "0x1234567890abcdef1234567890abcdef12345678",
      "to": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "confirmations": 12,
      "required_confirmations": 12,
      "created_at": 1767000010000,
      "confirmed_at": 1767000030000
    }
  ]
  ```
</Accordion>

```bash theme={null} curl -G "https://api.perpetuals.polymarket.com/v1/account/deposits" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " \ --data-urlencode "start_timestamp=1766913600000" \ --data-urlencode "end_timestamp=1767000000000" ```

Use the response's `more` field to continue fetching older or newer records.

Each page returns deposits you can match against collateral arriving in the account.

<Accordion title="Output: Deposits">
  ```json theme={null}
  {
    "data": [
      {
        "hash": "0x2222222222222222222222222222222222222222222222222222222222222222",
        "asset": "pUSD",
        "amount": "100000000",
        "status": "confirmed",
        "from": "0x1234567890abcdef1234567890abcdef12345678",
        "to": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
        "confirmations": 12,
        "required_confirmations": 12,
        "created_timestamp": 1767000010000,
        "confirmed_timestamp": 1767000030000
      }
    ],
    "more": false
  }
  ```
</Accordion>

Withdrawals

Use withdrawals to reconcile collateral leaving the Perps account.

```ts theme={null} const withdrawals = session.listWithdrawals();

for await (const page of withdrawals) {
  // page.items: PerpsWithdrawal[]
}
```

Each page returns withdrawals you can match against collateral leaving the account.

<Accordion title="Output: PerpsWithdrawal[]">
  ```json theme={null}
  [
    {
      "withdrawalId": 1234567891,
      "asset": "pUSD",
      "amount": "50000000",
      "fee": "1.5",
      "status": "confirmed",
      "to": "0x1234567890abcdef1234567890abcdef12345678",
      "hash": "0x3333333333333333333333333333333333333333333333333333333333333333",
      "confirmations": 12,
      "requiredConfirmations": 12,
      "createdTimestamp": 1767000010000,
      "confirmedTimestamp": 1767000030000
    }
  ]
  ```
</Accordion>

```python theme={null} withdrawals = session.list_withdrawals()

async for page in withdrawals:
    # page.items: tuple[PerpsWithdrawal, ...]
    pass
```

Each page returns withdrawals you can match against collateral leaving the account.

<Accordion title="Output: tuple[PerpsWithdrawal, ...]">
  ```json theme={null}
  [
    {
      "withdrawal_id": 1234567891,
      "asset": "pUSD",
      "amount": "50000000",
      "fee": "1.5",
      "status": "confirmed",
      "to": "0x1234567890abcdef1234567890abcdef12345678",
      "hash": "0x3333333333333333333333333333333333333333333333333333333333333333",
      "confirmations": 12,
      "required_confirmations": 12,
      "created_at": 1767000010000,
      "confirmed_at": 1767000030000
    }
  ]
  ```
</Accordion>

```bash theme={null} curl -G "https://api.perpetuals.polymarket.com/v1/account/withdrawals" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " \ --data-urlencode "start_timestamp=1766913600000" \ --data-urlencode "end_timestamp=1767000000000" ```

Use the response's `more` field to continue fetching older or newer records.

Each page returns withdrawals you can match against collateral leaving the account.

<Accordion title="Output: Withdrawals">
  ```json theme={null}
  {
    "data": [
      {
        "withdrawal_id": 1234567891,
        "asset": "pUSD",
        "amount": "50000000",
        "fee": "1.5",
        "status": "confirmed",
        "to": "0x1234567890abcdef1234567890abcdef12345678",
        "hash": "0x3333333333333333333333333333333333333333333333333333333333333333",
        "confirmations": 12,
        "required_confirmations": 12,
        "created_timestamp": 1767000010000,
        "confirmed_timestamp": 1767000030000
      }
    ],
    "more": false
  }
  ```
</Accordion>

Track Equity and PnL

Use equity and PnL history to explain how the account's value changed over time.

Equity

Use equity history to chart account value over time.

```ts theme={null} const equity = session.listEquityHistory({ interval: "1h", start: Date.now() - 7 * 24 * 60 * 60 * 1000, end: Date.now(), });

for await (const page of equity) {
  // page.items: PerpsEquityPoint[]
}
```

Each page returns points you can plot as account equity over time.

<Accordion title="Output: PerpsEquityPoint[]">
  ```json theme={null}
  [
    {
      "timestamp": 1767000000000,
      "equity": "1000"
    }
  ]
  ```
</Accordion>

```python theme={null} from datetime import datetime, timedelta, timezone

end = datetime.now(timezone.utc)
start = end - timedelta(days=7)

equity = session.list_equity_history(
    interval="1h",
    start=start,
    end=end,
)

async for page in equity:
    # page.items: tuple[PerpsEquityPoint, ...]
    pass
```

Each page returns points you can plot as account equity over time.

<Accordion title="Output: tuple[PerpsEquityPoint, ...]">
  ```json theme={null}
  [
    {
      "timestamp": 1767000000000,
      "equity": "1000"
    }
  ]
  ```
</Accordion>

```bash theme={null} curl -G "https://api.perpetuals.polymarket.com/v1/account/equity" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " \ --data-urlencode "interval=1h" \ --data-urlencode "start_timestamp=1766395200000" \ --data-urlencode "end_timestamp=1767000000000" ```

Use the response's `more` field to continue fetching older or newer records.

Each page returns points you can plot as account equity over time.

<Accordion title="Output: Equity">
  ```json theme={null}
  {
    "data": [[1767000000000, "1000"]],
    "more": false
  }
  ```
</Accordion>

PnL

Use PnL history to chart account profit and loss over the same interval.

```ts theme={null} const pnl = session.listPnlHistory({ interval: "1h", start: Date.now() - 7 * 24 * 60 * 60 * 1000, end: Date.now(), });

for await (const page of pnl) {
  // page.items: PerpsPnlPoint[]
}
```

Each page returns points you can plot as account PnL over time.

<Accordion title="Output: PerpsPnlPoint[]">
  ```json theme={null}
  [
    {
      "timestamp": 1767000000000,
      "pnl": "12.5"
    }
  ]
  ```
</Accordion>

```python theme={null} from datetime import datetime, timedelta, timezone

end = datetime.now(timezone.utc)
start = end - timedelta(days=7)

pnl = session.list_pnl_history(
    interval="1h",
    start=start,
    end=end,
)

async for page in pnl:
    # page.items: tuple[PerpsPnlPoint, ...]
    pass
```

Each page returns points you can plot as account PnL over time.

<Accordion title="Output: tuple[PerpsPnlPoint, ...]">
  ```json theme={null}
  [
    {
      "timestamp": 1767000000000,
      "pnl": "12.5"
    }
  ]
  ```
</Accordion>

```bash theme={null} curl -G "https://api.perpetuals.polymarket.com/v1/account/pnl" \ -H "polymarket-proxy: " \ -H "polymarket-secret: " \ --data-urlencode "interval=1h" \ --data-urlencode "start_timestamp=1766395200000" \ --data-urlencode "end_timestamp=1767000000000" ```

Use the response's `more` field to continue fetching older or newer records.

Each page returns points you can plot as account PnL over time.

<Accordion title="Output: PnL">
  ```json theme={null}
  {
    "data": [[1767000000000, "12.5"]],
    "more": false
  }
  ```
</Accordion>

30 KiB Raw Permalink Blame History

Documentation Index

Account Management

Review Account Health

Balances

Portfolio

Account Stats

Reconcile Orders and Fills

Open Orders

Orders

Fills

Reconcile Funding and Transfers

Funding Payments

Deposits

Withdrawals

Track Equity and PnL

Equity

PnL

30 KiB

Raw Permalink Blame History