{"uid":"cap__xdsC6ZgaortNMREjMv5r","slug":"hermes-agent-data-services-wallet-profile-ab126b8c","name":"Hermes Agent Data Services – Wallet Profile","description":"Pay-per-call on-chain data for agents. USDC on Base over x402 (HTTP 402).","url":"https://x402-agent.majighufron.workers.dev/api/wallet-profile?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["token","address"],"properties":{"chain":{"enum":["base","base-sepolia","robinhood"],"type":"string","description":"Chain to read."},"token":{"type":"string","description":"Token the activity is counted on."},"blocks":{"type":"integer","maximum":5000,"minimum":1,"description":"How many recent blocks to scan."},"address":{"type":"string","description":"Address being profiled."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"chain":"base","address":"0x53bc9a5fe59223a209d32948075e6ad82ce747ce","volumeIn":"1,200.00","volumeOut":"400.00","transfersIn":12,"transfersOut":4,"lastSeenBlock":51756000,"firstSeenBlock":51234567,"distinctCounterparties":9}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F2Hx7FrI7uTD3tgL5Zitv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an on-chain token activity profile for a given wallet address, including volume in/out, transfer counts, and counterparty statistics.","exampleAgentPrompt":"Pull the on-chain wallet profile for address 0x53bc9a5fe59223a209d32948075e6ad82ce747ce on Base, scanning the last 1000 blocks for USDC activity — I want to see volume in/out, transfer counts, and how many distinct counterparties they've dealt with.","exampleUseCases":[{"title":"DeFi due diligence on counterparty wallet","prompt":"Before I approve this payment, pull the on-chain profile for 0xAbCd1234... on Base for the last 2000 blocks using USDC — I want to know how much volume they've moved in and out and how many unique wallets they've interacted with."},{"title":"Agent risk-scoring dormant wallet","prompt":"Check whether 0x7f3a9b...ee12 has been active on Base in the last 500 blocks for any USDC transfers — I need to know if it's a live wallet or basically dormant before routing funds there."},{"title":"Monitoring whale wallet inflows","prompt":"Give me a full activity breakdown for wallet 0x9A8b...3Fc2 on Base over the last 5000 blocks tracking USDC — I want total volume in, total volume out, and how many different counterparties sent funds to it."}],"resultDescription":"A JSON object containing: ok status, chain name, queried address, formatted volume in and out (string), transfer counts in and out (integers), first and last seen block numbers, and a count of distinct counterparties the wallet has interacted with — all scoped to the requested token and block range.","failureModes":["Missing required query parameters (address or token) returns a validation error","Invalid or unsupported chain value returns an error (must be base, base-sepolia, or robinhood)","Block range exceeding 5000 returns a 400 error","Payment not included or insufficient USDC triggers HTTP 402 Payment Required","Address with no activity in the requested block range returns zero-value fields","Unresolvable or malformed wallet address returns an error"],"whenToPreferThis":"Choose this endpoint when you need a fast, structured summary of a specific wallet's token activity on Base or related chains — volume, transfer counts, and counterparty diversity — without running a full blockchain node query or indexer. It is ideal for agent pipelines that need per-wallet risk signals, due diligence, or activity checks and can pay $0.03 USDC per call via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:39:53.716Z","isFirstParty":false,"canonicalSlug":"hermes-agent-data-services-wallet-profile-ab126b8c"}