Skip to main content
GET
/
x402
/
transactions
/
{walletAddress}
/api/v1/x402/transactions/{walletAddress}
curl --request GET \
  --url https://api.venice.ai/api/v1/x402/transactions/{walletAddress} \
  --header 'X-Sign-In-With-X: <api-key>'
{
  "success": true,
  "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",
        "requestId": "<string>",
        "modelId": "<string>"
      }
    ],
    "pagination": {
      "limit": 50,
      "offset": 0,
      "hasMore": false
    }
  }
}

Authorizations

​
X-Sign-In-With-X
string
header
required

base64-encoded JSON SIWE payload message proving wallet ownership

Headers

​
X-Sign-In-With-X
string
required

base64-encoded JSON SIWE payload message proving wallet ownership

Example:

"siwx_example_token"

Path Parameters

​
walletAddress
string
required

Ethereum wallet address.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0xYOUR_WALLET_ADDRESS"

Query Parameters

​
limit
integer
default:50

Maximum number of transactions to return.

Required range: 1 <= x <= 100
Example:

50

​
offset
integer | null
default:0

Number of transactions to skip before returning results.

Required range: x >= 0
Example:

0

Response

x402 transaction history for the wallet.

​
success
enum<boolean>
required
Available options:
true
​
data
object
required