User's transactions

Unified transactions endpoint for the authenticated user. The API always forwards ibexid=<externalUserId from JWT> to BCReader (externalUserId / externaluserid aliases are equivalent in BCReader).

Scopes:

Default (no walletAddress and no iban): all user wallets and IBANs via /v1.2/transactions.
walletAddress: one user-owned wallet via /v1.2/transactions/:identifier.
iban: one IBAN via /v1.2/transactions/:identifier.

If both walletAddress and iban are provided, the request is rejected with 400.

Default values when omitted:

startDate=2025-01-01
endDate=<tomorrow UTC date>
page=1
limit=50
includePrices=true

Pagination note:

This endpoint is paginated by design.
There is no "return all transactions in one call" mode.
To fetch full history, iterate over page until totalPages is reached (or until returned data is empty), then merge pages client-side.

Authorization

AuthorizationRequiredBearer <token>

In: header

Query Parameters

walletAddressstring

Optional wallet scope. Must belong to the authenticated user: /users/me/address signers[].safes[].address or signers[].addresses[].address (including derived.global.eoaAddresses).

ibanstring

Optional IBAN scope. Spaces are allowed in input and will be normalized. Cannot be used with walletAddress.

startDatestring

Start date (YYYY-MM-DD)

endDatestring

End date (YYYY-MM-DD)

directionstring

Filter by direction

Value in: "IN" | "OUT"

tokenTypestring

Filter by token type

Value in: "ERC20" | "ERC721" | "ERC1155" | "NATIVE"

tokenAddressstring

Filter by token address (0x… or comma-separated)

hashstring

Filter by transaction hash

pagestring

Page number

Default: "1"

limitstring

Items per page

Default: "50"

includePricesstring

Attach real-time prices

Default: "true"Value in: "true" | "false"

curl -X GET "https://passkeys-testnet.ibex.fi/v1.2/users/me/transactions?walletAddress=%3Cstring%3E&iban=%3Cstring%3E&startDate=%3Cstring%3E&endDate=%3Cstring%3E&direction=IN&tokenType=ERC20&tokenAddress=%3Cstring%3E&hash=%3Cstring%3E&page=1&limit=50&includePrices=true" \
  -H "Authorization: Bearer <token>"

Default Response

{}

User's transactions

Authorization

Query Parameters

Response

TypeScript