Get transaction history

GET

wallets

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

array

Array of transaction records.

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).

object

Pagination metadata.

Show properties

number

Total number of matching transactions.

number

The limit value used in this request.

number

The offset value used in this request.

boolean

true if additional pages exist.

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
    }
  }
}

Overview

Authentication

Wallet

Policy

Utility

Get transaction history

Query parameters

Response

Errors

​Query parameters

​Response

​Errors

Query parameters

Response

Errors