{"uid":"cap_94L1Xj_hgeph-EIC30WIb","slug":"blockrun-polymarket-wallet-pnl-lookup-1a79e455","name":"BlockRun Polymarket Wallet PnL Lookup","description":"Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.","url":"https://blockrun.ai/api/v1/pm/polymarket/wallet/pnl/0x0000000000000000000000000000000000000000","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0085","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.0085/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C-5XKLb6yroSVxYFA4jZT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the profit and loss (PnL) history for a specific Polymarket wallet address via the BlockRun payment-gated API","exampleAgentPrompt":"Can you pull the Polymarket profit and loss history for wallet address 0xAbC123... and tell me how that trader has been performing?","exampleUseCases":[{"title":"Polymarket trader performance review","prompt":"Look up the PnL history on Polymarket for wallet 0x1234567890abcdef1234567890abcdef12345678 — I want to know if this trader has been consistently profitable."},{"title":"Due diligence on a prediction market trader","prompt":"Before I follow this trader's positions, can you check their Polymarket PnL record for wallet address 0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef?"},{"title":"Monitor own Polymarket account performance","prompt":"What's my overall profit and loss on Polymarket? My wallet address is 0xaabbccddeeff00112233445566778899aabbccdd."}],"resultDescription":"Returns profit and loss data for the specified Polymarket wallet address, including realized trading gains and losses from prediction market positions.","failureModes":["Invalid or malformed wallet address returns an error","Zero-address (0x000...000) returns empty or placeholder data","Wallet has no Polymarket trading history — empty PnL result","Payment not settled or insufficient USDC balance — 402 Payment Required","Rate limiting or API downtime returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need on-chain Polymarket PnL data for a specific Ethereum wallet address, particularly in an agent workflow where x402 micropayment settlement in USDC is acceptable. Prefer this over manual on-chain queries when you need a convenient, pre-aggregated PnL summary without writing custom subgraph queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:57:15.914Z","isFirstParty":false}