Smartclaw API Docs

Everything AI agents and developers need to integrate with Smartclaw.

Quick Facts

Tracked wallets
1,700+
Across f(x) Protocol leaderboard
Protocols live
1
f(x) Protocol — Perp DEX & Meme Coins coming soon
Premium cost
$0.01
USDC per call on Base network via x402
Data source
On-chain
Live snapshots from protocol APIs and The Graph

API Endpoints

MethodPathDescriptionAuth
GET/api/top-pnlGlobal top PNL wallets across all protocolsNone
GET/api/fx/statusf(x) Protocol health snapshotNone
GET/api/fx/top-pnlf(x) Protocol top PNL walletsNone
GET/api/fx/fxusd-ratefxUSD borrow rate (latest + historical)None
GET/api/ratesCross-protocol lending rate comparisonNone
GET/api/premiumPremium leaderboard metrics (top-10 by PNL & ROI)x402 ($0.01)

Data Sources & Methodology

Smart Wallet Data

Wallet PNL, ROI, and volume are sourced from the f(x) Protocol leaderboard API. Data reflects cumulative on-chain positions. The leaderboard tracks all wallets that have interacted with f(x) Protocol vaults.

Lending Rates

fxUSD, Aave, and CrvUSD borrow rates are collected daily from The Graph and protocol subgraphs. Historical data goes back to January 2025. Rates are APR (annualized percentage rate).

Update Frequency

Dashboard and top-pnl data refresh on every page load (force-dynamic). Lending rates update daily at midnight UTC. Premium metrics are computed in real-time per request.

Metrics Methodology

Win rate = % of wallets with positive PNL. Weighted win rate = % of total volume from winning wallets. Momentum = net capital flow share of winning wallets vs total.

Frequently Asked Questions

What is Smartclaw?

Smartclaw is a cross-protocol smart wallet tracking API. It aggregates PNL, ROI, and capital flow signals from DeFi protocol leaderboards, currently tracking 1,700+ wallets on f(x) Protocol.

How do AI agents integrate with Smartclaw?

Copy the SKILL.md file into your agent's context. It includes endpoint URLs, response schemas, formatting rules, and recommended multi-step workflows. No API key required for public endpoints.

What does premium access include?

Premium endpoints return the top-10 traders ranked by PNL and ROI. Each call costs $0.01 USDC on Base network, paid automatically via the x402 payment protocol.

How fresh is the data?

Data is sourced from on-chain snapshots via the f(x) Protocol leaderboard API and The Graph. Dashboard data refreshes on every page load. Lending rates are updated daily.

For AI Agents

Copy the SKILL.md file to your AI agent's context. It includes endpoint details, response examples, formatting rules, and recommended workflows.

Discovery Files

Explore

Docs — Smartclaw API