x402

/api/v1/x402/transactions/{walletAddress}

Get paginated x402 transaction history for a wallet address. Requires Sign-in-with-x authentication for the same EVM or Solana wallet.

get/api/v1/x402/transactions/{walletAddress}

Request

  • Base URL: https://api.venice.ai
  • URL: https://api.venice.ai/api/v1/x402/transactions/{walletAddress}
  • Auth: API key in header SIGN-IN-WITH-X

Path parameters

walletAddressstring required

EVM or Solana wallet address.

Example:0xYOUR_WALLET_ADDRESS

Query parameters

limitinteger

Maximum number of transactions to return.

Example:50
offsetinteger nullable

Number of transactions to skip before returning results.

Headers

SIGN-IN-WITH-Xstring required
Example:siwx_example_token

base64-encoded JSON SIWX payload proving EVM or Solana wallet ownership. The legacy X-Sign-In-With-X header is also accepted during migration.

Response

x402 transaction history for the wallet.

successtrue required

Example response

{
  "data": {
    "walletAddress": "0xyour_wallet_address",
    "currentBalance": 12.35,
    "transactions": [
      {
        "id": "ledger_01HZY8M4W4Y6QZ8B6Q4P0V3J2K",
        "amount": -0.15,
        "balanceAfter": 12.35,
        "type": "TOP_UP",
        "createdAt": "2026-04-03T12:34:56.000Z"
      }
    ],
    "pagination": {
      "limit": 50
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.