List Order Fills

Retrieve fills on a given order. This endpoint returns a payload with a default limit of 100 if not specified by the user. The maximum allowed limit is 3000.

GET /v1/portfolios/{portfolio_id}/orders/{order_id}/fills

List Order Fills

cURL

curl --request GET \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/orders/{order_id}/fills

200

{
  "fills": [
    {
      "id": "dc376e5b-84fa-4bdf-9f13-537b1bde8fc3",
      "order_id": "ba1115bc-7b3c-4b6b-ae38-585f3ab59271",
      "product_id": "BTC-USD",
      "client_product_id": "BTC-USDC",
      "side": "BUY",
      "filled_quantity": "100",
      "filled_value": "25",
      "price": "140.91",
      "time": "2021-05-31T11:59:59.000Z",
      "commission": "5.55",
      "venue": "Coinbase",
      "venue_fees": "2.50",
      "ces_commission": "1.25",
      "product_type": "SPOT",
      "commission_detail_total": {
        "total_commission": "<string>",
        "client_commission": "<string>",
        "venue_commission": "<string>",
        "ces_commission": "<string>",
        "financing_commission": "<string>",
        "regulatory_commission": "<string>",
        "clearing_commission": "<string>"
      }
    }
  ],
  "pagination": {
    "next_cursor": "<string>",
    "sort_direction": "DESC",
    "has_next": true
  }
}

Use the Prime SDK or CLI to test this endpoint by following the quickstart guide and running with the following examples

Java

OrdersService ordersService = PrimeServiceFactory.createOrdersService(client);

ListOrderFillsRequest request = new ListOrderFillsRequest.Builder()
    .portfolioId("PORTFOLIO_ID_HERE")
    .orderId("ORDER_ID_HERE")
    .build();

ListOrderFillsResponse response = ordersService.listOrderFills(request);

For more information, please visit the Prime Java SDK.

.NET

var ordersService = new OrdersService(client);

var request = new ListOrderFillsRequest("PORTFOLIO_ID_HERE", "ORDER_ID_HERE");

var response = ordersService.ListOrderFills(request);

For more information, please visit the Prime .NET SDK.

Go

ordersService := orders.NewOrdersService(client)

request := &orders.ListOrderFillsRequest{
    PortfolioId: "PORTFOLIO_ID_HERE",
    OrderId: "ORDER_ID_HERE",
}

response, err := ordersService.ListOrderFills(context.Background(), request)

For more information, please visit the Prime Go SDK.

Python

prime_client = PrimeClient(credentials)

request = ListOrderFillsRequest(
    portfolio_id="PORTFOLIO_ID_HERE",
    order_id="ORDER_ID_HERE",
)

response = prime_client.list_order_fills(request)

For more information, please visit the Prime Python SDK.

CLI

primectl get-order-fills --help

For more information, please visit the Prime CLI.

TS/JS

const ordersService = new OrdersService(client);

ordersService.listOrderFills({
    portfolioId: 'PORTFOLIO_ID_HERE',
    orderId: 'ORDER_ID_HERE',
}).then(async (response) => {
    console.log('Fills: ', response);
})

For more information, please visit the Prime TS SDK.

Path Parameters

portfolio_id · string · required

The portfolio ID associated with the order

order_id · string · required

The order ID generated by Coinbase

Query Parameters

cursor · string

Cursor used for pagination (last consumed record)

limit · integer<int32>

Number of items to retrieve

sort_direction · enum<string> · default: DESC

Sorting order

Available options: DESC, ASC

Response

200 - application/json

A successful response.

fills · Fills associated with the order · object[]

Show child attributes

pagination · object

Show child attributes