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
Access
Free
Public analytics endpoint
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/premiumLeaderboard metrics (top-10 by PNL & ROI)None

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. Leaderboard 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 the premium API include?

The /api/premium endpoint returns public leaderboard metrics ranked by PNL and ROI. No payment or authentication is required.

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