BlockchainLive

Predict Leaderboard API

Polymarket smart-wallet leaderboard: top traders ranked by realized volume or profit (P&L).

$0.0138USDC per call · settled on Base · no subscription, no API key

Overview

Polymarket smart-wallet leaderboard: top traders ranked by realized volume or profit (P&L). Choose the time window (1d/7d/30d/all) and rankBy (vol/pnl); cap with limit. Each entry returns rank, wallet (proxy) address, trader name, X handle, verified badge, total USD volume, and USD P&L — for tracking smart money. Pair the wallet with predict.positions / predict.activity / predict.wallet. Read-only from Polymarket's Data API.

Endpoint

MethodEndpointPriceDescription
GET/v1/marketplace/api/predict-leaderboard$0.0138Invoke Predict Leaderboard (Blockchain) and return the upstream response.

How to call it

Requests are paid per call over the x402 protocol. Call the endpoint, receive a 402 Payment Required quote, then repeat the request with the signed payment header. The SDKs do both steps for you.

# 1. Ask for a quote
curl -i https://jarvisclaw.ai/v1/marketplace/api/predict-leaderboard

# 2. Pay it (the SDK signs and retries for you)
curl -H "X-PAYMENT: <signed-payload>" https://jarvisclaw.ai/v1/marketplace/api/predict-leaderboard

Parameters

Taken from the request example this API publishes.

NameInTypeExample
limitquerynumber1
rankByquerystring"vol"
windowquerystring"1d"

Example response

{
  "data": {
    "ok": true,
    "items": [
      {
        "rank": 1,
        "wallet": "example",
        "name": "example",
        "xUsername": "example",
        "verified": false,
        "volumeUsd": 1,
        "pnlUsd": 1
      }
    ],
    "total": 1,
    "source": {
      "provider": "example",
      "url": "example",
      "license": "example"
    },
    "meta": {
      "window": "example",
      "rankBy": "example"
    }
  },
  "meta": {
    "endpoint": "predict.leaderboard",
    "version": null,
    "caller": "x402",
    "cost": {
      "usd": 0.012
    },
    "settlement": {
      "txHash": "[redacted]",
      "network": "eip155:8453",
      "success": true
    }
  }
}

FAQ

How much does the Predict Leaderboard API cost?

$0.0138 USDC per call, paid per call over x402. There is no subscription, minimum or monthly fee.

Do I need an API key?

No. Call the endpoint, read the 402 Payment Required quote, and repeat the request with a signed USDC payment header. An account API key also works if you prefer prepaid billing.

Which chains can I pay on?

USDC on Base or on Solana. The 402 quote lists the accepted networks and the exact amount; the JarvisClaw SDKs sign and retry for you.

How do I call it from an AI agent?

Send GET to the endpoint above from any HTTP client, or connect the JarvisClaw MCP server and let the agent find and call it with the search_apis and get_api_detail tools.

Related APIs

Open in the marketplace

Docs: Getting started · x402 payments · x402 discovery · All APIs