Wallet
Get transaction history
Fetch paginated transaction history from the audit log
GET
/
wallets
/
me
/
history
curl "https://api.useknot.xyz/wallets/me/history?limit=50&offset=0&action=transfer" \
-H "Authorization: Bearer <token>"
{
"status": true,
"data": {
"transactions": [
{
"id": "uuid",
"action": "transfer",
"asset": "USDC",
"amount": 100,
"to": "RecipientAddress...",
"signature": "5UfgJ3vN...",
"status": "confirmed",
"metadata": {},
"createdAt": "2025-01-10T12:00:00.000Z"
}
],
"pagination": {
"total": 150,
"limit": 50,
"offset": 0,
"hasMore": true
}
}
}
Returns a paginated list of the agent’s past transactions from the audit log. Filter by action type and use
limit and offset for pagination.
Requires authentication via Bearer token.
Query parameters
number
default:"50"
Maximum number of transactions to return. Cannot exceed
100.number
default:"0"
Number of records to skip for pagination.
string
Filter results by action type. Accepted values:
transfer, trade, deposit.Response
boolean
true when the request succeeds.object
Show properties
Show properties
array
Array of transaction records.
Show item properties
Show item properties
string
Transaction ID (UUID).
string
Action type, e.g.,
transfer or trade.string
Asset involved in the transaction.
number
Transaction amount.
string
Recipient address. Present for transfer transactions.
string
On-chain transaction signature.
string
Transaction status, e.g.,
confirmed.object
Additional metadata specific to the action type.
string
Timestamp when the transaction was created (ISO 8601).
Errors
| Status | Description |
|---|---|
401 | Missing or invalid Bearer token |
429 | Rate limit exceeded |
curl "https://api.useknot.xyz/wallets/me/history?limit=50&offset=0&action=transfer" \
-H "Authorization: Bearer <token>"
{
"status": true,
"data": {
"transactions": [
{
"id": "uuid",
"action": "transfer",
"asset": "USDC",
"amount": 100,
"to": "RecipientAddress...",
"signature": "5UfgJ3vN...",
"status": "confirmed",
"metadata": {},
"createdAt": "2025-01-10T12:00:00.000Z"
}
],
"pagination": {
"total": 150,
"limit": 50,
"offset": 0,
"hasMore": true
}
}
}
curl "https://api.useknot.xyz/wallets/me/history?limit=50&offset=0&action=transfer" \
-H "Authorization: Bearer <token>"
{
"status": true,
"data": {
"transactions": [
{
"id": "uuid",
"action": "transfer",
"asset": "USDC",
"amount": 100,
"to": "RecipientAddress...",
"signature": "5UfgJ3vN...",
"status": "confirmed",
"metadata": {},
"createdAt": "2025-01-10T12:00:00.000Z"
}
],
"pagination": {
"total": 150,
"limit": 50,
"offset": 0,
"hasMore": true
}
}
}