Sign in

v1

latestOpenAPI 3.0.42026-07-262045103.2 KB
Attestations

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 body

OR

Example request

{
  "symbol": "AAPLon",
  "tokenAmount": "5.000000000000000000",
  "userAddress": "7YkSgYQ6x7uBv9E3n2Yh6mF5tQ1rZc8Lp4WsXjKd3Ha2"
}

Response

OK

attestationIdstring required

The attestation's unique identifier.

userIdstring required

The onchain identifier for an association of wallets.

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 up to 18 decimal places.

expirationnumber required

The epoch timestamp when the attestation will expire.

signaturestring required

The base64-encoded signature attesting to the quote.

additionalDatastring required

Base64-encoded additional data to provide within the attestation.

Example response

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