Transactions

Transactions

Transactions are the accounting layer.

They include x402 debits, credits, and related metadata.

Endpoints

• GET /api/transactions — list all transactions

• POST /api/transactions — record a transaction

Transaction object

{
  "id": "uuid",
  "type": "debit",
  "amount": 9.99,
  "currency": "USDC",
  "description": "Domain registration: example.com",
  "status": "completed",
  "fromAddress": "0x742d35Cc...",
  "toAddress": "0x36363e573a3b5d4C22b6A64ef3080E5C101E685F",
  "txHash": "0xabc123...",
  "metadata": {
    "protocol": "x402",
    "chainId": 8453,
    "orderId": "a1b2c3d4...",
    "category": "domain"
  },
  "createdAt": "2026-02-20T12:00:00.000Z"
}

Record a transaction

POST /api/transactions

curl -sS -X POST "https://app.otonix.tech/api/transactions" \
  -H "Content-Type: application/json" \
  -d '{
    "type":"debit",
    "amount":9.99,
    "currency":"USDC",
    "description":"Domain registration: example.com",
    "status":"completed",
    "fromAddress":"0x742d35Cc...",
    "toAddress":"0x36363e573a3b5d4C22b6A64ef3080E5C101E685F",
    "txHash":"0xabc123...",
    "metadata":{
      "protocol":"x402",
      "chainId":8453,
      "orderId":"a1b2c3d4...",
      "category":"domain"
    }
  }'

x402 invariants

x402-related transactions must include:

• metadata.protocol = "x402"

• metadata.chainId = 8453

Use metadata.category to separate domain, vps, and compute spend.