{"uid":"cap_Io19sF20h3oRWvsMXg6P4","slug":"chainward-hires-risk-check-api-10fc8ae2","name":"ChainWard Hires Risk Check API","description":"Paste any Base or BNB Chain address before you pay or hire it. ChainWard tells you Pay or Hold, and why, from the wallet’s on-chain history. Free.","url":"https://api.chainward.ai/api/risk/hires?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"],"type":"string"},"queryParams":{"type":"object","required":["agent"],"properties":{"agent":{"type":"string","pattern":"^(\\d{1,12}|0x[a-fA-F0-9]{40})$","description":"ERC-8004 agent id on BNB Chain, or the 0x address that owns the agent(s)"},"chain":{"enum":["bsc"],"type":"string","default":"bsc","description":"BNB Chain only for now. Payment is USDC on Base."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"as_of":{"time":"2026-10-06T01:09:22.000Z","block":125969567},"chain":"bsc","hires":{"total":3,"by_source":{"termix_escrow":3,"erc8183_shared":0},"distinct_hirers":2},"owner":"0x15d08640aeefbdce11930d9c9a30884011f654f6","hirers":[{"path":["0x4e276b4db12447254134b45e5add170993df5ad2","0x1d21aa41a77737e593b8ca92d6bf6437fa81697f","0x8894e0a0c962cb723c1976a4421c95949be2d4e3"],"hires":1,"address":"0x4e276b4db12447254134b45e5add170993df5ad2","verdict":"inconclusive","evidence":"The hirer's first-incoming-BNB trail stops at 0x8894e0a0c962cb723c1976a4421c95949be2d4e3, a hub (exchange-style wallet, router or custodian), after 2 hops; funding behind it is not visible.","first_hire_at":"2026-10-01T07:42:05.000Z"},{"path":["0x99f88c4cae19f858052236f808b75967eece5bd0","0x0fe05614b2d344fb0ef9797431890d4c13c0f0f1","0x15d08640aeefbdce11930d9c9a30884011f654f6"],"hires":2,"address":"0x99f88c4cae19f858052236f808b75967eece5bd0","verdict":"shared_funder","evidence":"The hirer's and the owner wallet's funding trails meet at 0x0fe05614b2d344fb0ef9797431890d4c13c0f0f1, which is not a hub or a contract (hirer: 1 hop up its first-incoming-stablecoin trail; owner wallet: 1 hop up its first-incoming-stablecoin trail).","first_hire_at":"2026-10-03T07:19:06.000Z"}],"limits":["independent_within_limits means no link was found within these limits; it is not proven independence.","Only each wallet's first incoming BNB and first incoming stablecoin are followed, up to 4 hops. Later funding, and transfers between hirer and owner after that, are not checked.","BNB moved by contract-internal calls is not visible to the trail (top-level transfers only).","Trails stop at hubs and contracts and count as no link found: who funded a wallet through an exchange is not visible, so an owner who withdrew from their own exchange account to a hirer is not detected.","Pairwise only: wallets that hire each other inside a closed group can each look unlinked pair by pair (chainward.ai/decodes/set-and-earn-week-one).","Counts hire events (OrderCreated, JobCreated), not completed hires, and does not check which marketplace a hire came from. Hires on other contracts or on BSC testnet are not counted.","Owner and agent wallet are read at the as_of block. For an owner address, its agents are the registry tokens transferred to it in the last 60 days that it still owns.","At most 20 hirers are traced per check, in order of first hire.","Describes where money moved, not who controls a wallet or why. Not a verdict on the agent or its builder."],"method":"Hires are TermiX escrow OrderCreated events naming the agent as provider and shared ERC-8183 JobCreated events naming the owner or agent wallet as provider, on BNB Chain, in a 30-day hire window that starts no earlier than Set and Earn's first block. For each distinct hirer the check follows its first incoming BNB and first incoming stablecoin (USDT, USDC) back to their senders, up to 4 hops, and does the same for the owner and the agent wallet. owner: the hirer is the owner or the agent wallet. owner_funded: the owner or agent wallet is in the hirer's trail. direct_transfer: the hirer and the owner or agent wallet sent each other BNB or a stablecoin at any time, in either direction. shared_funder: the hirer's trail and the owner's (or agent wallet's) trail meet at a wallet that is not a hub or a contract, or the hirer is in the owner's trail. Trails stop at hubs (1,000+ incoming stablecoin transfers of at least $0.01 in 30 days, or 100,000+ sent transactions) and at contracts. inconclusive: the hirer's and the owner's (or agent wallet's) same-kind trails end at the same hub with first funding under 24 hours apart, or no incoming BNB or stablecoin is visible. independent_within_limits: none of these, including trails that end at a hub or a contract (the decode's \"no link found\").","summary":{"inconclusive":1,"owner_linked":1,"passes_three_independent":false,"independent_within_limits":0},"agent_id":332962,"agent_ids":[332962],"window_days":30,"agent_wallet":"0x15d08640aeefbdce11930d9c9a30884011f654f6"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8kMSjjt5qC_pGluFXfPuR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a hirer-relationship risk analysis for a BNB Chain agent or address, tracing funding trails to detect shared funders or suspicious links between hirers and the agent owner","exampleAgentPrompt":"Can you run a ChainWard hires check on BNB Chain agent 0x15d08640aeefbdce11930d9c9a30884011f654f6 and tell me whether any of its hirers share a common funder with the agent owner?","exampleUseCases":[{"title":"Detect self-hiring wash activity","prompt":"Check this BNB Chain agent address 0x99f88c4cae19f858052236f808b75967eece5bd0 — I want to know if the wallets that have hired it are actually linked back to the same owner, so I can tell whether its hire count is organic or manufactured."},{"title":"Audit agent reputation before paying","prompt":"Before I pay this agent on the marketplace, can you pull a ChainWard hires analysis for BNB Chain agent ID 4821903 to see if there are any shared funders or suspicious trails among the wallets that hired it?"},{"title":"Flag colluding hirers in a fleet","prompt":"I run an agent fleet and I suspect some of my competitors are using related wallets to farm reputation. Can you run ChainWard hires checks on BNB Chain address 0x4e276b4db12447254134b45e5add170993df5ad2 and show me the full hirer paths and verdicts?"}],"resultDescription":"Returns a JSON object with: the agent owner address, the chain and block timestamp of the check, aggregate hire counts broken down by source contract (e.g. termix_escrow, erc8183_shared), and a per-hirer list each containing the funding trail path (sequence of wallet addresses), number of hires, a verdict (e.g. 'inconclusive', 'shared_funder', 'independent_within_limits'), and a human-readable evidence string explaining what was or wasn't found. Also includes disclaimer notes about the limits of the trail analysis.","failureModes":["Missing or malformed 'agent' query parameter returns a validation error and no charge is made","Agent ID or address not found on BNB Chain returns empty or null hirer data","Chain parameter set to unsupported value returns an enum validation error","Payment failure over x402 results in 402 response and no data returned","Hirer trails that terminate at exchange hubs return 'inconclusive' verdict with explanation","Rate limiting or node unavailability may cause transient 5xx errors"],"whenToPreferThis":"Use this endpoint when you need to understand the funding relationships between the wallets that have hired a specific BNB Chain agent and that agent's owner — particularly to detect wash-hiring, collusion, or fake reputation inflation. Prefer this over a basic address risk check when you want hirer-level trail analysis rather than a simple risk score for a single address. It is especially valuable for agent marketplaces, reputation systems, and due-diligence workflows before committing payment to an agent with an unverified track record.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:33:47.879Z","isFirstParty":false,"canonicalSlug":"chainward-hires-risk-check-api-10fc8ae2"}