# Executions

## GET Execution

> Retrieve specific fill by execution ID.

```json
{"openapi":"3.0.3","info":{"title":"Aquanow CAMS REST API","version":"1.0"},"servers":[{"url":"https://cams.aquanow.com/api","description":"production"},{"url":"http://localhost:3001/api","description":"local"},{"url":"https://cams.dev.aquanow.com/api","description":"dev"},{"url":"https://cams.staging.aquanow.com/api","description":"staging"},{"url":"https://cams.cert.aquanow.com/api","description":"cert"},{"url":"https://marketdata.aquanow.com","description":"production market data"},{"url":"https://marketdata.staging.aquanow.com","description":"staging market data"},{"url":"https://marketdata.dev.aquanow.com","description":"dev market data"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer"}},"schemas":{"Execution":{"title":"Execution","type":"object","properties":{"executionId":{"type":"string","format":"uuid"},"orderId":{"type":"string","format":"uuid"},"accountId":{"type":"string","format":"uuid"},"executedAt":{"type":"string","format":"date-time"},"pair":{"type":"string"},"side":{"type":"string"},"orderType":{"$ref":"#/components/schemas/OrderType"},"deliverCurrency":{"type":"string"},"deliverQuantity":{"type":"string"},"receiveCurrency":{"type":"string"},"receiveQuantity":{"type":"string"},"price":{"type":"string","format":"number"},"baseQuantity":{"type":"string","format":"number"},"quoteQuantity":{"type":"string","format":"number"},"clientFeeRate":{"type":"string","format":"integer","nullable":true},"clientFeeAmount":{"type":"string","format":"number","description":"Fixed fiat fee amount in tenant native currency","nullable":true},"providerFeeRate":{"type":"string","format":"integer"},"clientFeeQuantity":{"type":"string","format":"number"},"providerFeeQuantity":{"type":"string","format":"number"},"feeCurrency":{"type":"string"},"executionStatus":{"$ref":"#/components/schemas/ExecutionStatus"},"tradeDate":{"type":"string","format":"date"},"valueDate":{"type":"string","format":"date"},"confirmedAt":{"type":"string","format":"date-time","nullable":true},"clientReference":{"type":"string","nullable":true},"tradeTaxRate":{"type":"string","format":"number","description":"Tax rate charged on fees as a percentage"},"clientTaxQuantity":{"type":"string","format":"number"},"providerTaxQuantity":{"type":"string","format":"number"},"fileUrl":{"type":"string","format":"uri","nullable":true}}},"OrderType":{"type":"string","enum":["MARKET","LIMIT","PREVIOUSLY_QUOTED"]},"ExecutionStatus":{"type":"string","enum":["TRADE_EXECUTED","TRADE_CONFIRMED","TRADE_SETTLED"]}},"responses":{"400":{"description":"Validation Error"},"401":{"description":"Unauthorized"},"403":{"description":"Insufficient Privileges"},"4XX":{"description":"Client error"},"5XX":{"description":"Server error"}}},"paths":{"/v1/executions/{executionId}":{"get":{"summary":"GET Execution","description":"Retrieve specific fill by execution ID.","tags":["Trading"],"parameters":[{"name":"executionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"The execution ID returned by the executeQuote endpoint"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Execution"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"4XX":{"$ref":"#/components/responses/4XX"},"5XX":{"$ref":"#/components/responses/5XX"}},"operationId":"GetOneExecution"}}}}
```

## GET Executions

> Retrieve fills with optional filtering and pagination.

```json
{"openapi":"3.0.3","info":{"title":"Aquanow CAMS REST API","version":"1.0"},"servers":[{"url":"https://cams.aquanow.com/api","description":"production"},{"url":"http://localhost:3001/api","description":"local"},{"url":"https://cams.dev.aquanow.com/api","description":"dev"},{"url":"https://cams.staging.aquanow.com/api","description":"staging"},{"url":"https://cams.cert.aquanow.com/api","description":"cert"},{"url":"https://marketdata.aquanow.com","description":"production market data"},{"url":"https://marketdata.staging.aquanow.com","description":"staging market data"},{"url":"https://marketdata.dev.aquanow.com","description":"dev market data"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer"}},"schemas":{"ExecutionStatus":{"type":"string","enum":["TRADE_EXECUTED","TRADE_CONFIRMED","TRADE_SETTLED"]},"OrderType":{"type":"string","enum":["MARKET","LIMIT","PREVIOUSLY_QUOTED"]},"SortDirection":{"type":"string","enum":["ASC","DESC"]},"Side":{"type":"string","enum":["BUY","SELL"],"description":"Indicates the direction of the order"},"Execution":{"title":"Execution","type":"object","properties":{"executionId":{"type":"string","format":"uuid"},"orderId":{"type":"string","format":"uuid"},"accountId":{"type":"string","format":"uuid"},"executedAt":{"type":"string","format":"date-time"},"pair":{"type":"string"},"side":{"type":"string"},"orderType":{"$ref":"#/components/schemas/OrderType"},"deliverCurrency":{"type":"string"},"deliverQuantity":{"type":"string"},"receiveCurrency":{"type":"string"},"receiveQuantity":{"type":"string"},"price":{"type":"string","format":"number"},"baseQuantity":{"type":"string","format":"number"},"quoteQuantity":{"type":"string","format":"number"},"clientFeeRate":{"type":"string","format":"integer","nullable":true},"clientFeeAmount":{"type":"string","format":"number","description":"Fixed fiat fee amount in tenant native currency","nullable":true},"providerFeeRate":{"type":"string","format":"integer"},"clientFeeQuantity":{"type":"string","format":"number"},"providerFeeQuantity":{"type":"string","format":"number"},"feeCurrency":{"type":"string"},"executionStatus":{"$ref":"#/components/schemas/ExecutionStatus"},"tradeDate":{"type":"string","format":"date"},"valueDate":{"type":"string","format":"date"},"confirmedAt":{"type":"string","format":"date-time","nullable":true},"clientReference":{"type":"string","nullable":true},"tradeTaxRate":{"type":"string","format":"number","description":"Tax rate charged on fees as a percentage"},"clientTaxQuantity":{"type":"string","format":"number"},"providerTaxQuantity":{"type":"string","format":"number"},"fileUrl":{"type":"string","format":"uri","nullable":true}}}},"responses":{"400":{"description":"Validation Error"},"401":{"description":"Unauthorized"},"403":{"description":"Insufficient Privileges"},"4XX":{"description":"Client error"},"5XX":{"description":"Server error"}}},"paths":{"/v1/executions":{"get":{"summary":"GET Executions","description":"Retrieve fills with optional filtering and pagination.","tags":["Trading"],"parameters":[{"name":"executionStatus","in":"query","schema":{"$ref":"#/components/schemas/ExecutionStatus"},"description":"Filter executions by execution status"},{"name":"orderId","in":"query","schema":{"type":"string","format":"uuid"},"description":"Filter executions by order ID."},{"name":"clientReference","in":"query","schema":{"type":"string"},"description":"Filter executions by client provided reference parameter"},{"name":"accountId","in":"query","schema":{"type":"string","format":"uuid"},"description":"Filter executions by account ID"},{"name":"orderType","in":"query","schema":{"$ref":"#/components/schemas/OrderType"},"description":"Filter executions by order type."},{"name":"tradeDateStart","in":"query","schema":{"type":"string","format":"date"},"description":"Filter executions by trade date lower bound, exclusive"},{"name":"tradeDateEnd","in":"query","schema":{"type":"string","format":"date"},"description":"Filter executions by trade date upper bound, inclusive"},{"name":"valueDateStart","in":"query","schema":{"type":"string","format":"date"},"description":"Filter executions by value date lower bound, exclusive"},{"name":"valueDateEnd","in":"query","schema":{"type":"string","format":"date"},"description":"Filter executions by value date upper bound, inclusive"},{"name":"after","in":"query","required":false,"schema":{"type":"string"},"description":"When provided, specifies the last item returned in previous page, used to fetch the next page. Fetches the first page when omitted."},{"name":"limit","in":"query","required":false,"schema":{"type":"string","format":"integer"},"description":"When provided, specifies the number of items to return in the page. Uses default page size of 10 when omitted."},{"name":"sortField","in":"query","required":false,"schema":{"type":"string","enum":["tradeDate","valueDate","executionStatus"]},"description":"Will sort the returned data using the specified field."},{"name":"sortDirection","in":"query","required":false,"schema":{"$ref":"#/components/schemas/SortDirection"},"description":"Specifies the sort direction for the sortField."},{"name":"side","in":"query","schema":{"$ref":"#/components/schemas/Side"},"description":"Filter executions by side (BUY or SELL)."},{"schema":{"type":"string"},"in":"query","name":"pair","description":"Filter executions by trade pair."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"after":{"type":"string","nullable":true,"description":"The token of the last item in the response"},"totalCount":{"type":"string","format":"integer","description":"The total number of items in the entire filtered data set"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Execution"}}}}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"4XX":{"$ref":"#/components/responses/4XX"},"5XX":{"$ref":"#/components/responses/5XX"}},"operationId":"GetAllExecutions"}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aquanow.io/cams/api-reference/executions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.