# 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/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 — Public leaderboard metrics (top PNL and ROI)

## Authentication

Public endpoints require no authentication.
All listed endpoints are free and public.

## 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.
- 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/smartclaw