> ## Documentation Index > Fetch the complete documentation index at: https://docs.ondo.finance/llms.txt > Use this file to discover all available pages before exploring further. # Request a Soft Attestation Quote > A soft quote provides pricing information for mint or redeem operations without creating an actual attestation. Unlike the [Request a Mint or Redeem Attestation endpoint](https://docs.ondo.finance/api-reference/attestations/request-a-mint-or-redeem-attestation), soft quotes: - Are not eligible for on-chain submission - Do not count against user limits (Active Notional Value, Session Notional Value, or Active Attestations) - Serve as pricing references for quote validation and user interface display - Do not include authentication fields such as `attestationId`, `userId`, `expiration`, or `signature` This endpoint can be used to acquire estimated pricing without impacting trading limits or creating binding commitments. See also: [Error Codes](https://docs.ondo.finance/api-reference/error-codes) ## OpenAPI ````yaml /gm-be-api-spec.json post /v1/attestations/soft openapi: 3.0.4 info: title: GM Backend API description: An API spec for the Ondo GM Backend API. version: 1.0.0 servers: - url: https://api.gm.ondo.finance description: GM Backend API security: [] tags: - name: Attestations description: Get Mint and Redeem Attestations - name: Assets description: Get Asset Price Information - name: Tickers description: Get Ticker Information - name: Chains description: Get On Chain Data - name: Limits description: Get Trading Limits - name: Status description: Get Market and Trading Statuses paths: /v1/attestations/soft: post: tags: - Attestations summary: Request a Soft Attestation Quote description: > A soft quote provides pricing information for mint or redeem operations without creating an actual attestation. Unlike the [Request a Mint or Redeem Attestation endpoint](https://docs.ondo.finance/api-reference/attestations/request-a-mint-or-redeem-attestation), soft quotes: - Are not eligible for on-chain submission - Do not count against user limits (Active Notional Value, Session Notional Value, or Active Attestations) - Serve as pricing references for quote validation and user interface display - Do not include authentication fields such as `attestationId`, `userId`, `expiration`, or `signature` This endpoint can be used to acquire estimated pricing without impacting trading limits or creating binding commitments. See also: [Error Codes](https://docs.ondo.finance/api-reference/error-codes) operationId: createSoftAttestationQuote requestBody: content: application/json: schema: oneOf: - $ref: '#/components/schemas/SoftQuoteByTokenAmountRequest' - $ref: '#/components/schemas/SoftQuoteByNotionalValueRequest' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SoftQuote' '400': description: >- One of the request parameters is invalid. Please see the returned message and documentation for details. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: error: value: message: One of the request parameters is invalid. documentation: https://docs.ondo.finance/api-reference/error-codes code: INVALID_SYMBOL '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: error: value: message: missing API key code: MISSING_API_KEY '403': description: >- The request was denied due to market state, asset state, or insufficient permissions. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: market_closed: summary: Market Closed value: code: MARKET_CLOSED message: market is closed documentation: https://docs.ondo.finance/api-reference/error-codes asset_paused: summary: Asset Paused value: code: ASSET_PAUSED message: asset trading is paused documentation: https://docs.ondo.finance/api-reference/error-codes read_only: summary: Read-Only API Key value: code: READ_ONLY_API_KEY message: read-only API key cannot perform write operations documentation: https://docs.ondo.finance/api-reference/error-codes '404': description: The provided asset symbol does not exist and cannot be found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: error: value: code: ASSET_NOT_FOUND message: asset not found documentation: https://docs.ondo.finance/api-reference/error-codes '500': description: >- An internal server error occurred. Please see the returned message and documentation for details. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: error: value: message: >- An internal server error occurred. Please see the returned message and documentation for details. code: INTERNAL_ERROR security: - apiKey: [] components: schemas: SoftQuoteByTokenAmountRequest: type: object description: Request a soft quote to mint or redeem a quantity of assets. title: AttestationByTokenAmountRequest properties: chainId: $ref: '#/components/schemas/GMChains' symbol: type: string example: AAPLon description: The GM token symbol. side: $ref: '#/components/schemas/SideEnum' tokenAmount: type: string description: >- The number of tokens, represented as a string-encoded decimal with up to 18 digits after the decimal point. example: '5.000000000000000000' duration: $ref: '#/components/schemas/AttestationDurationEnum' required: - chainId - symbol - side - tokenAmount SoftQuoteByNotionalValueRequest: type: object description: >- Request a soft quote to mint or redeem assets equal to the notional value. title: AttestationByNotionalValueRequest properties: chainId: $ref: '#/components/schemas/GMChains' symbol: type: string example: AAPLon description: The GM token symbol. side: $ref: '#/components/schemas/SideEnum' notionalValue: type: string description: >- Total value of assets, represented as a string-encoded decimal with up to 18 digits after the decimal point. example: '500.000000000000000000' duration: $ref: '#/components/schemas/AttestationDurationEnum' required: - chainId - symbol - side - notionalValue SoftQuote: type: object properties: chainId: type: string description: The chain's identifier, only including the chain id. example: '1' symbol: type: string example: AAPLon description: The GM token symbol. ticker: type: string description: The stock ticker associated with this attestation. example: AAPL assetAddress: type: string description: The contract address of the symbol. example: '0x96F6eF951840721AdBF46Ac996b59E0235CB985C' side: type: string enum: - '0' - '1' description: The direction of the trade (0 for buy, 1 for sell). tokenAmount: type: string description: >- The number of tokens to mint/redeem represented as a string with 18 decimal places. example: '5000000000000000000' price: type: string description: >- The price per asset in USDon, represented as a string with 18 decimal places. example: '225273151158540753535' required: - chainId - symbol - ticker - assetAddress - side - tokenAmount - price ErrorResponse: type: object properties: message: type: string description: A human-readable message providing more details about the error. documentation: type: string description: A URL to the relevant documentation for this error. code: type: string description: >- A reason code identifying the specific type of error. See the Error Codes reference for a full list of possible values. required: - code - message GMChains: type: string description: The chain's identifier including the chain name and chain id. enum: - ethereum-1 - bsc-56 - solana-900 SideEnum: type: string description: The direction of the trade. enum: - buy - sell AttestationDurationEnum: type: string description: > Specifies the desired validity period for the attestation. Users can specify a duration of 'short' for a tighter price spread or 'long' for an extended validity period. enum: - short - long securitySchemes: apiKey: type: apiKey name: x-api-key in: header ````