# Atoti Hub: Risk & pricing Atoti Risk Services APIs Endpoints API reference Position ## Position - [Retrieve contracts for a client trade reference.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/retrieve-contracts-for-a-client-trade-reference.md): Returns the contract definitions associated with a client trade reference in a portfolio available to the caller. This is read-only. - [Retrieve an aggregated portfolio position table.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/retrieve-an-aggregated-portfolio-position-table.md): Returns an accessible portfolio as a tabular position view for the requested date. The date is evaluated at end of day in the caller's time zone; visible columns and grouping can reflect the organisation's configured layout. This is read-only. - [Retrieve portfolio transactions for a date range.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/retrieve-portfolio-transactions-for-a-date-range.md): Returns a tabular portfolio view between the supplied dates, with the end evaluated at end of day in the caller's time zone. `Counterparties` narrows rows when supplied. `IncludeZeroQuantities` defaults to `false`; set it to `true` to retain positions that net to zero. This is read-only. - [Upload a batch of portfolio positions.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/upload-a-batch-of-portfolio-positions.md): Validates the batch and applies position changes only when it has no validation or book-access errors. Each position needs a non-blank client transaction identifier and a uniquely named active book that the caller can edit. A failed item prevents the batch position changes from being applied. This s… - [Add books to portfolios and optionally share them.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/add-books-to-portfolios-and-optionally-share-them.md): Creates each requested book beneath its named parent portfolios and can grant edit access to invited users. Parent portfolios must be available and editable by the caller. Requests are handled item by item: a valid book can be created when another item fails, and a sharing failure can follow book cr… - [Validate a position-import workbook.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/validate-a-position-import-workbook.md): Begins the workbook workflow by examining one submitted position file without applying its position changes. The result includes validity, workbook messages, books that would need creation, and a validation-context identifier for the row-inspection and import actions. Validation finishes before the… - [List proposed position changes by book.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/list-proposed-position-changes-by-book.md): Use a validation-context identifier from workbook validation to inspect proposed position effects without applying the import. With no group key, rows summarise books; the first group key returns that book's effects. Only the first sort entry is used. This is read-only. - [List workbook parsing errors by worksheet.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/list-workbook-parsing-errors-by-worksheet.md): Use a validation-context identifier from workbook validation to inspect parsing errors. Without a group key, the response returns one row per worksheet; the first group key returns the selected worksheet's errors in the requested row window. This is read-only. - [List workbook parsing warnings by worksheet.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/list-workbook-parsing-warnings-by-worksheet.md): Use a validation-context identifier from workbook validation to inspect non-fatal warnings. Without a group key, the response returns one row per worksheet; the first group key returns paged warning details for that worksheet. This is read-only. - [Import positions from a validated workbook.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/import-positions-from-a-validated-workbook.md): Applies parsed positions associated with a prior workbook validation. Call after reviewing a valid validation result. The import finishes before the response and changes portfolio positions; no background lifecycle is exposed. Validation-context lifetime, expiry, and reuse rules are not specified. - [Validate one proposed trade and optionally calculate risk.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/validate-one-proposed-trade-and-optionally-calculate-risk.md): Parses one proposed position against books visible to the caller without booking it. When `CalculateRisk` is true, the response also includes pricing details, market-data tables, and unit-risk outputs in `ReportingCurrency`. `RequestId` is echoed for correlation. Inspect `ParsedTrades.IsValid` for p… - [Validate and submit a batch of trades.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/validate-and-submit-a-batch-of-trades.md): Validates all submitted trades before submission. For `Derivitec`, accepts new trades into active existing books with edit permission, independently of the user's spreadsheet snapshot-import preference. Products requiring a unit price need an explicit finite `TradedPriceToday`; zero is allowed when… - [Check whether a set of trades would book, without booking any of them.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/check-whether-a-set-of-trades-would-book-without-booking-any-of-them.md): Parses the submitted positions without changing any book. Success confirms parsing only: booking also checks the destination, required price paid, trade-event generation and persistence. Positions are grouped by contract type before parsing, so the response carries one result per type rather than pe… - [Retrieve one booked trade and whether the caller may reverse it.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/retrieve-one-booked-trade-and-whether-the-caller-may-reverse-it.md): Returns when the trade was booked and by whom, and the quantity changes it made grouped by the book they landed in. The timestamp is ISO 8601 carrying the offset of the caller's time zone, or UTC when none was supplied. Reversal additionally requires edit access to every book the trade touched, so a… - [Cancel a booked trade by booking an offsetting one.](https://docs.activeviam.com/risk-and-pricing/atoti-risk-services/apis-endpoints/api-reference/position/cancel-a-booked-trade-by-booking-an-offsetting-one.md): Books a trade whose position effects negate the original's. The original is left in place, so the book keeps both, and the response identifies the new offsetting trade rather than the one reversed. The caller needs edit access to every book the original touched; without it nothing is booked. This is… ## OpenAPI Specs - [openapi.mintlify](/risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json)