---
title: "Paid: Social Analytics"
method: POST
path: "/api/x402/analytics"
---

# Paid: Social Analytics

`POST /api/x402/analytics`

## Request

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

three.ws Economy Analytics — pay $0.005 USDC per call for a live, aggregated view of platform activity. "clubs": Pole Club economy — active stages, patrons, tip volume, cover charges, fastest-growing leaderboard. "agent_leaderboard": top agents by USDC spend over a trailing window. "marketplace": catalog stats — active listing count, price distribution normalised to USD + SOL at the live rate, new listings in the window, and the most-viewed / most-forked listing. All numbers are read live from the real ledgers and catalog tables.

## Request body

- object
  - `report` 'clubs' | 'agent_leaderboard' | 'marketplace' | 'revenue' | 'sniper_trades' | 'user_activity' | 'x402_volume'
  - `period` '1h' | '6h' | '24h' | '7d' | '30d' | 'all'
  - `limit` integer
  - `window_days` integer
  - `network` 'mainnet' | 'devnet' | 'all'

## Response `200`

three.ws Social Analytics 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)