Overview

Transactions move value from a wallet to an on-chain destination. Use these endpoints to create a transaction (auto-signed with your API key), list transactions with filters, or retrieve a single transaction by ID.


List Transactions

Use Case

Returns a paginated list of transactions. Filter by wallet, status, direction, asset, or created-at range.

List Transactions

Query Parameters
1
starting_afterstring

Opaque cursor — pass the `next_cursor` from a prior response to fetch the next page.

2
ending_beforestring

Opaque cursor for reverse pagination.

3
limitinteger

Page size. Bounded by the endpoint's max.

4
wallet_iduuid

Filter to transactions belonging to a single wallet.

5
statusstring

Filter by transaction status (e.g., `pending`, `completed`, `failed`).

6
directionstring

`inbound` or `outbound`.

7
assetstring

Filter by asset symbol (e.g., `ETH`, `USDC_ETH`).

8
created_at[gte]string (RFC3339)

Lower bound on the created-at timestamp.

9
created_at[lte]string (RFC3339)

Upper bound on the created-at timestamp.

List Transactions Response

Create Transaction

Use Case

Creates a new transaction. The transaction is automatically signed using your API key credentials and submitted for broadcast.

Create Transaction

Request Body
1
wallet_iduuidRequired

Source wallet ID.

2
to_addressstringRequired

Recipient on-chain address.

3
amountstringRequired

Transfer amount in the asset's smallest unit, as a string to preserve precision.

4
assetstringRequired

Asset symbol (e.g., `USDC`, `ETH`).

5
networkstring

Blockchain network (e.g., `mainnet`, `sepolia`). Defaults to the environment's default network when omitted.

6
fee_levelstring

Fee tier: `low`, `medium`, or `high`.

7
gas_station_iduuid

Gas station to sponsor the fee. Required only when `sponsor_gas` is `true`.

8
sponsor_gasboolean

When `true`, the gas station referenced by `gas_station_id` pays the on-chain fee.

9
notestring

Free-form description for your own bookkeeping.

Example Payload

Create Transaction Response
Same shape as Get Transaction Response

data is a single TransactionResponse — the same object shape returned by Get Transaction Response. Refer there for the per-field explanations.

Create Transaction Response

Get Transaction

Use Case

Returns a single transaction by ID.

Get Transaction

Get Transaction Response
1
idstring (uuid)

Unique transaction identifier.

2
wallet_idstring (uuid)

Source wallet.

3
from_addressstring

Address that funded the transfer.

4
to_addressstring

Recipient on-chain address.

5
amountstring

Transferred amount in the asset's smallest unit.

6
assetstring

Asset symbol (e.g., `USDC`, `ETH`).

7
asset_decimalsinteger

Number of decimals for the asset — use it to convert `amount` to a human-readable value.

8
statusstring

Lifecycle status (`pending`, `signed`, `broadcast`, `completed`, `failed`).

9
directionstring

`inbound` or `outbound`.

10
tx_hashstring

On-chain transaction hash. Empty until the transaction has been broadcast.

11
created_atstring (RFC3339)

When the transaction record was created.

12
signed_atstring (RFC3339)

When the transaction was signed by the Enclave.

13
broadcast_atstring (RFC3339)

When the signed transaction was submitted to the network.

14
completed_atstring (RFC3339)

When the transaction reached its final state.

15
fee_amountstring

Fee paid for the transaction, in the gas asset's smallest unit.

16
confirmationsinteger

Number of confirmations observed.

17
block_numberinteger

Block height the transaction was mined into.

18
notestring

Free-form description supplied at creation.

19
gas_station_idstring (uuid)

Gas station that sponsored the fee, if any.

20
sponsoredboolean

`true` when the fee was paid by a gas station.

Get Transaction Response
Did you find this page useful?

Join our Discord