# xspy

> Pay-per-request Twitter/X intelligence APIs settled with USDC via the x402 HTTP 402 protocol (Base and Solana).

## Discovery

- [OpenAPI](https://xspy.pro/openapi.json)
- [x402 resources](https://xspy.pro/x402-resources)
- [x402 resources (well-known)](https://xspy.pro/.well-known/x402-resources)
- [x402 pointer](https://xspy.pro/.well-known/x402)

## x402 payment flow

1. Call a paid endpoint without payment → HTTP 402 with payment details.
2. Pay USDC to the address in the 402 response on the chosen network.
3. Retry the same request with the x402 payment proof header.

See [Coinbase x402 documentation](https://docs.cdp.coinbase.com/x402/welcome) for client libraries and agent patterns.

## Paid endpoints

- `GET /api/v1/pro/trending-accounts` — 0.10 USDC — Trending Twitter/X accounts among crypto smart money for a selected time window (1h–7d), ranked by smart-follower activity.
- `GET /api/v1/pro/twitter/:username/is-smart-follower` — 0.03 USDC — Determine whether a Twitter/X account is a 'smart follower'
- `GET /api/v1/pro/twitter/:username/smart-followers/count` — 0.02 USDC — Total number of smart followers (high-signal crypto accounts) for a given Twitter/X account.
- `GET /api/v1/pro/twitter/:username/smart-followers` — 0.05 USDC — Top smart followers (high-signal crypto accounts) of a Twitter/X account, with profiles and follower metrics.
- `GET /api/v1/pro/twitter/:username/tweets-with-ca-cache` — 0.12 USDC — Cached lookup of a Twitter/X account's recent tweets mentioning token contract addresses (CAs), with detected chain and address. Fast.
- `GET /api/v1/pro/twitter/:username/tweets-with-ca` — 0.25 USDC — Real-time crawl of a Twitter/X account's recent tweets mentioning token contract addresses (CAs), with detected chain and address. Freshest data.
- `GET /api/v1/pro/twitter/:username/username-history` — 0.10 USDC — Historical Twitter/X handle changes for an account, with change timestamps.