List wallet transactions
Returns the transactions recorded against one API wallet, with filtering and pagination.
Path parameters
The wallet's id.
Query parameters
These parameters are snake_case, unlike the camelCase used everywhere
else in the API. Sending perPage, dateFrom, or dateTo is not an error —
the parameter is silently ignored and you get unfiltered results with the
default page size. Spell them exactly as below.
The page to fetch. Minimum 1.
Items per page. Minimum 1, maximum 100.
Filter to one network identifier.
Filter to one token symbol.
Filter to one transaction status, for example SUCCESSFUL.
Only transactions on or after this date.
Only transactions on or before this date. Must not be earlier than
date_from.
The response still uses camelCase, so you send per_page and read perPage
back out of the pagination object.
Request
curl -G "https://api-prod.useknit.io/api/v1/wallets/d95143d2-c076-49da-b121-b3beed054bf3/transactions" \
-H "Authorization: Bearer $KNIT_ACCESS_TOKEN" \
-H "Accept: application/json" \
--data-urlencode "status=SUCCESSFUL" \
--data-urlencode "per_page=25" \
--data-urlencode "page=1"Response
This endpoint paginates, so the envelope carries a pagination object
alongside data.
{
"statusCode": 200,
"message": "Wallet transactions fetched successfully",
"data": [
{
"id": "75229581-5709-4b0a-886d-12ea1328e6a7",
"walletId": "d95143d2-c076-49da-b121-b3beed054bf3",
"network": "MATIC_MAINNET",
"token": "USDT",
"fromAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"toAddress": "0x1adb0a39bde00fa0957e519584cb5c51fefcb37f",
"value": "1.00000000",
"numberOfConfirmations": 12,
"status": "SUCCESSFUL",
"transactionHash": "0xa8ba7949431a95f71430ae6ce30aa5c2e488e6206996",
"createdAt": "2024-02-23T18:20:40.000000Z",
"updatedAt": "2024-02-23T18:20:40.000000Z"
}
],
"pagination": {
"totalItems": 128,
"page": 1,
"perPage": 25,
"currentPage": 1,
"lastPage": 6
},
"success": true
}Errors
| Status | Cause |
|---|---|
401 | Missing or invalid token, IP not allow-listed, or missing wallets:read |
404 | No wallet with that ID belongs to your business |
422 | per_page is above 100, or date_to is earlier than date_from. Query-parameter failures on this endpoint return the full envelope with errors — see Requests & responses |
