{ "opencollection": "1.0.0", "info": { "name": "Safe Transaction Service 4337 transactions API", "version": "6.3.0" }, "items": [ { "info": { "name": "transactions", "type": "folder" }, "items": [ { "info": { "name": "module_transaction_retrieve", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v1/module-transaction/:module_transaction_id", "params": [ { "name": "module_transaction_id", "value": "", "type": "path" } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns a transaction executed from a module given its associated module transaction ID" }, { "info": { "name": "multisig_transactions_retrieve", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v1/multisig-transactions/:safe_tx_hash/", "params": [ { "name": "safe_tx_hash", "value": "", "type": "path" } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns a multi-signature transaction given its Safe transaction hash" }, { "info": { "name": "multisig_transactions_destroy", "type": "http" }, "http": { "method": "DELETE", "url": "{{baseUrl}}/tx-service/eth/api/v1/multisig-transactions/:safe_tx_hash/", "params": [ { "name": "safe_tx_hash", "value": "", "type": "path" } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Removes the queued but not executed multi-signature transaction associated with the given Safe transaction hash.\nOnly the proposer or the delegate who proposed the transaction can delete it.\nIf the transaction was proposed by a delegate, it must still be a valid delegate for the transaction proposer.\nAn EOA is required to sign the following EIP-712 data:\n\n```python\n {\n \"types\": {\n \"EIP712Domain\": [\n {\"name\": \"name\", \"type\": \"string\"},\n {\"name\": \"version\", \"type\": " }, { "info": { "name": "multisig_transactions_confirmations_list", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v1/multisig-transactions/:safe_tx_hash/confirmations/", "params": [ { "name": "safe_tx_hash", "value": "", "type": "path" }, { "name": "limit", "value": "", "type": "query", "description": "Number of results to return per page." }, { "name": "offset", "value": "", "type": "query", "description": "The initial index from which to return the results." } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns the list of confirmations for the multi-signature transaction associated with\nthe given Safe transaction hash" }, { "info": { "name": "multisig_transactions_confirmations_create", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/tx-service/eth/api/v1/multisig-transactions/:safe_tx_hash/confirmations/", "params": [ { "name": "safe_tx_hash", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Adds a new confirmation to the pending multi-signature transaction associated with the\ngiven Safe transaction hash. Multiple signatures can be submitted at once. This endpoint\ndoes not support the use of delegates to make transactions trusted." }, { "info": { "name": "safes_all_transactions_list", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v1/safes/:address/all-transactions/", "params": [ { "name": "address", "value": "", "type": "path" }, { "name": "ordering", "value": "", "type": "query", "description": "Which field to use when ordering the results." }, { "name": "limit", "value": "", "type": "query", "description": "Number of results to return per page." }, { "name": "offset", "value": "", "type": "query", "description": "The initial index from which to return the results." } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns all the *executed* transactions for a given Safe address.\nThe list has different structures depending on the transaction type:\n- Multisig Transactions for a Safe. `tx_type=MULTISIG_TRANSACTION`.\n- Module Transactions for a Safe. `tx_type=MODULE_TRANSACTION`\n- Incoming Transfers of Ether/ERC20 Tokens/ERC721 Tokens. `tx_type=ETHEREUM_TRANSACTION`\nOrdering_fields: [\"timestamp\"] eg: `-timestamp` (default one) or `timestamp`\n\nNote: This endpoint has a bug that will be fixed in next versions o" }, { "info": { "name": "safes_incoming_transfers_list", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v1/safes/:address/incoming-transfers/", "params": [ { "name": "address", "value": "", "type": "path" }, { "name": "_from", "value": "", "type": "query" }, { "name": "block_number", "value": "", "type": "query" }, { "name": "block_number__gt", "value": "", "type": "query" }, { "name": "block_number__lt", "value": "", "type": "query" }, { "name": "execution_date__gte", "value": "", "type": "query" }, { "name": "execution_date__lte", "value": "", "type": "query" }, { "name": "execution_date__gt", "value": "", "type": "query" }, { "name": "execution_date__lt", "value": "", "type": "query" }, { "name": "to", "value": "", "type": "query" }, { "name": "token_address", "value": "", "type": "query" }, { "name": "transaction_hash", "value": "", "type": "query" }, { "name": "value", "value": "", "type": "query" }, { "name": "value__gt", "value": "", "type": "query" }, { "name": "value__lt", "value": "", "type": "query" }, { "name": "erc20", "value": "", "type": "query" }, { "name": "erc721", "value": "", "type": "query" }, { "name": "ether", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query", "description": "Number of results to return per page." }, { "name": "offset", "value": "", "type": "query", "description": "The initial index from which to return the results." } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns incoming ether/tokens transfers for a Safe.\nOnly 1000 newest transfers will be returned." }, { "info": { "name": "safes_module_transactions_list", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v1/safes/:address/module-transactions/", "params": [ { "name": "address", "value": "", "type": "path" }, { "name": "safe", "value": "", "type": "query" }, { "name": "module", "value": "", "type": "query" }, { "name": "to", "value": "", "type": "query" }, { "name": "operation", "value": "", "type": "query", "description": "* `0` - CALL\n* `1` - DELEGATE_CALL\n* `2` - CREATE" }, { "name": "failed", "value": "", "type": "query" }, { "name": "block_number", "value": "", "type": "query" }, { "name": "block_number__gt", "value": "", "type": "query" }, { "name": "block_number__lt", "value": "", "type": "query" }, { "name": "transaction_hash", "value": "", "type": "query" }, { "name": "ordering", "value": "", "type": "query", "description": "Which field to use when ordering the results." }, { "name": "limit", "value": "", "type": "query", "description": "Number of results to return per page." }, { "name": "offset", "value": "", "type": "query", "description": "The initial index from which to return the results." } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns all the transactions executed from modules given a Safe address" }, { "info": { "name": "safes_multisig_transactions_list", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v1/safes/:address/multisig-transactions/", "params": [ { "name": "address", "value": "", "type": "path" }, { "name": "failed", "value": "", "type": "query" }, { "name": "modified__lt", "value": "", "type": "query" }, { "name": "modified__gt", "value": "", "type": "query" }, { "name": "modified__lte", "value": "", "type": "query" }, { "name": "modified__gte", "value": "", "type": "query" }, { "name": "nonce__lt", "value": "", "type": "query" }, { "name": "nonce__gt", "value": "", "type": "query" }, { "name": "nonce__lte", "value": "", "type": "query" }, { "name": "nonce__gte", "value": "", "type": "query" }, { "name": "nonce", "value": "", "type": "query" }, { "name": "safe_tx_hash", "value": "", "type": "query" }, { "name": "to", "value": "", "type": "query" }, { "name": "value__lt", "value": "", "type": "query" }, { "name": "value__gt", "value": "", "type": "query" }, { "name": "value", "value": "", "type": "query" }, { "name": "executed", "value": "", "type": "query" }, { "name": "has_confirmations", "value": "", "type": "query" }, { "name": "trusted", "value": "", "type": "query" }, { "name": "execution_date__gte", "value": "", "type": "query" }, { "name": "execution_date__lte", "value": "", "type": "query" }, { "name": "submission_date__gte", "value": "", "type": "query" }, { "name": "submission_date__lte", "value": "", "type": "query" }, { "name": "transaction_hash", "value": "", "type": "query" }, { "name": "ordering", "value": "", "type": "query", "description": "Which field to use when ordering the results." }, { "name": "limit", "value": "", "type": "query", "description": "Number of results to return per page." }, { "name": "offset", "value": "", "type": "query", "description": "The initial index from which to return the results." } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns all the multi-signature transactions for a given Safe address.\nBy default, only ``trusted`` multisig transactions are returned." }, { "info": { "name": "safes_multisig_transactions_create", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/tx-service/eth/api/v1/safes/:address/multisig-transactions/", "params": [ { "name": "address", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Creates a multi-signature transaction for a given Safe account with its confirmations and\nretrieves all the information related." }, { "info": { "name": "safes_multisig_transactions_estimations_create", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/tx-service/eth/api/v1/safes/:address/multisig-transactions/estimations/", "params": [ { "name": "address", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns the estimated `safeTxGas` for a given Safe address and multi-signature transaction.\nEstimation is disabled for L2 networks, as this is only required for Safes with version < 1.3.0\nand those versions are not supported in L2 networks." }, { "info": { "name": "safes_transfers_list", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v1/safes/:address/transfers/", "params": [ { "name": "address", "value": "", "type": "path" }, { "name": "_from", "value": "", "type": "query" }, { "name": "block_number", "value": "", "type": "query" }, { "name": "block_number__gt", "value": "", "type": "query" }, { "name": "block_number__lt", "value": "", "type": "query" }, { "name": "execution_date__gte", "value": "", "type": "query" }, { "name": "execution_date__lte", "value": "", "type": "query" }, { "name": "execution_date__gt", "value": "", "type": "query" }, { "name": "execution_date__lt", "value": "", "type": "query" }, { "name": "to", "value": "", "type": "query" }, { "name": "token_address", "value": "", "type": "query" }, { "name": "transaction_hash", "value": "", "type": "query" }, { "name": "value", "value": "", "type": "query" }, { "name": "value__gt", "value": "", "type": "query" }, { "name": "value__lt", "value": "", "type": "query" }, { "name": "erc20", "value": "", "type": "query" }, { "name": "erc721", "value": "", "type": "query" }, { "name": "ether", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query", "description": "Number of results to return per page." }, { "name": "offset", "value": "", "type": "query", "description": "The initial index from which to return the results." } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns the list of token transfers for a given Safe address.\nOnly 1000 newest transfers will be returned." }, { "info": { "name": "transfer_retrieve", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v1/transfer/:transfer_id", "params": [ { "name": "transfer_id", "value": "", "type": "path" } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns a token transfer associated with the given transfer ID" }, { "info": { "name": "multisig_transactions_retrieve_2", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v2/multisig-transactions/:safe_tx_hash/", "params": [ { "name": "safe_tx_hash", "value": "", "type": "path" } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns a multi-signature transaction given its Safe transaction hash" }, { "info": { "name": "multisig_transactions_destroy_2", "type": "http" }, "http": { "method": "DELETE", "url": "{{baseUrl}}/tx-service/eth/api/v2/multisig-transactions/:safe_tx_hash/", "params": [ { "name": "safe_tx_hash", "value": "", "type": "path" } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Removes the queued but not executed multi-signature transaction associated with the given Safe transaction hash.\nOnly the proposer or the delegate who proposed the transaction can delete it.\nIf the transaction was proposed by a delegate, it must still be a valid delegate for the transaction proposer.\nAn EOA is required to sign the following EIP-712 data:\n\n```python\n {\n \"types\": {\n \"EIP712Domain\": [\n {\"name\": \"name\", \"type\": \"string\"},\n {\"name\": \"version\", \"type\": " }, { "info": { "name": "safes_all_transactions_list_2", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v2/safes/:address/all-transactions/", "params": [ { "name": "address", "value": "", "type": "path" }, { "name": "ordering", "value": "", "type": "query", "description": "Which field to use when ordering the results." }, { "name": "limit", "value": "", "type": "query", "description": "Number of results to return per page." }, { "name": "offset", "value": "", "type": "query", "description": "The initial index from which to return the results." } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns all the *executed* transactions for a given Safe address.\nThe list has different structures depending on the transaction type:\n- Multisig Transactions for a Safe. `tx_type=MULTISIG_TRANSACTION`.\n- Module Transactions for a Safe. `tx_type=MODULE_TRANSACTION`\n- Incoming Transfers of Ether/ERC20 Tokens/ERC721 Tokens. `tx_type=ETHEREUM_TRANSACTION`\nOrdering_fields: [\"timestamp\"] eg: `-timestamp` (default one) or `timestamp`\n\nNote: This endpoint has a bug that will be fixed in next versions o" }, { "info": { "name": "safes_multisig_transactions_list_2", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/tx-service/eth/api/v2/safes/:address/multisig-transactions/", "params": [ { "name": "address", "value": "", "type": "path" }, { "name": "failed", "value": "", "type": "query" }, { "name": "modified__lt", "value": "", "type": "query" }, { "name": "modified__gt", "value": "", "type": "query" }, { "name": "modified__lte", "value": "", "type": "query" }, { "name": "modified__gte", "value": "", "type": "query" }, { "name": "nonce__lt", "value": "", "type": "query" }, { "name": "nonce__gt", "value": "", "type": "query" }, { "name": "nonce__lte", "value": "", "type": "query" }, { "name": "nonce__gte", "value": "", "type": "query" }, { "name": "nonce", "value": "", "type": "query" }, { "name": "safe_tx_hash", "value": "", "type": "query" }, { "name": "to", "value": "", "type": "query" }, { "name": "value__lt", "value": "", "type": "query" }, { "name": "value__gt", "value": "", "type": "query" }, { "name": "value", "value": "", "type": "query" }, { "name": "executed", "value": "", "type": "query" }, { "name": "has_confirmations", "value": "", "type": "query" }, { "name": "trusted", "value": "", "type": "query" }, { "name": "execution_date__gte", "value": "", "type": "query" }, { "name": "execution_date__lte", "value": "", "type": "query" }, { "name": "submission_date__gte", "value": "", "type": "query" }, { "name": "submission_date__lte", "value": "", "type": "query" }, { "name": "transaction_hash", "value": "", "type": "query" }, { "name": "ordering", "value": "", "type": "query", "description": "Which field to use when ordering the results." }, { "name": "limit", "value": "", "type": "query", "description": "Number of results to return per page." }, { "name": "offset", "value": "", "type": "query", "description": "The initial index from which to return the results." } ], "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Returns all the multi-signature transactions for a given Safe address.\nBy default, only ``trusted`` multisig transactions are returned." }, { "info": { "name": "safes_multisig_transactions_create_2", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/tx-service/eth/api/v2/safes/:address/multisig-transactions/", "params": [ { "name": "address", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "sessionid", "value": "{{sessionid}}", "placement": "query" } }, "docs": "Creates a multi-signature transaction for a given Safe account with its confirmations and\nretrieves all the information related." } ] } ], "bundled": true }