Update Affirmation

put/api/trade/v1/enterprise/{enterpriseId}/account/{accountId}/affirmations/{affirmationId}

The Update Affirmation API handles affirming and rejecting an affirmation.

Path Parameters

  • enterpriseIdstringRequired
    Enterprise ID
  • accountIdstringRequired
    Trading Account ID
  • affirmationIdstringRequired
    Affirmation ID

Request Body

The Affirmations to update.
status string
The updated status of the Affirmation.
Allowed values: affirmed rejected canceled
Example: affirmed
payload string
This payload must be cryptographically signed with a trading account's private key to authorize the movement of funds
Example: {"version":"1.2.0","accountId":"59cd72485007a239fb00282ed480da1f","amounts":[{"accountId":"5e20faa843795147000da79b8a01f757","sendSubtotal":"1000000","sendAmount":"1000000","sendCurrency":"ofctusd","receiveAmount":"1000000","receiveCurrency":"ofctbtc"},{"accountId":"59cd72485007a239fb00282ed480da1f","sendSubtotal":"1000000","sendAmount":"1000000","sendCurrency":"ofctbtc","receiveAmount":"1000000","receiveCurrency":"ofctusd"}],"nonceHold":"zq/aCtZC4XOlDyRGFdlsww==","nonceSettle":"FnG6xbzehNn0o/0Qt3UeUg=="}
signature string
The "payload" cryptographically signed by trading account.
Example: 1f0f5b4b45106f98bb9c67ba525ead5bd919f14ab1258e25ab16f9d530856f307228431104f39eb0a249f88cd66a79abfe7aee1de96a288af237b4202c82dd8919

200 Response

id string <uuid>
Affirmation ID
counterpartyAccountId string <uuid>
The account ID of the counterparty
counterpartyName string
The name of the counterparty's trading account
partyAccountId string <uuid>
Trading account that the Affirmation belongs to
status string
The current status of the affirmation
Allowed values: pending overdue rejected affirmed failed canceled
Example: pending
settlement string <uuid>
Settlement ID associated with this Affirmation
lock Lock
Assets locked up on a trading account
Example: {"id":"b44616d8-142d-41d7-8037-b6b08f65919f","accountId":"5ca309aa4b389efa274c7fbc8cfc1c72","status":"active","amount":"1000000","currency":"USD","createdAt":{}}
id string <uuid>
Lock ID
accountId string
Trading account ID that has funds locked up
status string
The current status of the settlement
Allowed values: active settled failed requested released
Example: active
amount string
Amount of funds locked in fractional units
currency string
Currency of funds locked
createdAt string <date-time>
ISO date string
payload string
Stringified JSON of trade payload. If the Affirmation signature is not found, then "payload" is automatically calculated and populated here
signature string
The "payload" cryptographically signed by trading account. Used to authorize the movement of funds
createdAt string <date-time>
ISO date string
expireAt string <date-time>
ISO date string

400 Response

error string required
Human-readable error message
errorName string required
Immutable error code for API integration
reqId string required
Client request id