> ## Documentation Index > Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve FX crosses from pair descriptors and market dates. > Use this operation when callers need fully described FX-cross market data rather than raw observations. Data is retrieved for every requested pairing of descriptor and market date and returned under the supplied conventional pair codes. The operation is read-only. ## OpenAPI ````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/MarketData/GetFxCrosses openapi: 3.0.4 info: title: Derivitec Api 1.0 version: '1.0' servers: - url: https://api.riskportal.activeviam.com security: - oauth2: [] - apikey: [] tags: - name: AdminUser - name: AtotiReport - name: AtotiSession - name: BloombergOAuth - name: Bond - name: BondYieldCurvePage - name: BookAccess - name: Books - name: Commodity - name: Counterparties - name: Currencies - name: Equity - name: EquityDividend - name: EquityPage - name: FeatureFlag - name: Fx - name: FxPage - name: GroupAccess - name: Home - name: LegacyPosition - name: MarketData - name: MarketDataProvider - name: MarketDataProviderAccess - name: Meta - name: Notification - name: Organisation - name: PnLReport - name: PortfolioAccess - name: Portfolios - name: Position - name: PositionFilter - name: PricingEnvironment - name: PricingEnvironmentAccess - name: RateAsset - name: RateAssetPage - name: Report - name: ReportDefinition - name: ReportHistoryLauncherQuery - name: ReportLauncher - name: ReportQuery - name: ReportQueryViewUser - name: ReportRestriction - name: ReportView - name: RiskReport - name: Tradable - name: TradeBooking - name: User - name: VarReport - name: VarReportQuery - name: YieldCurvePage paths: /api/MarketData/GetFxCrosses: post: tags: - MarketData summary: Retrieve FX crosses from pair descriptors and market dates. description: >- Use this operation when callers need fully described FX-cross market data rather than raw observations. Data is retrieved for every requested pairing of descriptor and market date and returned under the supplied conventional pair codes. The operation is read-only. operationId: GetFxCrosses requestBody: description: >- The query payload. `FxPairs`, `Descriptors`, and `MarketDates` must all be non-empty; pair codes use the conventional six-character format and dates use ISO 8601 date/time values. content: application/json-patch+json: schema: $ref: '#/components/schemas/ApiGetFxCrossesRequest' application/json: schema: $ref: '#/components/schemas/ApiGetFxCrossesRequest' text/json: schema: $ref: '#/components/schemas/ApiGetFxCrossesRequest' application/*+json: schema: $ref: '#/components/schemas/ApiGetFxCrossesRequest' responses: '200': description: >- Returns the available FX crosses for the requested descriptors and dates, together with lookup errors. content: application/json: schema: $ref: '#/components/schemas/ApiGetFxCrossesResponse' '400': description: BadRequest '401': description: Unauthorized '403': description: Forbidden security: - oauth2: [] - apikey: [] components: schemas: ApiGetFxCrossesRequest: required: - $type type: object properties: fx_pairs: type: array items: type: string description: FX pairs that narrow the FX crosses operation. nullable: true market_dates: type: array items: type: string format: date-time description: Market dates on which FX crosses are requested. nullable: true descriptors: type: array items: $ref: '#/components/schemas/StringFxCrossDescriptorKeyValuePair' description: Structured selectors for the requested FX crosses. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiGetFxCrossesRequest, Derivitec.Web.Core additionalProperties: false description: Queries FX cross market data by pair or descriptor across market dates. ApiGetFxCrossesResponse: required: - $type type: object properties: is_success: type: boolean description: >- Whether the operation completed successfully. The default is `true`; error outcomes set it to `false`. example: true error_messages: type: array items: type: string description: >- Messages explaining operation-level failures. The collection is empty by default. nullable: true fx_crosses: type: array items: $ref: '#/components/schemas/FxCross' description: FX cross market-data records returned by the query. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiGetFxCrossesResponse, Derivitec.Web.Core additionalProperties: false description: Returns FX cross market-data records and query errors. StringFxCrossDescriptorKeyValuePair: type: object properties: key: type: string nullable: true value: $ref: '#/components/schemas/FxCrossDescriptor' additionalProperties: false FxCross: required: - $type type: object properties: provider_id: type: string description: >- Market-data provider code recorded as the source of the contribution. Defaults to Derivitec. nullable: true derivitec_created: type: string description: Timestamp at which the market-data record was created. derivitec_modified: type: string description: Optional timestamp of the record's latest modification. nullable: true uploaded_date_time: type: string description: >- Optional timestamp at which the contribution was uploaded. UploadRateAssets ignores the supplied value on each rate asset and stores the current UTC time. nullable: true derivitec_modified_by: type: string description: >- Principal recorded as the latest modifier. UploadRateAssets ignores the supplied value on each rate asset and stores the authenticated user identifier. nullable: true uploaded_by: type: string description: >- Principal recorded as the uploader. UploadRateAssets ignores the supplied value on each rate asset and stores the authenticated user identifier. nullable: true rolled: type: boolean description: Whether the contribution has been rolled. example: false reference_date: type: string description: Date to which the data applies. format: date-time domestic_discount_curve: $ref: '#/components/schemas/DiscountCurve' fixings_by_source: type: array items: $ref: '#/components/schemas/StringFixingsKeyValuePair' description: Source labels paired with fixing series for the FX pair. nullable: true high_fixings_by_source: type: array items: $ref: '#/components/schemas/StringFixingsKeyValuePair' description: Source labels paired with high-observation fixing series. nullable: true low_fixings_by_source: type: array items: $ref: '#/components/schemas/StringFixingsKeyValuePair' description: Source labels paired with low-observation fixing series. nullable: true fx_pair: type: string description: Currency-pair code represented by this market data. nullable: true roll_fixing: type: number description: Fixing value carried for roll treatment. format: double settlement: $ref: '#/components/schemas/FxSettlement' spot: type: number description: Spot observation carried for the FX pair. format: double foreign_discount_curve: $ref: '#/components/schemas/DiscountCurve' is_quoted_fx_cross: type: boolean description: Whether the pair is marked as the quoted FX-cross orientation. example: false $type: type: string enum: - Derivitec.Web.Core.MarketData.FxCross, Derivitec.Web.Core additionalProperties: false description: >- FX-pair market data with spot, discount curves, settlement details, and fixing series. FxCrossDescriptor: required: - $type type: object properties: fixing_end_date: type: string description: Last date included when selecting FX fixings. format: date-time fixing_start_date: type: string description: First date included when selecting FX fixings. format: date-time high_low_fixing_end_date: type: string description: Last date included when selecting high and low observations. format: date-time high_low_fixing_start_date: type: string description: First date included when selecting high and low observations. format: date-time $type: type: string enum: - >- Derivitec.Web.Core.MarketData.FxCrossDescriptor, Derivitec.Web.Core additionalProperties: false description: Date windows used to select FX fixing series and high-low observations. DiscountCurve: required: - $type type: object properties: provider_id: type: string description: >- Market-data provider code recorded as the source of the contribution. Defaults to Derivitec. nullable: true derivitec_created: type: string description: Timestamp at which the market-data record was created. derivitec_modified: type: string description: Optional timestamp of the record's latest modification. nullable: true uploaded_date_time: type: string description: >- Optional timestamp at which the contribution was uploaded. UploadRateAssets ignores the supplied value on each rate asset and stores the current UTC time. nullable: true derivitec_modified_by: type: string description: >- Principal recorded as the latest modifier. UploadRateAssets ignores the supplied value on each rate asset and stores the authenticated user identifier. nullable: true uploaded_by: type: string description: >- Principal recorded as the uploader. UploadRateAssets ignores the supplied value on each rate asset and stores the authenticated user identifier. nullable: true rolled: type: boolean description: Whether the contribution has been rolled. example: false currency: type: string description: Currency represented by the discount curve. nullable: true curve_name: type: string description: Name distinguishing the curve within its currency. nullable: true discount_factors: type: array items: type: number format: double description: Dimensionless discount factors paired by index with Maturities. nullable: true extrapolate: type: boolean description: >- Whether the curve may be evaluated beyond its supplied maturities; initialized to true. maturities: type: array items: type: integer format: int32 description: >- Maturities expressed as day offsets and paired by index with DiscountFactors. nullable: true value_date: type: string description: Curve value date. format: date-time $type: type: string enum: - Derivitec.Web.Core.MarketData.DiscountCurve, Derivitec.Web.Core additionalProperties: false description: >- Named currency discount curve represented by day-offset maturities and dimensionless discount factors. StringFixingsKeyValuePair: type: object properties: key: type: string nullable: true value: $ref: '#/components/schemas/Fixings' additionalProperties: false FxSettlement: required: - $type type: object properties: domestic_calendar: $ref: '#/components/schemas/Calendar' foreign_calendar: $ref: '#/components/schemas/Calendar' is_special_lat_am_cross: type: boolean description: >- Whether the settlement marks the foreign currency as a special Latin American currency. settlement_lag: type: integer description: >- Settlement lag for the currency pair; unit and adjustment rule are not defined here. format: int32 usd_calendar: $ref: '#/components/schemas/Calendar' $type: type: string enum: - Derivitec.Web.Core.StaticData.FxSettlement, Derivitec.Web.Core additionalProperties: false description: >- Calendar and lag terms used to determine settlement for a foreign-exchange pair. Fixings: required: - $type type: object properties: asset_id: type: string description: Series code to which the fixing observations belong. nullable: true dates: type: array items: type: string description: Observation dates in the fixing series. nullable: true values: type: array items: type: number format: double description: Observed values in the fixing series. nullable: true $type: type: string enum: - Derivitec.Web.Core.MarketData.Fixings, Derivitec.Web.Core additionalProperties: false description: Dated observations for one market-data series. Calendar: description: Named business-day calendar with holiday dates and weekend treatment. discriminator: propertyName: $type mapping: Derivitec.Web.Core.StaticData.Calendar, Derivitec.Web.Core: '#/components/schemas/CalendarMintlifyShape' Derivitec.Web.Core.StaticData.CalendarIntersection, Derivitec.Web.Core: '#/components/schemas/CalendarIntersection' Derivitec.Web.Core.StaticData.CalendarUnion, Derivitec.Web.Core: '#/components/schemas/CalendarUnion' oneOf: - $ref: '#/components/schemas/CalendarMintlifyShape' - $ref: '#/components/schemas/CalendarIntersection' - $ref: '#/components/schemas/CalendarUnion' CalendarMintlifyShape: required: - $type type: object properties: holidays: type: array items: type: string format: date-time description: Dates treated as holidays by the calendar. nullable: true include_weekends: type: boolean description: >- Whether weekend dates are included in the calendar's non-business-day set. name: type: string description: Name of the business-day calendar. nullable: true $type: type: string enum: - Derivitec.Web.Core.StaticData.Calendar, Derivitec.Web.Core additionalProperties: false description: Named business-day calendar with holiday dates and weekend treatment. CalendarIntersection: required: - $type type: object properties: holidays: type: array items: type: string format: date-time description: Dates treated as holidays by the calendar. nullable: true include_weekends: type: boolean description: >- Whether weekend dates are included in the calendar's non-business-day set. name: type: string description: Name of the business-day calendar. nullable: true calendars: type: array items: $ref: '#/components/schemas/Calendar' description: Gets or sets the list of underlying calendars in the intersection. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.StaticData.CalendarIntersection, Derivitec.Web.Core additionalProperties: false description: The calendar intersection. CalendarUnion: required: - $type type: object properties: holidays: type: array items: type: string format: date-time description: Dates treated as holidays by the calendar. nullable: true include_weekends: type: boolean description: >- Whether weekend dates are included in the calendar's non-business-day set. name: type: string description: Name of the business-day calendar. nullable: true calendars: type: array items: $ref: '#/components/schemas/Calendar' description: Gets or sets the list of underlying calendars in the union. nullable: true $type: type: string enum: - Derivitec.Web.Core.StaticData.CalendarUnion, Derivitec.Web.Core additionalProperties: false description: The calendar union. securitySchemes: oauth2: type: oauth2 description: >- OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header flows: implicit: authorizationUrl: https://auth.riskportal.derivitec.com/oauth2/authorize scopes: {} apikey: type: apiKey description: API-Key requested via the site and provided as a header name: x-api-key in: header ````