# Smartclaw

> Cross-protocol smart wallet tracking API for AI agents and DeFi traders.

## About

Smartclaw aggregates PNL, ROI, and capital flow signals from protocol leaderboards.
Currently tracking 1,700+ wallets on f(x) Protocol, with Perp DEX and Meme Coin protocols coming soon.

## Allowed URLs

- https://smartclaw.xyz/
- https://smartclaw.xyz/premium
- https://smartclaw.xyz/docs
- https://smartclaw.xyz/fxmint
- https://smartclaw.xyz/api/openapi
- https://smartclaw.xyz/SKILL.md
- https://smartclaw.xyz/agents.json
- https://smartclaw.xyz/feed.xml

## API Endpoints

- GET /api/top-pnl — Global top PNL wallets across all protocols
- GET /api/fx/status — f(x) Protocol health snapshot
- GET /api/fx/top-pnl — f(x) Protocol top PNL wallets
- GET /api/fx/fxusd-rate — fxUSD borrow rate (latest + historical)
- GET /api/rates — Cross-protocol lending rate comparison (Aave, CrvUSD, fxUSD)
- GET /api/premium — Premium leaderboard metrics (x402 payment, $0.01 USDC)

## Authentication

Public endpoints require no authentication.
Premium endpoints use the x402 protocol ($0.01 USDC per call on Base network).

## Machine-Readable Specs

- OpenAPI 3.1: https://smartclaw.xyz/api/openapi
- Agent descriptor: https://smartclaw.xyz/agents.json
- Plugin manifest: https://smartclaw.xyz/.well-known/ai-plugin.json
- RSS feed: https://smartclaw.xyz/feed.xml
- SKILL.md: https://smartclaw.xyz/SKILL.md

## Policy

- All public endpoints are free to call without rate limits.
- Premium data costs $0.01 USDC per request.
- Data is sourced from on-chain snapshots and protocol APIs.
- No personal data is collected or stored.
- AI agents are welcome to index and use this data.

## Contact

For API issues or partnerships, open an issue at: https://github.com/huwangtao123/aicharts