Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Safes

get

Get paginated balances for Ether and ERC20 tokens. The maximum limit allowed is 200.

Authorizations
sessionidstringOptional
Path parameters
addressstringRequired
Query parameters
trustedbooleanOptional

If True just trusted tokens will be returned

Default: false
exclude_spambooleanOptional

If True spam tokens will not be returned

Default: false
limitintegerOptional

Number of results to return per page.

offsetintegerOptional

The initial index from which to return the results.

Responses
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}/balances/
GET /api/v2/safes/{address}/balances/ HTTP/1.1
Accept: */*

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "address": "text",
      "tokenName": "text",
      "tokenSymbol": "text",
      "logoUri": "text",
      "id": "text",
      "uri": "text",
      "name": "text",
      "description": "text",
      "imageUri": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}
get

Get paginated collectibles (ERC721 tokens) and information about them of a given Safe account. The maximum limit allowed is 10.

Authorizations
sessionidstringOptional
Path parameters
addressstringRequired
Query parameters
trustedbooleanOptional

If True just trusted tokens will be returned

Default: false
exclude_spambooleanOptional

If True spam tokens will not be returned

Default: false
limitintegerOptional

Number of results to return per page.

offsetintegerOptional

The initial index from which to return the results.

Responses
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}/collectibles/
GET /api/v2/safes/{address}/collectibles/ HTTP/1.1
Accept: */*

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "address": "text",
      "tokenName": "text",
      "tokenSymbol": "text",
      "logoUri": "text",
      "id": "text",
      "uri": "text",
      "name": "text",
      "description": "text",
      "imageUri": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}
get

Returns detailed information of a given Safe account

Authorizations
sessionidstringOptional
Path parameters
addressstringRequired
Responses
200Success
application/json
addressstringRequired
noncestringRequired
thresholdintegerRequired
ownersstring[]Required
masterCopystringRequired
modulesstring[]Required
fallbackHandlerstringRequired
guardstringRequired
versionstring · nullableRequired
get/tx-service/eth/api/v1/safes/{address}/
GET /tx-service/eth/api/v1/safes/{address}/ HTTP/1.1
Accept: */*

{
  "address": "text",
  "nonce": "text",
  "threshold": 1,
  "owners": [
    "text"
  ],
  "masterCopy": "text",
  "modules": [
    "text"
  ],
  "fallbackHandler": "text",
  "guard": "text",
  "version": null
}
get

Returns detailed information on the Safe creation transaction of a given Safe.

Note: When event indexing is being used and multiple Safes are deployed in the same transaction the result might not be accurate due to the indexer not knowing which events belong to which Safe deployment.

Authorizations
sessionidstringOptional
Path parameters
addressstringRequired
Responses
200Success
application/json
createdstring · date-timeRequired
creatorstringRequired
transactionHashstringRequired
factoryAddressstringRequired
masterCopystring · nullableRequired
setupDatastring · nullableRequired
saltNoncestring · nullableRequired
get/tx-service/eth/api/v1/safes/{address}/creation/
GET /tx-service/eth/api/v1/safes/{address}/creation/ HTTP/1.1
Accept: */*

{
  "created": "2026-01-01T00:00:00.000Z",
  "creator": "text",
  "transactionHash": "text",
  "factoryAddress": "text",
  "masterCopy": null,
  "setupData": null,
  "saltNonce": null,
  "dataDecoded": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "userOperation": {
    "ethereumTxHash": "text",
    "sender": "text",
    "userOperationHash": "text",
    "nonce": "text",
    "initCode": null,
    "callData": null,
    "callGasLimit": "text",
    "verificationGasLimit": "text",
    "preVerificationGas": "text",
    "maxFeePerGas": "text",
    "maxPriorityFeePerGas": "text",
    "paymaster": null,
    "paymasterData": null,
    "signature": "text",
    "entryPoint": "text",
    "safeOperation": {
      "created": "2026-01-01T00:00:00.000Z",
      "modified": "2026-01-01T00:00:00.000Z",
      "safeOperationHash": "text",
      "validAfter": "2026-01-01T00:00:00.000Z",
      "validUntil": "2026-01-01T00:00:00.000Z",
      "moduleAddress": "text",
      "confirmations": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "preparedSignature": "text"
    }
  }
}
get

Get transactions optimized for CSV export with transfer information. The maximum limit allowed is 1000.

Authorizations
sessionidstringOptional
Path parameters
addressstringRequired
Query parameters
execution_date__gtestring · date-timeOptional

Filter transactions executed after this date (ISO format)

execution_date__ltestring · date-timeOptional

Filter transactions executed before this date (ISO format)

limitintegerOptional

Maximum number of transactions to return (max 1000)

offsetintegerOptional

Number of transactions to skip

Responses
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/tx-service/eth/api/v1/safes/{address}/export/
GET /tx-service/eth/api/v1/safes/{address}/export/ HTTP/1.1
Accept: */*

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "safe": "text",
      "From": "text",
      "to": "text",
      "amount": "text",
      "assetType": "text",
      "assetAddress": null,
      "assetSymbol": null,
      "assetDecimals": null,
      "proposerAddress": null,
      "proposedAt": null,
      "executorAddress": null,
      "executedAt": null,
      "note": null,
      "transactionHash": "text",
      "contractAddress": null,
      "nonce": null
    }
  ]
}
get

Get paginated balances for Ether and ERC20 tokens. The maximum limit allowed is 200.

Authorizations
sessionidstringOptional
Path parameters
addressstringRequired
Query parameters
trustedbooleanOptional

If True just trusted tokens will be returned

Default: false
exclude_spambooleanOptional

If True spam tokens will not be returned

Default: false
limitintegerOptional

Number of results to return per page.

offsetintegerOptional

The initial index from which to return the results.

Responses
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/tx-service/eth/api/v2/safes/{address}/balances/
GET /tx-service/eth/api/v2/safes/{address}/balances/ HTTP/1.1
Accept: */*

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "address": "text",
      "tokenName": "text",
      "tokenSymbol": "text",
      "logoUri": "text",
      "id": "text",
      "uri": "text",
      "name": "text",
      "description": "text",
      "imageUri": "text",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}
PreviousTransactions
NextModules

Last updated