---
title: "Get Derivatives Positions"
method: GET
path: "/v1/derivatives-positions"
tags: ["derivatives"]
---

# Get Derivatives Positions

`GET /v1/derivatives-positions`

## Request

- Base URL: `https://api.exchange.bullish.com/trading-api`
- URL: `https://api.exchange.bullish.com/trading-api/v1/derivatives-positions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v1/derivatives-positions/get.ts> (a function with typed inputs; its response is checked against the schema)

Get derivatives positions

## Query parameters

- `tradingAccountId` string: unique trading account ID
- `symbol` string: market symbol. E.g. `BTCUSDC`
- `marketType` 'SPOT' | 'PERPETUAL' | 'DATED_FUTURE' | 'OPTION': market type can have the following string values `"SPOT"`, `"PERPETUAL"`, `"DATED_FUTURE"`, `"OPTION"`
- `optionType` 'CALL' | 'PUT': option type can have the following string values `"CALL"`, `"PUT"`
- `sort` 'marketType' | 'optionType': Sorting parameter that can have the following string values `"marketType"`, `"optionType"`

## Response `200`

OK

- DerivativesPositionResponse[]
  - `tradingAccountId` string: unique trading account ID
  - `symbol` string: market symbol. E.g. `BTCUSDC`
  - `side` 'BUY' | 'SELL'
  - `quantity` string: see [asset value](/rest/general/price-quantity-precision) format
  - `notional` string: see [asset value](/rest/general/price-quantity-precision) format
  - `entryNotional` string: see [asset value](/rest/general/price-quantity-precision) format
  - `mtmPnl` string: see [asset value](/rest/general/price-quantity-precision) format
  - `reportedMtmPnl` string: see [asset value](/rest/general/price-quantity-precision) format
  - `reportedFundingPnl` string: see [asset value](/rest/general/price-quantity-precision) format
  - `realizedPnl` string: see [asset value](/rest/general/price-quantity-precision) format
  - `settlementAssetSymbol` string: Settlement Asset Symbol
  - `createdAtDatetime` string, date-time: ISO 8601 with millisecond as string
  - `createdAtTimestamp` string, string: unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string
  - `updatedAtDatetime` string, date-time: ISO 8601 with millisecond as string
  - `updatedAtTimestamp` string, string: unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string
  - `greeks` PositionGreeks: Position greeks for derivative instruments
    - `delta` string: The sensitivity of the portfolio's value to a change in the underlying price, expressed in the base asset (e.g., BTC, ETH)
    - `gamma` string: The rate of change in Delta per 1 USDC move in the underlying price, expressed in the base asset
    - `theta` string: The rate at which the portfolio's value changes as it approaches expiration, expressed in $/day
    - `vega` string: The change in portfolio value for a 1% (percentage point) absolute change in implied volatility, expressed in dollars ($)

## Other responses

- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bullish/apis/bullish-trading-api.md) - [All operations](https://skmtc.dev/bullish/apis/bullish-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bullish/apis/bullish-trading-api/revisions/df5d69ccedcf?raw)