Skip to main content
POST
/
v1
/
exchange
/
stablefx
/
signatures
Register a trade signature
curl --request POST \
  --url https://api-sandbox.circle.com/v1/exchange/stablefx/signatures \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tradeId": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
  "type": "maker",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "details": {
    "consideration": {
      "quoteId": "<string>",
      "base": "<string>",
      "quote": "<string>",
      "baseAmount": "<string>",
      "quoteAmount": "<string>",
      "maturity": 1716153600
    },
    "recipient": "0x379c868f6064d9c0564df05dcca170d64f8aa5e3",
    "fee": 442700,
    "nonce": 309585810,
    "deadline": 1763587308
  },
  "signature": "<string>"
}'
{
  "tradeId": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
  "type": "maker",
  "createDate": "2023-01-01T12:04:05Z",
  "updateDate": "2023-01-01T12:04:05Z"
}

Authorizations

​
Authorization
string
header
required

Circle's API Keys are formatted in the following structure "PREFIX:ID:SECRET". All three parts are requred to make a successful request.

Body

application/json

Request body for submitting a trade signature

​
tradeId
string<uuid>
required

System-generated unique identifier of the resource.

Example:

"c4d1da72-111e-4d52-bdbf-2e74a2d803d5"

​
type
enum<string>
required

The type of trader.

Available options:
maker,
taker
​
address
string
required

The wallet address signing the trade presign data

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
details
object
required

Trade signature details (either TakerDetails or MakerDetails)

​
signature
string
required

The signature generated from signing the trade presign data

Response

200 - application/json

Trade signature registered successfully

Response from registering a trade signature

​
tradeId
string<uuid>
required

System-generated unique identifier of the resource.

Example:

"c4d1da72-111e-4d52-bdbf-2e74a2d803d5"

​
type
enum<string>
required

The type of trader.

Available options:
maker,
taker
​
createDate
string<date-time>
required

Date and time when the resource was created

Example:

"2023-01-01T12:04:05Z"

​
updateDate
string<date-time>
required

Date and time when the resource was last updated

Example:

"2023-01-01T12:04:05Z"