---
title: "Paid: Spend Session Health"
method: POST
path: "/api/x402/spend-session"
---

# Paid: Spend Session Health

`POST /api/x402/spend-session`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/x402/spend-session`
- Auth: none required

three.ws Spend Session Health — pay $0.01 USDC to probe the Agent Payment Sessions governance layer. mode:"canary" creates a canary session row and immediately consumes it, returning { created, consumed, latency_ms } — the most important health check for the x402 governance layer. mode:"audit" returns a live aggregate snapshot of all payment sessions (active count, remaining budget, expired_count_24h). Pay-per-call in USDC on Solana mainnet.

## Request body

- object
  - `mode` 'canary' | 'audit'
  - `budget` number

## Response `200`

three.ws Spend Session Health result JSON

## Other responses

- `400`: Validation error
- `402`: Payment Required (x402)

---

[API](https://skmtc.dev/three/apis/three-ws-api.md) · [All operations](https://skmtc.dev/three/apis/three-ws-api/llms.txt) · [OpenAPI document](https://skmtc.dev/three/apis/three-ws-api/revisions/dbc5e3a81b79?raw)