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 use Smartclaw?

Copy the SKILL.md file to your AI agent's context. It includes endpoint details, response examples, formatting rules, and recommended workflows. Agents can then call REST API endpoints to get smart wallet data.

How much does Smartclaw cost?

All listed endpoints are free and require no authentication.

What data does Smartclaw track?

Smartclaw tracks wallet PNL (profit and loss), ROI (return on investment), trading volume, win rates, and capital flow momentum across DeFi protocol leaderboards. It also compares lending rates across Aave, CrvUSD, and fxUSD.

Public DeFi API

Smartclaw API Docs

Everything agents and developers need to query smart wallet PNL, ROI, volume, lending rates, and capital-flow signals across protocol leaderboards.

Last checked: June 19, 2026

OpenAPI Spec Agent Skill Dashboard

Start here

$ curl https://smartclaw.xyz/api/fx/status

returns tracked wallets, win rate, volume, and momentum.

Tracked wallets

1,700+

Across f(x) Protocol leaderboard

Protocols live

f(x) Protocol now, Perp DEX and Meme Coins soon

Access

Free

Public endpoints, no auth required

Data source

On-chain

Protocol APIs, subgraphs, and live snapshots

API Endpoints

All endpoints are public GET requests and safe for agents to call automatically.

x-openai-isConsequential: false

GET/api/fx/statusAuth: None

getFxStatus

Protocol health snapshot with tracked wallets, winners, win rates, volume, PNL, and momentum.

Example

$ curl https://smartclaw.xyz/api/fx/status

GET/api/top-pnlAuth: None

getTopPnl

Global top PNL wallets across all integrated protocols, currently including f(x) Protocol.

Example

$ curl 'https://smartclaw.xyz/api/top-pnl?limit=10'

GET/api/fx/top-pnlAuth: None

getFxTopPnl

Top PNL wallets from the f(x) Protocol leaderboard only, sorted by cleaned PNL.

Example

$ curl 'https://smartclaw.xyz/api/fx/top-pnl?limit=10'

GET/api/fx/fxusd-rateAuth: None

getFxFxusdRate

Latest and historical fxUSD borrow APR, with optional limit and moving-average window.

Example

$ curl 'https://smartclaw.xyz/api/fx/fxusd-rate?limit=30'

GET/api/ratesAuth: None

getRates

Cross-protocol lending rate comparison across Aave, CrvUSD, and fxUSD.

Example

$ curl 'https://smartclaw.xyz/api/rates?maWindow=30'

GET/api/premiumAuth: None

getPremiumMetrics

Public leaderboard metrics with top traders by PNL and ROI. No payment required.

Example

$ curl https://smartclaw.xyz/api/premium

Agent Workflows

Recommended call sequences for common user prompts.

Protocol overview

GET /api/fx/status
Summarize win rate, volume, and momentum

Find top wallets

GET /api/fx/top-pnl?limit=5
Format wallet, PNL, ROI, volume as a ranked table

Rate comparison

GET /api/rates?maWindow=30
Compare fxUSD vs Aave vs CrvUSD borrow APR

Data Sources & Methodology

How Smartclaw prepares the metrics shown in the API.

Smart wallet data

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

Lending rates

fxUSD, Aave, and CrvUSD borrow rates are collected daily from protocol sources and subgraphs. Rates are APR values for comparison.

Update frequency

Dashboard and leaderboard data refresh dynamically. Lending rates update daily, with offline fallback data used when primary sources are stale or unavailable.

Metrics methodology

Win rate is the share of wallets with positive PNL. Weighted win rate is the share of volume from winning wallets. Momentum is the net capital flow share of winning wallets.

Discovery Files

Machine-readable entry points for agents, crawlers, and plugin clients.

/.well-known/ai-plugin.json

ChatGPT-style manifest

FAQ

Short answers for users and agents parsing this page.

What is Smartclaw?

Smartclaw is a cross-protocol smart wallet tracking API for DeFi traders and AI agents. It aggregates PNL, ROI, volume, and capital-flow signals from protocol leaderboards.

How do AI agents integrate?

Start with /SKILL.md for endpoint usage, response formatting, and recommended workflows. Use /api/openapi for complete schemas and operationIds.

Does /api/premium require payment?

No. The leaderboard metrics endpoint is public and requires no authentication or payment.

What should agents call first?

Use GET /api/fx/status first for a compact health snapshot, then call top-pnl or rates endpoints depending on the user request.

Dashboard fxUSD Rates Leaderboard API