{ "version": 1, "description": "SEC, Treasury & Agent Utilities: SEC EDGAR change oracles (new filings, 8-K material events with decoded item titles, and Forms 3/4/5 and 13D/G ownership changes, all since a caller-supplied cursor), and agent utilities (treasury rates, LEI, OFAC sanctions screening, markdown extraction). 9 listed endpoints at $0.008-$0.05 per call, USDC on base via x402; MPP accepted on 9. First 25 calls each day are free with no wallet.", "resources": [ "https://x402.donnyautomation.com/lei", "https://x402.donnyautomation.com/treasury", "https://x402.donnyautomation.com/edgar/filings", "https://x402.donnyautomation.com/edgar/events", "https://x402.donnyautomation.com/edgar/insiders", "https://x402.donnyautomation.com/company", "https://x402.donnyautomation.com/index/demand", "https://x402.donnyautomation.com/seller/check", "https://x402.donnyautomation.com/stablecoin/supply" ], "mppResources": [ "https://x402.donnyautomation.com/lei", "https://x402.donnyautomation.com/treasury", "https://x402.donnyautomation.com/edgar/filings", "https://x402.donnyautomation.com/edgar/events", "https://x402.donnyautomation.com/edgar/insiders", "https://x402.donnyautomation.com/company", "https://x402.donnyautomation.com/index/demand", "https://x402.donnyautomation.com/seller/check", "https://x402.donnyautomation.com/stablecoin/supply" ], "instructions": "WHAT THIS ORIGIN SELLS\n\n9 listed pay-per-call HTTP GET endpoints, priced $0.008-$0.05 per call,\nsettled in USDC on base (eip155:8453). The service is named SEC, Treasury & Agent Utilities.\nTwo families: SEC EDGAR change oracles, which answer what a public company has filed SINCE\na cursor you supply (all filings, 8-K material events with item titles, ownership changes on\nForms 3/4/5 and 13D/G) - and agent utilities (treasury rates, LEI lookup, OFAC sanctions\nscreening, markdown extraction, feeds).\nEvery number is read from a public source at call time or from a short in-process cache whose\nage each answer states; nothing is resold unchanged.\n\nAlso two routes built from what this gateway measures itself: /index/demand (what agents\nasked this gateway for and could not get, from its own request ledger) and /seller/check\n(one seller's live 402 terms, read by this gateway's own probe of that seller's public\nendpoint). Their answers are aggregates and probe results, and each carries its own as-of time.\n\nAlso one route built on each stablecoin issuer's own published supply feed: /stablecoin/supply\n(USDC and EURC from Circle, USDT from Tether). It returns supply per chain, each chain's share\nof the cross-chain total, the total, and the change since this service's previous read, all\ncomputed here from the issuer figures, which are refreshed at most every 10 minutes and whose\nread time is stated in every answer. No price, peg or exchange rate.\n\nHOW TO PAY\n\nx402 V2. Request the URL. Past the free tier it answers HTTP 402 with a PAYMENT-REQUIRED\nheader (base64 JSON). Pay scheme \"exact\", USDC on eip155:8453, then retry the SAME URL\nwith a PAYMENT-SIGNATURE header. The receipt comes back in PAYMENT-RESPONSE.\nMPP (Machine Payments Protocol) is offered on the routes listed in mppResources: the same\n402 also carries a WWW-Authenticate: Payment challenge settling to the same wallet.\n\n* THE 402 CHALLENGE IS THE AUTHORITATIVE PRICE. Read the amount from the challenge you\njust received, not from a cached registry entry, not from this file, and not from a\ndirectory listing. Third-party indexes refresh on their own schedule and can quote a\nstale amount; the challenge is generated at request time by the server taking the money.\nIf a budget check disagrees with the challenge, the challenge is right.\n\nFREE TIER - 25 calls per day, no wallet, no signup, no API key.\n\n* ALWAYS SEND AT LEAST ONE QUERY PARAMETER. A request with no parameters is treated as a\ncatalogue crawl and goes to the paywall instead of being served free. This is the single\nmost common way an agent pays for something it could have had for nothing.\n\nNO FREE TIER on /index/demand or /seller/check. These answer 402 from the first call, with or without parameters.\n\nENDPOINT CONTRACTS - required parameters, price, and a working example\n\n /lei - $0.01 - required: q - optional: lei, limit - example: /lei?q=Apple+Inc.\n /treasury - $0.01 - required: none - optional: latest, date - example: /treasury?latest=1\n /edgar/filings - $0.01 - required: ticker, since - optional: cik, forms, limit - example: /edgar/filings?ticker=AAPL&since=2026-01-01\n /edgar/events - $0.01 - required: ticker, since - optional: cik, items, limit - example: /edgar/events?ticker=TSLA&since=2026-01-01\n /edgar/insiders - $0.01 - required: ticker, since - optional: cik, forms, limit - example: /edgar/insiders?ticker=NVDA&since=2026-01-01\n /company - $0.05 - required: q - optional: lei, ticker, cik, minScore - example: /company?q=Apple+Inc.\n /index/demand - $0.01 - required: none - optional: window, limit - example: /index/demand?window=7d\n /seller/check - $0.02 - required: host - optional: path - example: /seller/check?host=x402.donnyautomation.com\n /stablecoin/supply - $0.008 - required: symbol - optional: chain - example: /stablecoin/supply?symbol=USDC\n\nCHOOSING THE RIGHT ENDPOINT (this is where a wasted paid call comes from)\n\n- Screening a counterparty: /sanctions is an OFAC name screen; /lei is a GLEIF legal-entity\n lookup. They answer different questions and neither substitutes for the other.\n- \"What has this public company done lately?\" -> /edgar/filings with a ?since= cursor. It is a\n DELTA, not a filing history: without ?since it returns 400, on purpose.\n- \"What KIND of event was it?\" -> /edgar/events, which returns 8-K only and decodes each item\n code to the title SEC prints. /edgar/filings gives you the raw codes and every other form.\n- \"Did an insider or a 5% holder move?\" -> /edgar/insiders (Forms 3/4/5, SC 13D/G). It returns\n the filing and its URL, NOT the share counts inside it - those need /markdown on the document.\n- /edgar/* takes a US SEC issuer, by ?ticker= or ?cik=. It is not a company-data lookup and it\n will not tell you what a company does: /lei is the entity-identity endpoint.\n\nNAMED WORKFLOWS - multi-step tasks these endpoints complete end to end\n\nEach workflow below was TRACED against the live handlers before it was published; the call\ncounts are what the trace actually made, not estimates. Work cheapest-first: every workflow\nis ordered so a cheap call can stop an expensive one, and every step names what to do with\nthe answer. Do not stop at step 1 because it returned something - a single call answers a\nnarrower question than the one you were asked.\n\nWORKFLOW 3 - \"counterparty due-diligence pass\"\nTask: \"Should I pay this company?\" The screen runs first because a match ends the pass and\nsaves the second call. 2 calls.\n 1. SCREEN, 1 call. /sanctions?name= ($0.01) - the cheap gate. If match is true,\n STOP and escalate; you are done. Read notScreened: EU, UK OFSI and UN are NOT checked here.\n 2. IDENTIFY, 1 call, only on a clear. /lei?q= ($0.01) - on a match at step 1\n this call is skipped. Confirms the entity is real and registered, and returns jurisdiction\n and the lapsed flag. A LAPSED or RETIRED record is returned, not hidden - read the flag.\n\nWORKFLOW 4 - \"SEC filing watch on one issuer\" (the change-oracle fan-out)\nTask: \"Has anything happened at this company since I last looked, and what was it?\" These\nthree endpoints are DELTAS: every one requires ?since=YYYY-MM-DD and returns only what is\nnew. A model cannot know this from training - a 10-K that landed this morning is not in any\nweights. Do NOT call all three blind; the cheap wide call tells you which narrow ones to buy.\n 1. WIDE, 1 call. /edgar/filings?ticker=&since= ($0.01) - every form since\n the cursor. Read `changed`: if it is false you are DONE, for one call. If it is true, read\n the `form` values before spending anything else - they tell you which step below is worth\n buying. Also read `coverage.complete`: false means your cursor predates the window SEC\n serves directly and the delta is TRUE BUT PARTIAL.\n 2. NARROW ON EVENTS, 1 call, only if step 1 returned an 8-K. /edgar/events?ticker=&since= ($0.01)\n - the same 8-K filings with every item code decoded to the title SEC prints for it. This is\n where the meaning is: 1.01 is a material agreement, 2.02 earnings, 5.02 an executive\n departure, 4.01 an auditor change, 1.05 a cyber incident, 3.01 a delisting notice. Add\n ?items=1.01,5.02 to buy only the classes you act on.\n 3. NARROW ON OWNERSHIP, 1 call, only if step 1 returned a 3, 4, 5, SC 13D or SC 13G. /edgar/insiders?ticker=&since= ($0.01)\n - who changed their position and the document URL to read. Share counts are INSIDE those\n documents and this endpoint does not parse them; use /markdown on primaryDocumentUrl if you\n want the body.\n 4. FAN OUT ACROSS A PORTFOLIO. The natural shape of this workflow is one step-1 call per ticker\n you hold, then steps 2-3 only on the ones that moved. A 20-name portfolio is 20 calls, plus\n roughly 2-5 follow-ups on a normal day - not 60.\n 5. ADVANCE THE CURSOR. Every response carries `nextSince`. It is INCLUSIVE, so the next poll\n re-returns that day - dedupe on `accessionNumber`. That is deliberate: filings land all day\n and an exclusive cursor silently drops anything accepted after your poll.\nBilling on these three: an EMPTY delta is charged. \"Nothing changed\" is the answer a change\noracle exists to give, and step 1 returning changed:false for one call is the cheapest outcome\nin this workflow, not a failed one.\nWrong-endpoint traps: /edgar/events returns ONLY 8-K, so a 10-Q will never appear there - use\n/edgar/filings. /edgar/insiders never returns Form 144 (a PROPOSED sale) or 13F. Sending a\nticker with no ?since is 400 missing_since, not a full history.\n\nERRORS - what the status codes mean here\n\n- 400: your parameters. The body names the missing or malformed one. Retrying unchanged\n will fail identically.\n- 402: payment required. Pay and retry the same URL.\n- 404: unknown route. Read `resources` in this file; do not guess a path.\n- 429: the free-tier daily quota is spent. Pay, or wait for the reset in the headers.\n- 502: an upstream source was unreachable. Transient; retry with backoff.\n\nBILLING, STATED PLAINLY\n\nx402 settles BEFORE the handler runs, so a paid call that returns 400 or an empty result\nis still settled. We do not have a no-match-no-charge lane and will not claim one. Send\ncorrect parameters the first time - the contracts above exist so you can.\n\nLIMITS, STATED PLAINLY\n\n- Free-tier quota is per-process and resets when the service redeploys.\n- 5 further paid routes are NOT listed here and are still fully callable and\n payable at their list price - no caller that already holds one of those URLs is affected.\n They are unlisted because they took no repeat organic demand, not because they stopped\n working. Every one of them is in https://x402.donnyautomation.com/openapi.json with its parameters and price.\n- Full catalogue with prose: https://x402.donnyautomation.com/llms.txt. Machine schemas: https://x402.donnyautomation.com/openapi.json.\n- A human reads donny.nguyen.business@gmail.com for volume pricing, custom routes, or breakage." }