> ## 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. # Store FX volatility grids for a market-data provider. > Use this operation to validate and convert quoted FX volatility grids into provider-scoped volatility surfaces. The caller must have edit access to the selected provider. When `UseBestEffort` is true, valid supported pairs may still be saved when other grids fail; when false, validation failures stop the upload before partial processing. ## OpenAPI ````yaml /risk-and-pricing/atoti-risk-services/apis-endpoints/openapi/openapi.mintlify.json post /api/MarketData/UploadFxVolGrids 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/UploadFxVolGrids: post: tags: - MarketData summary: Store FX volatility grids for a market-data provider. description: >- Use this operation to validate and convert quoted FX volatility grids into provider-scoped volatility surfaces. The caller must have edit access to the selected provider. When `UseBestEffort` is true, valid supported pairs may still be saved when other grids fail; when false, validation failures stop the upload before partial processing. operationId: UploadFxVolGrids requestBody: description: >- The upload payload. `FxVolGrids` must be non-empty, each grid identifies an FX pair and reference date, `ProviderId` selects the destination, and `UseBestEffort` controls partial processing. content: application/json-patch+json: schema: $ref: '#/components/schemas/ApiUploadFxVolGridsRequest' application/json: schema: $ref: '#/components/schemas/ApiUploadFxVolGridsRequest' text/json: schema: $ref: '#/components/schemas/ApiUploadFxVolGridsRequest' application/*+json: schema: $ref: '#/components/schemas/ApiUploadFxVolGridsRequest' responses: '200': description: >- Returns the upload result and errors for invalid or unsupported FX grids. content: application/json: schema: $ref: '#/components/schemas/ApiUploadFxVolGridsResponse' '400': description: BadRequest '401': description: Unauthorized '403': description: Forbidden security: - oauth2: [] - apikey: [] components: schemas: ApiUploadFxVolGridsRequest: required: - $type type: object properties: market_data_environment_name: type: string description: >- Name of the market-data environment to use. Supply either this name or `provider_id`, not both. nullable: true example: Example market data provider_id: type: string description: >- Opaque identifier of the market-data provider to use. Supply either this identifier or `market_data_environment_name`, not both. nullable: true use_best_effort: type: boolean description: >- Requests independent handling of input records when one cannot be processed; defaults to `false`. fx_vol_grids: type: array items: $ref: '#/components/schemas/FxVolGrid' description: FX volatility grids to upload. nullable: true $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiUploadFxVolGridsRequest, Derivitec.Web.Core additionalProperties: false description: Submits FX volatility grids. ApiUploadFxVolGridsResponse: required: - $type type: object additionalProperties: false description: >- Returns the success flag and error messages from an FX volatility-grid upload. 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 $type: type: string enum: - >- Derivitec.Web.Core.MarketData.ApiUploadFxVolGridsResponse, Derivitec.Web.Core FxVolGrid: 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 fx_pair: type: string description: Currency-pair code represented by the grid. nullable: true reference_date: type: string description: Reference date of the FX volatility grid. format: date-time tenors: type: array items: type: string description: Tenor labels carried by the FX volatility grid. nullable: true deltas: type: array items: type: array items: type: string description: Delta labels grouped into rows of the FX volatility grid. nullable: true vols: type: array items: type: array items: type: number format: double description: Volatility observations grouped into rows of the FX grid. nullable: true spot_ref: type: number description: Optional spot reference carried by the grid. format: double nullable: true $type: type: string enum: - Derivitec.Web.Core.MarketData.FxVolGrid, Derivitec.Web.Core additionalProperties: false description: Dated FX volatility grid organised by tenor and delta labels. 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 ````