List Orders

Retrieves a list of orders for the portfolio.

Request URL

GET https://ddp.definitive.fi/v2/portfolio/orders

Example

const json = await AuthHelpers.signAndSend({
  path: "/v2/portfolio/orders",
  method: "GET",
  queryParams: {
    limit: 20,
    cursor: "2025-06-10 07:12:31.80143", // optional cursor for pagination
  },
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET,
});
console.log(json);

Query Parameters

Parameter	Type	Required	Description	Default
limit	number	No	Maximum number of orders to return	20
cursor	string	No	Timestamp cursor for pagination (ISO date string)	null

Response

{
  orders: [
    {
      "contraAsset": {
        "id": "00000000-0000-0000-0000-000000000001",
        "name": "Hyperliquid",
        "address": "1000003",
        "ticker": "HYPE",
        "chain": {
          "name": "Hyperevm",
          "id": "999",
          "namespace": "eip155"
        }
      },
      "targetAsset": {
        "id": "00000000-0000-0000-0000-000000000002",
        "name": "SUPERMILK",
        "address": "0xfe69bc93b936b34d371defa873686c116c8488c2",
        "ticker": "MILK",
        "chain": {
          "name": "Hyperevm",
          "id": "999",
          "namespace": "eip155"
        }
      },
      "contraAmount": "27.54374",
      "targetAmount": "2678483.226019",
      "orderDate": "2025-06-05T07:36:49.045Z",
      "orderSide": "ORDER_SIDE_SELL",
      "rate": "35.43",
      "contraNotional": "975.8747082",
      "vaultId": "00000000-0000-0000-0000-000000000003",
      "status": "ORDER_STATUS_FILLED",
      "portfolioId": "00000000-0000-0000-0000-000000000004",
      "organizationName": "Example Organization",
      "closedAt": "2025-06-06T07:34:43.048Z",
      "orderId": "00000000-0000-0000-0000-000000000005",
      "size": "27.54374",
      "filledSize": "27.54374",
      "type": "ORDER_TYPE_TWAP",
      "acceptedAt": "2025-06-05T07:36:49.403Z",
      "maxPriceImpact": "0.05",
      "closeReason": "REASON_FULLY_FILLED"
    }
    // ... additional orders
  ],
  limit: number,
  nextCursor: string | null, // cursor for next page
  hasNextPage: boolean
}