---
title: "Request a Soft Attestation Quote"
method: POST
path: "/v1/attestations/soft"
tags: ["Attestations"]
---

# Request a Soft Attestation Quote

`POST /v1/attestations/soft`

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)

## Request body

- union
  - SoftQuoteByTokenAmountRequest — Request a soft quote to mint or redeem a quantity of assets.
    - `chainId` 'ethereum-1' | 'bsc-56' | 'solana-900', required — The chain's identifier including the chain name and chain id.
    - `symbol` string, required — The GM token symbol.
    - `side` 'buy' | 'sell', required — The direction of the trade.
    - `tokenAmount` string, required — The number of tokens, represented as a string-encoded decimal with up to 18 digits after the decimal point.
    - `duration` 'short' | 'long' — 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.
  - SoftQuoteByNotionalValueRequest — Request a soft quote to mint or redeem assets equal to the notional value.
    - `chainId` 'ethereum-1' | 'bsc-56' | 'solana-900', required — The chain's identifier including the chain name and chain id.
    - `symbol` string, required — The GM token symbol.
    - `side` 'buy' | 'sell', required — The direction of the trade.
    - `notionalValue` string, required — Total value of assets, represented as a string-encoded decimal with up to 18 digits after the decimal point.
    - `duration` 'short' | 'long' — 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.

## Response `200`

OK

- SoftQuote
  - `chainId` string, required — The chain's identifier, only including the chain id.
  - `symbol` string, required — The GM token symbol.
  - `ticker` string, required — The stock ticker associated with this attestation.
  - `assetAddress` string, required — The contract address of the symbol.
  - `side` '0' | '1', required — The direction of the trade (0 for buy, 1 for sell).
  - `tokenAmount` string, required — The number of tokens to mint/redeem represented as a string with 18 decimal places.
  - `price` string, required — The price per asset in USDon, represented as a string with 18 decimal places.

## Other responses

- `400` — One of the request parameters is invalid. Please see the returned message and documentation for details.
- `401` — Missing or invalid API key.
- `403` — The request was denied due to market state, asset state, or insufficient permissions.
- `404` — The provided asset symbol does not exist and cannot be found.
- `429` — The account has exceeded its rate limits. Please see the returned message and documentation for details.
- `500` — An internal server error occurred. Please see the returned message and documentation for details.

---

[API](https://skmtc.net/ondo/apis/gm-backend-api.md) · [All operations](https://skmtc.net/ondo/apis/gm-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ondo/gm-backend-api/versions/12953a4908b2/schema)