{"uid":"cap_XeYMVoTnYmVj0tfpnwr9G","slug":"predge-whale-wallet-profile-api-254110b8","name":"Predge Whale Wallet Profile API","description":"Polymarket whale trades and smart-money signals from the Predge tracking pipeline, sold per-call over the x402 payment protocol. No API keys, no accounts.","url":"https://x402-api-production-266e.up.railway.app/v1/wallets/%7Baddress%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"note":"modeled_pnl_* is a MODELED signed-volume proxy from the Predge scorer (+size on wins, −size on losses over resolved markets), NOT realized/settled P&L.","found":true,"score":81,"totals":{"first_seen_at":"2026-05-02T10:11:00.000Z","trades_all_time":214,"avg_position_usd":12800,"modeled_pnl_30d_usd":48100.5,"modeled_pnl_all_time_usd":302400},"address":"0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8","win_rate":{"7d":0.67,"30d":0.71,"scorer_30d":0.7,"scorer_90d":0.64},"recent_trades":[{"side":"yes","price":0.62,"wallet":"0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8","tx_hash":"0x6a7de5…","category":"economics","platform":"polymarket","size_usd":25400,"market_slug":"fed-rate-cut-september","condition_id":"0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39","market_title":"Will the Fed cut rates in September?","wallet_score":81,"block_timestamp":"2026-07-17T09:41:02.000Z","wallet_win_rate_30d":0.67}],"outcome_verified":{"pnl":false,"win_rate":true},"score_updated_at":"2026-07-18T00:00:04.000Z","favorite_categories":[{"trades":88,"category":"economics","volume_usd":1204000}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yNi3d_g9KtVq3-ofWNjXC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a comprehensive smart-money profile for a single Polymarket proxy-wallet address, including whale score, win rates, modeled PnL, trade history, and favorite categories.","exampleAgentPrompt":"Look up the Predge whale profile for Polymarket wallet 0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8 — I want to see their whale score, 30-day win rate, modeled PnL, and which market categories they trade most.","exampleUseCases":[{"title":"Vetting a wallet before copy-trading","prompt":"Before I mirror this trader's positions, pull the Predge profile for Polymarket wallet 0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8 — I need their whale score, win rates over 7d and 30d, and their modeled PnL to decide if they're worth following."},{"title":"Research smart money ahead of a market position","prompt":"I'm about to take a position on the Fed rate cut market — can you check the Predge profile on wallet 0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b to see if this is a high-scoring whale with a strong recent win rate in economics markets?"},{"title":"Auditing a whale alert for credibility","prompt":"Someone just flagged wallet 0x3fab9cd7e4d1cd6cca897b9e12a8cbe6d44321 as a Polymarket whale — can you pull their Predge score, lifetime trade count, average position size, and all-time modeled PnL so I can judge whether the alert is credible?"}],"resultDescription":"A JSON object containing the wallet address, a Predge whale score (0–100), win rates broken down by 7d/30d and scorer 30d/90d, modeled PnL for 30d and all-time (signed-volume proxy, not realized P&L), total trades all time, average position size in USD, first-seen timestamp, recent individual trades with market slugs and sizes, favorite market categories with volume, and outcome verification flags indicating which metrics are independently verified.","failureModes":["Wallet address not found or never traded on Polymarket — returns found:false with no score or trade data","Malformed or non-0x wallet address in path — likely 400 or 422 error","Payment not processed via x402 protocol — 402 Payment Required response","Wallet has insufficient trade history for a reliable score — score may be low or absent","Data reflects up to 15-minute delay for recent trades; very recent activity may not appear"],"whenToPreferThis":"Use this endpoint when you need a complete smart-money dossier on a specific Polymarket wallet — combining score, win rate, PnL proxy, trade history, and category focus in a single call. Prefer it over the leaderboard endpoint when you have a specific address to investigate rather than wanting ranked lists, and over the market-whale endpoint when your primary axis is the wallet identity rather than a specific market. The x402 micropayment model means no API key setup is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:41:22.483Z","isFirstParty":false}