Skip to main content
GET
List wallet transactions

Authorizations

X-Api-Key
string
header
default:sb_test_your_key
required

API credential. Withdrawal quote and submit operations additionally require the documented Ed25519 timestamp, nonce, and signature headers.

Query Parameters

cursor
string | null

Opaque cursor returned as next_cursor by the previous response for this endpoint.

limit
integer<int32> | null

Number of transactions to return. Defaults to 20 and is capped by the API.

Required range: x >= 0
rail
null | enum<string>

Filter wallet activity by rail, such as fiat or crypto. Stablecoin rail and enabled chain routes for USD settlement.

Available options:
fiat,
crypto
currency
string | null

Filter wallet activity by wallet currency, such as NGN or USD.

status
string | null

Filter wallet activity by status, such as pending, processing, success, failed, cancelled, or hold.

tx_type
string | null

Filter by transaction type: deposit, withdrawal, refund, fee, or adjustment.

date_from
string | null

Inclusive lower time bound. Accepts RFC3339 or date-only YYYY-MM-DD; date-only values start at midnight UTC.

date_to
string | null

Inclusive upper time bound. Accepts RFC3339 or date-only YYYY-MM-DD; date-only values include the full UTC day.

reference
string | null

Case-insensitive partial match against the transaction reference.

Response

Wallet transactions

data
object
required

Cursor-paginated wallet transaction timeline.

status
enum<string>
required
Available options:
success