SDK Explorer

Lists all transactions. Includes details such as status, source/destination, and transaction hash.

Parameters
blockchain
string

Filter by blockchain.

Allowed valuesETHETH-SEPOLIAAVAXAVAX-FUJIMATICMATIC-AMOYSOLSOL-DEVNETARBARB-SEPOLIANEARNEAR-TESTNETEVMEVM-TESTNETUNIUNI-SEPOLIABASEBASE-SEPOLIAOPOP-SEPOLIA
custody_type
string

Filter by the custody type.

Allowed valuesDEVELOPERENDUSER
destination_address
string

Filter by the destination address.

include_all
boolean

Return all recourses with monitored and non-monitored tokens.

operation
string

Filter by the operation of the transaction.

Allowed valuesTRANSFERCONTRACT_EXECUTIONCONTRACT_DEPLOYMENT
state
string

Filter by the state of the transaction.

Allowed valuesCANCELLEDCONFIRMEDCOMPLETEDENIEDFAILEDINITIATEDPENDING_RISK_SCREENINGQUEUEDSENT
tx_hash
string

Filter on the transaction hash of the transaction.

tx_type
string

Filter by on the transaction type.

Allowed valuesINBOUNDOUTBOUND
wallet_ids
string

Filter by the wallet IDs, this parameter is a comma separated list of ids.

from
string

Queries items created since the specified date-time (inclusive) in ISO 8601 format.

to
string

Queries items created before the specified date-time (inclusive) in ISO 8601 format.

page_before
string

A collection ID value used for pagination.

It marks the exclusive end of a page. When provided, the collection resource will return the next n items before the id, with n being specified by pageSize.

The items will be returned in the natural order of the collection.

The resource will return the first page if neither pageAfter nor pageBefore are specified.

SHOULD NOT be used in conjunction with pageAfter.

page_after
string

A collection ID value used for pagination.

It marks the exclusive begin of a page. When provided, the collection resource will return the next n items after the id, with n being specified by pageSize.

The items will be returned in the natural order of the collection.

The resource will return the first page if neither pageAfter nor pageBefore are specified.

SHOULD NOT be used in conjunction with pageBefore.

page_size
integer

Limits the number of items to be returned.

Some collections have a strict upper bound that will disregard this value. In case the specified value is higher than the allowed limit, the collection limit will be used.

If avoided, the collection will determine the page size itself.

Responses
Example
1from circle.web3 import developer_controlled_wallets
2from circle.web3 import utils
3
4client = utils.init_developer_controlled_wallets_client(api_key=key, entity_secret=entitySecret)
5
6api_instance = developer_controlled_wallets.TransactionsApi(client)
7response = api_instance.list_transactions()
8print(response.json())
9
ResponseChoose an example
1{
2  "data": {
3    "transactions": [
4      {
5        "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
6        "abi_function_signature": "burn(uint256)",
7        "abi_parameters": [
8          "100",
9          "1"
10        ],
11        "amounts": [
12          "6.62607015"
13        ],
14        "amount_in_usd": "",
15        "block_hash": "",
16        "block_height": 0,
17        "blockchain": "MATIC-AMOY",
18        "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
19        "create_date": "2023-01-01T12:04:05Z",
20        "custody_type": "DEVELOPER",
21        "destination_address": "0xca9142d0b9804ef5e239d3bc1c7aa0d1c74e7350",
22        "error_reason": "",
23        "error_details": "",
24        "estimated_fee": {
25          "gas_limit": "21000",
26          "gas_price": "",
27          "max_fee": "5.935224468",
28          "priority_fee": "1.022783914",
29          "base_fee": "1.022783914",
30          "network_fee": "0.0001246397138"
31        },
32        "fee_level": "MEDIUM",
33        "first_confirm_date": "2021-05-18T00:00:00Z",
34        "network_fee": "",
35        "network_fee_in_usd": "",
36        "nfts": [
37          "[{\"ntfTokenId\":\"12321\"",
38          "\"metadata\":\"ipfs://QmZcH4YvBVVRJtdn4RdbaqgspFU8gH6P9vomDpBVpAL3u4/1\"}",
39          "{\"ntfTokenId\":\"12322\"",
40          "\"metadata\":\"ipfs://QmZcH4YvBVVRJtdn4RdbaqgspFU8gH6P9vomDpBVpAL3u4/2\"}]"
41        ],
42        "operation": "TRANSFER",
43        "ref_id": "grouptransaction123",
44        "source_address": "0xca9142d0b9804ef5e239d3bc1c7aa0d1c74e7350",
45        "state": "CANCELLED",
46        "token_id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
47        "transaction_type": "INBOUND",
48        "tx_hash": "0x4a25cc5e661d8504b59c5f38ba93f010e8518966f00e2ceda7955c4b8621357d",
49        "update_date": "2023-01-01T12:04:05Z",
50        "user_id": "ext_user_id_1",
51        "wallet_id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
52        "transaction_screening_evaluation": {
53          "rule_name": "Low Gambling Risk (Owner)",
54          "actions": [
55            "REVIEW"
56          ],
57          "screening_date": "2023-01-01T12:04:05Z",
58          "reasons": [
59            {
60              "source": "ADDRESS",
61              "source_value": "0x1bf9ad0cc2ad298c69a2995aa806ee832788218c",
62              "risk_score": "LOW",
63              "risk_categories": [
64                "GAMBLING"
65              ],
66              "type": "OWNERSHIP"
67            }
68          ]
69        }
70      }
71    ]
72  }
73}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.