Request a Mint or Redeem Attestation

An attestation is a signed payload that authorizes a user to mint or redeem tokens. Each attestation is only valid for a limited time and is determined by the duration in the request. A user can specify a duration of short for a tighter price spread or long for an extended validity period.

Note: There are specific user and session limits which can prevent the creation of an attestation. For more information on limits, see the Get Trading Limits endpoint.

See also: Error Codes

POST /v1/attestations

Request a Mint or Redeem Attestation

cURL

curl --request POST \
  --url https://api.gm.ondo.finance/v1/attestations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "chainId": "ethereum-1",
  "symbol": "AAPLon",
  "side": "buy",
  "tokenAmount": "5.000000000000000000",
  "duration": "short",
  "userAddress": "7YkSgYQ6x7uBv9E3n2Yh6mF5tQ1rZc8Lp4WsXjKd3Ha2"
}
'

200

Example

{
  "attestationId": "229852750420835981756873903928305653446",
  "userId": "0x474d0000000000009310097834e2c7af00000000000000000000000000000000",
  "chainId": "1",
  "symbol": "AAPLon",
  "ticker": "AAPL",
  "assetAddress": "0x14c3abf95cb9c93a8b82c1cdcb76d72cb87b2d4c",
  "side": "0",
  "tokenAmount": "5000000000000000000",
  "price": "225273151158540753535",
  "expiration": 1746655938,
  "signature": "kMecIrsGFdoAdxzRq2bPo07FWP2QyrxWfjrSMAdIZXNq3bXQnWx27aTKyt9fJiXWrzShYemxA/0RengNqNJ6bBs=",
  "additionalData": ""
}

Authorizations

x-api-key · string · header · required

Body

application/json

Request a mint or redeem attestation.

AttestationByTokenAmountRequest

AttestationByNotionalValueRequest

Request to mint or redeem a quantity of assets.

chainId · enum<string> · required

The chain's identifier including the chain name and chain id.

Available options: ethereum-1, bsc-56, 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d

symbol · string · required

The GM token symbol.

Example:

"AAPLon"

side · enum<string> · required

The direction of the trade.

Available options: buy, sell

tokenAmount · string · required

The number of tokens, represented as a string-encoded decimal with up to 18 digits after the decimal point.

Example:

"5.000000000000000000"

duration · enum<string>

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.

Available options: short, long

userAddress · string

The Solana user address associated with the request. This is only required for Solana attestations.

Example:

"7YkSgYQ6x7uBv9E3n2Yh6mF5tQ1rZc8Lp4WsXjKd3Ha2"

Response

200

application/json

OK

attestationId · string · required

The attestation's unique identifier.

Example:

"229852750420835981756873903928305653446"

userId · string · required

The onchain identifier for an association of wallets.

Example:

"0x474d0000000000009310097834e2c7af00000000000000000000000000000000"

chainId · string · required

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

Example:

"1"

symbol · string · required

The GM token symbol.

Example:

"AAPLon"

ticker · string · required

The stock ticker associated with this attestation.

Example:

"AAPL"

assetAddress · string · required

The contract address of the symbol.

Example:

"0x14c3abf95cb9c93a8b82c1cdcb76d72cb87b2d4c"

side · enum<string> · required

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

Available options: 0, 1

Example:

"0"

tokenAmount · string · required

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

Example:

"5000000000000000000"

price · string · required

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

Example:

"225273151158540753535"

expiration · number · required

The epoch timestamp when the attestation will expire.

Example:

1746655938

signature · string · required

The base64-encoded signature attesting to the quote.

Example:

"kMecIrsGFdoAdxzRq2bPo07FWP2QyrxWfjrSMAdIZXNq3bXQnWx27aTKyt9fJiXWrzShYemxA/0RengNqNJ6bBs="

additionalData · string · required

Base64-encoded additional data to provide within the attestation.

Example:

""