Skip to main content
GET
List wallet transactions
Use wallet transactions as the reconciliation source of truth. Withdrawals initiated through the API or Stabyl Pro can appear in this timeline. A bulk NGN withdrawal is one parent transaction; read its detail and walk settlement_details.transfers to see the outcome of each bank transfer.List items and details optionally include processing_reason: "liquidity_pending" when a CNGN deposit has funds still awaiting conversion-pool capacity. This is not a new status: a deposit can already have status: "success" while its restricted portion awaits conversion. Use conversion progress for amounts. The reason is omitted after full release or return, and on failed, cancelled, or held deposits; ordinary processing, payout delays, screening, and Travel Rule holds do not produce it. SDKs need an optional reason string on summary and detail models; clients should check processing_reason, tolerate unknown values, and clear an earlier reason when the field is absent.

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. Settlement rail with its wallet currency, availability, fees where applicable, and supported routes.

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, partial, 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