{"openapi":"3.1.0","info":{"title":"Undertow by Bucks","version":"1.0.0","description":"Pay-per-call token checks for agents, by Bucks (ERC-8004 #8811 on Robinhood Chain). Undertow answers: where a token's trading fee actually goes (each share and its final destination), who can still change that, how much of the token's trading pays it, and the blocks every read is pinned to. Plus a holder check for Robinhood Chain tokens.","x-guidance":"Paid paths answer 402 with x402 v2 terms: USDG on Robinhood Chain (eip155:4663), exact scheme, Priors facilitator. Pay with an EIP-3009 payment in the PAYMENT-SIGNATURE header. The payment is verified first and settled only if the answer succeeds; a failed lookup (bad input, scan error, timeout) is never charged. Free previews: GET /undertow (docs), /undertow/sample, /undertow/schema, /check, /check/sample."},"servers":[{"url":"https://bucks-check.vercel.app"}],"paths":{"/undertow":{"get":{"operationId":"undertowLookup","summary":"Undertow receipt for one token: economics read (funding, execution, beneficiaries, controls), fee split, onward destinations, fee capture (1 USDG)","parameters":[{"name":"token","in":"query","required":true,"description":"token contract address (0x + 40 hex)","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"name":"chain","in":"query","required":false,"description":"rh (Robinhood Chain) or eth (Ethereum); detected when left out","schema":{"type":"string","enum":["rh","eth"]}},{"name":"format","in":"query","required":false,"description":"summary: compact undertow-summary/1 of at most 3,800 characters, all four economics sections first, same price","schema":{"type":"string","enum":["summary"]}},{"name":"max_age","in":"query","required":false,"description":"seconds; allows a cached receipt this fresh instead of a live scan","schema":{"type":"integer","minimum":0}}],"x-price":{"amount":"1","asset":"USDG","network":"eip155:4663"},"responses":{"200":{"description":"undertow-receipt/1 JSON with interpretation.economics: funding, execution, beneficiaries and controls, each with coverage status (known, partial, unread, not-applicable) and a summary; or undertow-summary/1. Older cached receipts do not invent economics."},"400":{"description":"bad input, not charged"},"402":{"description":"payment required; terms in the PAYMENT-REQUIRED header"},"422":{"description":"nothing to trace, not charged"},"502":{"description":"scan failed, not charged"},"504":{"description":"scan over time budget, not charged"}}}},"/check/holders":{"get":{"operationId":"holderCheck","summary":"Holder structure, launch-minute buyers and PullWash use for a Robinhood Chain token (0.10 USDG)","parameters":[{"name":"token","in":"query","required":true,"description":"token contract address (0x + 40 hex)","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}],"x-price":{"amount":"0.10","asset":"USDG","network":"eip155:4663"},"responses":{"200":{"description":"holder-check JSON"},"402":{"description":"payment required"}}}}}}