Skip to main content
POST
Request a Mint or Redeem Attestation

Authorizations

x-api-key
string
header
required

Body

application/json

Request a mint or redeem attestation.

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

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:

""