Transactions

get

Returns a multi-signature transaction given its Safe transaction hash

Authorizations
sessionidstringOptional
Path parameters
safe_tx_hashstringRequired
Responses
chevron-right
200Success
application/json
safestringRequired
tostringRequired
valuestringRequired
datastring · nullableOptional
operationintegerRequired
gasTokenstring · nullableOptional
safeTxGasstringRequired
baseGasstringRequired
gasPricestringRequired
refundReceiverstring · nullableOptional
noncestringRequired
executionDatestring · date-timeRequired
submissionDatestring · date-timeRequired
modifiedstring · date-timeRequired
blockNumberinteger · nullableRead-onlyRequired
transactionHashstringRequired
safeTxHashstringRequired
proposerstringRequired
proposedByDelegatestring · nullableRequired
executorstring · nullableRead-onlyRequired
isExecutedbooleanRequired
isSuccessfulboolean · nullableRead-onlyRequired
ethGasPricestring · nullableRead-onlyRequired
maxFeePerGasstring · nullableRead-onlyRequired
maxPriorityFeePerGasstring · nullableRead-onlyRequired
gasUsedinteger · nullableRead-onlyRequired
feeinteger · nullableRead-onlyRequired
originstringRead-onlyRequired
dataDecodedstringRead-onlyRequiredDeprecated

This field is deprecated and will be removed in future versions. Refer to decoder service documentation for decoding guidance.

confirmationsRequiredintegerRequired
trustedbooleanRequired
signaturesstring · nullableRead-onlyRequired
get
/api/v2/multisig-transactions/{safe_tx_hash}/
200Success
delete

Removes the queued but not executed multi-signature transaction associated with the given Safe transaction hash. Only the proposer or the delegate who proposed the transaction can delete it. If the transaction was proposed by a delegate, it must still be a valid delegate for the transaction proposer. An EOA is required to sign the following EIP-712 data:

 {
    "types": {
        "EIP712Domain": [
            {"name": "name", "type": "string"},
            {"name": "version", "type": "string"},
            {"name": "chainId", "type": "uint256"},
            {"name": "verifyingContract", "type": "address"},
        ],
        "DeleteRequest": [
            {"name": "safeTxHash", "type": "bytes32"},
            {"name": "totp", "type": "uint256"},
        ],
    },
    "primaryType": "DeleteRequest",
    "domain": {
        "name": "Safe Transaction Service",
        "version": "1.0",
        "chainId": chain_id,
        "verifyingContract": safe_address,
    },
    "message": {
        "safeTxHash": safe_tx_hash,
        "totp": totp,
    },
}

totp parameter is calculated with T0=0 and Tx=3600. totp is calculated by taking the Unix UTC epoch time (no milliseconds) and dividing by 3600 (natural division, no decimals)

Authorizations
sessionidstringOptional
Path parameters
safe_tx_hashstringRequired
Responses
delete
/api/v2/multisig-transactions/{safe_tx_hash}/
204

No response body

No content

get

Returns all the executed transactions for a given Safe address. The list has different structures depending on the transaction type:

  • Multisig Transactions for a Safe. tx_type=MULTISIG_TRANSACTION.

  • Module Transactions for a Safe. tx_type=MODULE_TRANSACTION

  • Incoming Transfers of Ether/ERC20 Tokens/ERC721 Tokens. tx_type=ETHEREUM_TRANSACTION Ordering_fields: ["timestamp"] eg: -timestamp (default one) or timestamp

Note: This endpoint has a bug that will be fixed in next versions of the endpoint. Pagination is done using the Transaction Hash, and due to that the number of relevant transactions with the same Transaction Hash cannot be known beforehand. So if there are only 2 transactions with the same Transaction Hash, count of the endpoint will be 1 but there will be 2 transactions in the list.

Authorizations
sessionidstringOptional
Path parameters
addressstringRequired
Query parameters
orderingstringOptional

Which field to use when ordering the results.

limitintegerOptional

Number of results to return per page.

offsetintegerOptional

The initial index from which to return the results.

Responses
chevron-right
200Success
application/json
countintegerRequiredExample: 123
nextstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=400&limit=100
previousstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=200&limit=100
get
/api/v2/safes/{address}/all-transactions/
200Success
get

Returns all the multi-signature transactions for a given Safe address. By default, only trusted multisig transactions are returned.

Authorizations
sessionidstringOptional
Path parameters
addressstringRequired
Query parameters
failedbooleanOptional
modified__ltstring · date-timeOptional
modified__gtstring · date-timeOptional
modified__ltestring · date-timeOptional
modified__gtestring · date-timeOptional
nonce__ltnumberOptional
nonce__gtnumberOptional
nonce__ltenumberOptional
nonce__gtenumberOptional
noncenumberOptional
safe_tx_hashstring · byteOptional
tostringOptional
value__ltnumberOptional
value__gtnumberOptional
valuenumberOptional
executedbooleanOptional
has_confirmationsbooleanOptional
trustedbooleanOptional
execution_date__gtestring · date-timeOptional
execution_date__ltestring · date-timeOptional
submission_date__gtestring · date-timeOptional
submission_date__ltestring · date-timeOptional
transaction_hashstring · nullableOptional
orderingstringOptional

Which field to use when ordering the results.

limitintegerOptional

Number of results to return per page.

offsetintegerOptional

The initial index from which to return the results.

Responses
chevron-right
200Success
application/json
countintegerRequiredExample: 123
nextstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=400&limit=100
previousstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=200&limit=100
get
/api/v2/safes/{address}/multisig-transactions/
post

Creates a multi-signature transaction for a given Safe account with its confirmations and retrieves all the information related.

Authorizations
sessionidstringOptional
Path parameters
addressstringRequired
Body
safestringRequired
tostringRequired
valueintegerRequired
datastring · nullableOptional
operationintegerRequired
gasTokenstring · nullableOptional
safeTxGasintegerRequired
baseGasintegerRequired
gasPriceintegerRequired
refundReceiverstring · nullableOptional
nonceintegerRequired
contractTransactionHashstringRequired
senderstringRequired
signaturestring · nullableOptional
originstring · max: 200 · nullableOptional
Responses
post
/api/v2/safes/{address}/multisig-transactions/

No content

Last updated