v1

latestOpenAPI 3.0.42026-07-262045103.2 KB
Attestations

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, 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

post/v1/attestations/soft

Request body

OR

Example request

{
  "symbol": "AAPLon",
  "tokenAmount": "5.000000000000000000"
}

Response

OK

chainIdstring required

The chain's identifier, only including the chain id.

symbolstring required

The GM token symbol.

tickerstring required

The stock ticker associated with this attestation.

assetAddressstring required

The contract address of the symbol.

side'0' | '1' required

The direction of the trade (0 for buy, 1 for sell).

tokenAmountstring required

The number of tokens to mint/redeem represented as a string with 18 decimal places.

pricestring required

The price per asset in USDon, represented as a string with 18 decimal places.

Example response

{
  "chainId": "1",
  "symbol": "AAPLon",
  "ticker": "AAPL",
  "assetAddress": "0x96F6eF951840721AdBF46Ac996b59E0235CB985C",
  "tokenAmount": "5000000000000000000",
  "price": "225273151158540753535"
}