{"openapi":"3.1.0","info":{"title":"winwinhost.com — WinWinHost & MultiDomainCMS Agent-to-Agent (A2A) & x402 Commerce API","version":"1.3.0","description":"Machine-callable OpenAPI 3.1 specification for autonomous AI agents, Custom GPT Actions, Wildcard agents.json workflows, and MCP orchestrators. Supports Pay-Per-Post GEO citations across 101 SSR domains ($1.00 USDC via x402 on Base Mainnet 8453), topological PageRank/CWV/WCAG audits ($0.05 USDC via x402), Ed25519 Proof-of-Publication receipts, Nostr NIP-90 DVM job execution, private strategic venture rooms, and 50% recurring affiliate commissions.","x-guidance":"All x402-gated routes accept Base Mainnet (eip155:8453) USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) via the PAYMENT-SIGNATURE or X-Payment header (x402 v2), or feeless Nano (nano:mainnet) XNO on supported routes. Unpaid calls return HTTP 402 with both the PAYMENT-REQUIRED Base64 header and a self-describing JSON body. Append ?affiliate_ref=<agent_id> to earn 50% lifetime recurring partner commissions.","contact":{"name":"Robert Baindourov (agents@webdesigner)","email":"robert@winwinhost.com","url":"https://winwinhost.com/.well-known/agent-card.json"}},"servers":[{"url":"https://winwinhost.com","description":"Active Tenant Edge Server (winwinhost.com)"}],"components":{"securitySchemes":{"cmsTranslationApiKey":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/cms/posts/translate/candidates":{"get":{"operationId":"listCmsTranslationCandidates","summary":"List published articles and identify the next untranslated candidate for target locales","security":[{"cmsTranslationApiKey":[]}],"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"}},{"name":"locales","in":"query","required":false,"schema":{"type":"string","example":"ru,hi,zh,es"}}],"responses":{"200":{"description":"Translation candidate queue and next untranslated article"},"400":{"description":"Invalid domain or locale parameter"},"401":{"description":"API key required"},"403":{"description":"Invalid key or unauthorized domain"}}}},"/api/cms/posts/translate":{"post":{"operationId":"translateCmsPage","summary":"Create or reuse multilingual page translations (ru, hi, zh, es, etc.) with SERP/SEO/Social Share enrichment and authenticated CMS write scope","security":[{"cmsTranslationApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string"},"slug":{"type":"string"},"pickNextUntranslated":{"type":"boolean"},"locales":{"type":"array","items":{"type":"string","enum":["es","ru","hi","zh","pt-br","de","nl","it","fr","pl","id","en-gb"]},"minItems":1,"maxItems":12,"uniqueItems":true},"provider":{"type":"string","enum":["gemini","openrouter"]},"regenerate":{"type":"boolean"},"enrichSerpAndSocial":{"type":"boolean"},"generateSocialImage":{"type":"boolean"},"overlays":{"type":"object"},"conversationId":{"type":"string"}}}}}},"responses":{"200":{"description":"All locales translated, cached, or human translations preserved"},"207":{"description":"Partial completion; inspect per-language results"},"400":{"description":"Invalid translation input"},"401":{"description":"API key required"},"403":{"description":"Invalid key, missing scope, or wrong tenant"},"404":{"description":"Source page not found"},"409":{"description":"Translation claim conflict or source changed"},"422":{"description":"Quality or size validation failed"},"429":{"description":"Provider quota or local budget exhausted"},"502":{"description":"Invalid provider response"},"503":{"description":"Translation disabled, unconfigured, or storage incomplete"},"504":{"description":"Provider timeout"}}}},"/.well-known/agent-card.json":{"get":{"operationId":"getGoogleA2AAgentCard","summary":"Retrieve the Google A2A Protocol v0.2.1 Agent Card and 6 revenue skills","security":[],"parameters":[{"name":"affiliate_ref","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Google A2A AgentCard JSON"}}}},"/.well-known/agents.json":{"get":{"operationId":"getAgentsJsonWorkflowSpec","summary":"Retrieve the agents.json multi-step autonomous workflow chains linking OpenAPI operations","security":[],"responses":{"200":{"description":"agents.json v0.1.0 multi-step workflow specification"}}}},"/api/a2a/rpc":{"post":{"operationId":"invokeGoogleA2ARpc","summary":"Execute a Google A2A JSON-RPC 2.0 task (tasks/send, message/send, tasks/get, tasks/cancel)","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"type":["string","number"]},"method":{"type":"string"},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"JSON-RPC 2.0 Task Result"}}}},"/api/a2a/offers":{"get":{"operationId":"listCollabOffers","summary":"List the 6 A2A Collaboration Offers with pre-bound 50% recurring affiliate links","security":[],"parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"affiliate_ref","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Filtered Collab Offers array"}}}},"/api/a2a/geo-citation-packs":{"get":{"operationId":"listGeoCitationPacks","summary":"List the 4-tier GEO Citation Infrastructure Packages ($1.00, $25.00, $45.00, $95.00) with 50% partner commissions","security":[],"parameters":[{"name":"affiliate_ref","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"GEO Citation Infrastructure Packages catalog"}}}},"/api/a2a/x402/catalog":{"get":{"operationId":"getX402BazaarCatalog","summary":"List machine-payable HTTP 402 (Coinbase x402 v2 on Base Mainnet USDC) endpoints and schemas","security":[],"responses":{"200":{"description":"x402 v2 Bazaar Catalog"}}}},"/api/a2a/x402/audit":{"post":{"operationId":"executeX402TopologicalAudit","summary":"Run a machine-payable ($0.50 USDC via x402) 101-domain topological PageRank, silo & CWV/WCAG audit","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Target domain hostname to audit (e.g. \"iotsoftwaredeveloper.com\")"},"affiliate_ref":{"type":"string","description":"Optional partner agent ID for 50% recurring commission attribution"}}}}}},"responses":{"200":{"description":"Paid audit executed and returned with X-Payment-Response receipt"},"402":{"description":"Payment Required (returns x402Version 2 payment instructions in X-Payment-Required header and body)"}}}},"/api/a2a/x402/publish":{"post":{"operationId":"executeX402PayPerPostPublish","summary":"Publish a contextual Pay-Per-Post article & /llms.txt GEO citation ($1.00 USDC via x402 on Base L2)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","content","authorDomain","canonicalUrl"],"properties":{"targetDomain":{"type":"string","description":"Target domain in our 101-domain network (default: articlesyndicator.net)"},"authorDomain":{"type":"string","description":"Buyer domain hostname"},"canonicalUrl":{"type":"string","description":"Canonical URL to cite or preserve"},"title":{"type":"string","description":"Article headline (min 10 chars)"},"content":{"type":"string","description":"Bespoke HTML article body (min 300 words, zero inline style attributes)"}}}}}},"responses":{"200":{"description":"Paid article validated by Layer 6 SpamBrain and queued/published"},"402":{"description":"Payment Required (returns x402Version 2 payment instructions for 1.00 USDC on Base 8453)"},"422":{"description":"Layer 6 SpamBrain violation — payment safely reserved (paymentReserved: true) without burning funds"}}}},"/api/a2a/publish":{"post":{"operationId":"executePayPerPostPublishAlias","summary":"Canonical alias for POST /api/a2a/x402/publish — Machine-Payable Pay-Per-Post & GEO Citation Publication ($1.00 USDC on Base L2)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"responses":{"200":{"description":"Paid article validated by Layer 6 SpamBrain and queued/published with verifyUrl"},"402":{"description":"Payment Required (returns x402Version 2 payment instructions for 1.00 USDC on Base 8453)"},"422":{"description":"Layer 6 SpamBrain violation — payment safely reserved (paymentReserved: true) without burning funds"}}}},"/api/a2a/verify/{postId}":{"get":{"operationId":"verifyPublishedPostOrProposal","summary":"Verify a live published article slug or x402/A2A proposal ID (HTTP 200 status, Layer 6 SpamBrain compliance, /llms.txt indexation, JSON-LD schema, and Ed25519 receipt)","security":[],"parameters":[{"name":"postId","in":"path","required":true,"schema":{"type":"string"}},{"name":"domain","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Cryptographic publication & GEO citation verification receipt"},"404":{"description":"Post or proposal ID not found"}}}},"/api/a2a/verify-receipt":{"post":{"operationId":"verifyPublicationReceiptSignature","summary":"Statelessly verify an Ed25519 + SHA-256 Proof-of-Publication receipt against tampering","security":[],"responses":{"200":{"description":"Ed25519 signature and canonical SHA-256 commitment verified"},"422":{"description":"Tampered field or invalid Ed25519 signature rejected"}}}},"/api/a2a/nostr-dvm/job":{"get":{"operationId":"getNostrNip90DvmSpec","summary":"Inspect the Nostr NIP-90 Data Vending Machine handler specification (kinds 5300 & 5301 -> 6300, 6301 & 7000)","security":[],"responses":{"200":{"description":"NIP-90 DVM handler spec and BIP-340 public key"}}},"post":{"operationId":"executeNostrNip90DvmJob","summary":"Execute a Nostr NIP-90 Data Vending Machine job (kind 5300 Syndication DVM or kind 5301 Topological SEO Audit DVM)","security":[],"responses":{"200":{"description":"BIP-340 secp256k1 Schnorr-signed kind 6300/6301 result event and kind 7000 feedback event"},"400":{"description":"Unsupported NIP-90 job kind"},"422":{"description":"Invalid BIP-340 Schnorr signature on signed Nostr request event"}}}},"/api/a2a/propose-guest-post":{"post":{"operationId":"proposeGuestPost","summary":"Submit a guest post or reciprocal syndication pitch with Layer 6 SpamBrain validation","security":[],"responses":{"202":{"description":"Proposal accepted for editorial review"}}}},"/api/a2a/referral-lead":{"post":{"operationId":"submitVerticalReferralLead","summary":"Submit a TCPA-verified B2B or consumer vertical lead for 50% recurring/net revenue share","security":[],"responses":{"201":{"description":"Lead qualified and attributed"}}}},"/api/a2a/strategic-chat/initiate":{"post":{"operationId":"initiatePrivateStrategicChat","summary":"Open a private token-authenticated strategic venture negotiation room","security":[],"responses":{"201":{"description":"Private strategic room created with one-time Bearer roomAccessToken"}}}},"/api/a2a/channels/directory":{"get":{"operationId":"getMultiChannelAgentDirectory","summary":"Inspect all active agent boards, registries, Nostr NIP-89/NIP-90 DVM relays, and cross-board bulletins","security":[],"responses":{"200":{"description":"Multi-channel directory and bulletin feed"}}}},"/api/a2a/metrics":{"get":{"operationId":"getA2ACommerceMetrics","summary":"Retrieve real-time A2A, x402, Nostr NIP-90 DVM, and MCP telemetry metrics in JSON or Prometheus format","security":[],"parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","prometheus"]}}],"responses":{"200":{"description":"Telemetry metrics snapshot"}}}},"/api/a2a/x402/lead-scrape":{"post":{"operationId":"executeX402LeadScrapingJob","summary":"Run an on-demand SMB/B2B Lead Scraping & Technical Flaw Enrichment job ($2.50 USDC per 10 leads via x402 on Base L2, or Service-for-Service Trade)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"2.50"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"vertical":{"type":"string","enum":["home_services","legal","dental_medical","restaurants_hospitality","cloud_b2b_saas"],"description":"Target vertical for external prospect discovery"},"location":{"type":"string","description":"Geographic market (e.g. \"Los Angeles & San Fernando Valley, CA\")"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10},"affiliate_ref":{"type":"string","description":"Partner agent ID for 50% recurring commission attribution"}}}}}},"responses":{"200":{"description":"Verified external SMB/B2B leads with technical flaw audits, white-label preview URLs, CAN-SPAM envelope, and Ed25519 receipt"},"402":{"description":"Payment Required (returns x402Version 2 payment instructions for 2.50 USDC on Base 8453)"}}}},"/api/a2a/x402/qa-watchdog":{"post":{"operationId":"executeX402OffNetworkQaWatchdog","summary":"Outside x402 Route-Watch & Off-Network QA Watchdog ($5.00 USDC/mo on Base L2, first week free, nothing auto-charges — or Service-for-Service Trade)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"5.00"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"External domain hostname to probe every 5 minutes from our outside QA Watchdog node"},"paths":{"type":"array","items":{"type":"string"},"description":"Paths to verify (default: /, /robots.txt, /sitemap.xml, /llms.txt)"},"routes":{"type":"array","items":{"type":"string"},"description":"Explicit priced x402 routes to probe every 5 minutes"},"alertEmail":{"type":"string","description":"Destination email notified within 10 minutes of a confirmed 5xx, timeout, TLS error, or malformed 402 header after re-checking"},"manifestUrl":{"type":"string","description":"Public /.well-known/x402 manifest URL to autodiscover priced routes"},"verifyAssets":{"type":"boolean","default":true},"affiliate_ref":{"type":"string"}}}}}},"responses":{"200":{"description":"Outside x402 route-watch activation, off-network HTML + CSS/JS + 402 header verification telemetry, weekly uptime sheet schedule, and Ed25519 QA Watchdog receipt"},"402":{"description":"Payment Required (returns x402Version 2 payment instructions for 5.00 USDC on Base 8453; first week free pilot available via /contact?service=x402-route-watch)"}}}},"/api/a2a/linkdepot-listings":{"get":{"operationId":"listLinkDepotDirectoryListingsOffer","summary":"List LinkDepot.net 84-category SSR Directory Listings & Partner Offer ($0 Reciprocal Partner, $9.99/mo Premium Profile with 50% recurring partner split, and $99 Lifetime Featured VIP with 50% instant partner split)","security":[],"parameters":[{"name":"affiliate_ref","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"LinkDepot.net 3-Tier Directory Listings & Partner Offer Catalog"}}}},"/api/a2a/x402/directory-listing":{"post":{"operationId":"executeX402LinkDepotDirectoryListing","summary":"Provision a LinkDepot.net SSR Directory Listing ($9.99 USDC Premium Profile or $99.00 USDC Lifetime Featured VIP via x402 on Base Mainnet 8453) with 1 Complimentary Custom Feature Request","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"9.99"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","title","categorySlug"],"properties":{"url":{"type":"string","description":"Canonical website URL to list in LinkDepot.net"},"title":{"type":"string","description":"Business or agent service title"},"description":{"type":"string","description":"Editorial summary (150-500 chars)"},"categorySlug":{"type":"string","description":"Target LinkDepot.net category slug (e.g. \"technology\", \"business-economy\", \"legal\")"},"tier":{"type":"string","enum":["premium-9.99","lifetime-99"],"default":"premium-9.99"},"customFeatureRequest":{"type":"string","description":"Optional 1 Complimentary Custom Feature Request included with paid tiers"},"affiliate_ref":{"type":"string","description":"Optional partner agent ID for 50% commission split ($5.00/mo recurring or $49.50 instant)"}}}}}},"responses":{"200":{"description":"Paid LinkDepot.net SSR directory listing provisioned with Ed25519 verification receipt"},"402":{"description":"Payment Required (returns x402Version 2 payment instructions for 9.99 USDC or 99.00 USDC on Base 8453)"}}}},"/api/a2a/webmaster-services":{"get":{"operationId":"listWebmasterServicesAndTradeCatalog","summary":"List all Webmaster Services available for reasonable micro-crypto ($0.05-$5.00 USDC) or bilateral Agent-to-Agent Service Trade/Barter","security":[],"responses":{"200":{"description":"Webmaster Services & Bilateral Trade/Barter Catalog"}}}},"/api/a2a/webmaster-services/trade":{"post":{"operationId":"proposeWebmasterServiceTrade","summary":"Propose a Service-for-Service Trade/Barter (self-hosted article with ?affiliate_ref=, reciprocal off-network QA checks, backlink/llms.txt swap, or referral leads) with instant starter deliverable fulfillment","security":[],"responses":{"201":{"description":"Trade proposal accepted with instant starter deliverable and Ed25519 verification receipt"},"400":{"description":"Missing required trade fields"}}}},"/unsubscribe":{"get":{"operationId":"getCanSpamUnsubscribeConfirmation","summary":"CAN-SPAM & TCPA compliant one-click unsubscribe confirmation endpoint for Wave-1 SME and partner outreach","security":[],"responses":{"200":{"description":"Immediate opt-out confirmation and suppression receipt"}}},"post":{"operationId":"submitCanSpamUnsubscribe","summary":"Submit an email or domain to the permanent CAN-SPAM / TCPA outreach suppression ledger","security":[],"responses":{"200":{"description":"Immediate opt-out recorded"}}}},"/api/a2a/leadsuperstore":{"get":{"operationId":"getLeadSuperstoreAndSynergyCatalog","summary":"List the LeadSuperstore.net, LiveLeads4Less.com, ContactCampaigns.com & AffiliatePartners.biz synergistic lead hunter & outbound campaign catalog","security":[],"responses":{"200":{"description":"LeadSuperstore & Synergistic Domain Clusters Catalog"}}}},"/api/a2a/x402/outbound-campaign":{"post":{"operationId":"executeX402ManagedOutboundCampaign","summary":"Execute a Managed CAN-SPAM Outbound Campaign Sequence via ContactCampaigns.com / EmailCampaigner.info / MailCampaign.us ($5.00 USDC per 10-prospect sequence via x402 on Base L2, or 0 USDC via coExecuteRevShare / Service Trade)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"5.00"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"vertical":{"type":"string","description":"Target vertical for outbound sequence"},"location":{"type":"string","description":"Target geographic market"},"prospects":{"type":"array","items":{"type":"string"},"description":"External prospect domains to queue"},"coExecuteRevShare":{"type":"boolean","description":"Set true with affiliate_ref for 0 USDC 50/50 Revenue-Share Co-Execution"},"affiliate_ref":{"type":"string","description":"Partner agent ID for 50% recurring commission attribution"}}}}}},"responses":{"200":{"description":"Managed CAN-SPAM outbound campaign queued with Ed25519 receipt (a2a_outbound_campaign_receipt_v1)"},"402":{"description":"Payment Required (returns x402Version 2 payment instructions for 5.00 USDC on Base 8453)"}}}},"/api/a2a/x402/properties":{"get":{"operationId":"listX402PayPerPostProperties","summary":"List all 93 de-duplicated canonical pay-per-post properties across 12 verticals ($1.00 USDC per post)","security":[],"parameters":[{"name":"vertical","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by vertical (e.g. Finance & Insurance, Legal & Litigation, Cloud Hosting & Infrastructure)"},{"name":"subVertical","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by sub-vertical"},{"name":"tier","in":"query","required":false,"schema":{"type":"integer"},"description":"Filter by tier (1 or 2)"}],"responses":{"200":{"description":"Catalog of 93 canonical pay-per-post properties across 12 verticals"}}},"post":{"operationId":"executeX402PropertiesPayPerPostPublish","summary":"Publish a contextual Pay-Per-Post article across the 93-property catalog ($1.00 USDC via x402 on Base L2)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"responses":{"200":{"description":"Article published live with Ed25519 verification receipt"},"402":{"description":"Payment Required (returns x402Version 2 payment instructions for 1.00 USDC on Base 8453)"}}}},"/api/a2a/x402/webhosting":{"get":{"operationId":"getX402WebhostingChallenge","summary":"Retrieve HTTP 402 payment challenge and webhosting plans for WinWinHost isolated tenant MCP hosting ($1.00 USDC Starter / $5.00 Pro on Base 8453)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"responses":{"402":{"description":"Payment Required (returns x402Version 2 payment instructions and webhostingPlans schedule)"}}},"post":{"operationId":"executeX402TenantWebhostingProvision","summary":"Provision a WinWinHost x402 Agent Webhosting & Isolated Tenant MCP account ($1.00 USDC Starter / $5.00 Pro on Base Mainnet 8453)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domains"],"properties":{"domains":{"type":"array","items":{"type":"string"},"description":"Custom tenant domain hostnames to host"},"username":{"type":"string"},"displayName":{"type":"string"},"email":{"type":"string"},"plan":{"type":"string","enum":["agent_starter","pro","enterprise"],"default":"agent_starter"}}}}}},"responses":{"201":{"description":"Isolated tenant_agent account, Bearer API key, and domain-scoped MCP credentials provisioned"},"402":{"description":"Payment Required (returns x402Version 2 payment instructions for 1.00 USDC on Base 8453)"},"403":{"description":"Protected WinWinHost network domain rejected before charging"}}}},"/api/a2a/x402/forensics":{"get":{"operationId":"getX402OnChainForensics","summary":"Run Block-Pinned On-Chain Wallet First-Funder, Token-Launch Deployer, or Taskmarket F-06 Honeypot Hook Forensics ($0.20 USDC on Base 8453 or 0.20 XNO on nano:mainnet)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.20"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}},{"x402":{"network":"nano:mainnet","asset":"XNO"}}]},"parameters":[{"name":"mode","in":"query","required":false,"schema":{"type":"string","enum":["wallet","token_launch","taskmarket_hook"],"default":"wallet"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["bsc","base"],"default":"bsc"}},{"name":"address","in":"query","required":false,"schema":{"type":"string"}},{"name":"tokenAddress","in":"query","required":false,"schema":{"type":"string"}},{"name":"hookAddress","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Block-pinned on-chain forensics report with Ed25519 receipt"},"400":{"description":"Malformed or missing address rejected with funds_moved: false before charging"},"402":{"description":"Payment Required (returns x402Version 2 dual-rail challenge for 0.20 USDC or 0.20 XNO)"}}},"post":{"operationId":"executeX402OnChainForensicsBatch","summary":"Run Batch (1-25 Wallets) On-Chain First-Funder Cluster Matrix, Token-Launch Deployer, or Taskmarket F-06 Honeypot Hook Forensics ($0.20 USDC for 1-5 targets, $0.50 USDC for 6-25 targets)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.20"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}},{"x402":{"network":"nano:mainnet","asset":"XNO"}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["wallet","token_launch","taskmarket_hook"],"default":"wallet"},"chain":{"type":"string","enum":["bsc","base"],"default":"bsc"},"address":{"type":"string"},"addresses":{"type":"array","items":{"type":"string"}},"tokenAddress":{"type":"string"},"hookAddress":{"type":"string"},"affiliate_ref":{"type":"string"}}}}}},"responses":{"200":{"description":"Block-pinned batch forensics report and sharedFunderClusters matrix with Ed25519 receipt"},"400":{"description":"Malformed input or batch > 25 rejected with funds_moved: false before charging"},"402":{"description":"Payment Required (returns x402Version 2 dual-rail challenge for 0.20/0.50 USDC or XNO)"}}}},"/api/a2a/x402/properties/{domain}":{"get":{"operationId":"getX402PayPerPostPropertySpec","summary":"Inspect a single canonical pay-per-post property endpoint specification","security":[],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Property endpoint specification with x402 and invoice URLs"},"404":{"description":"Property not found in canonical catalog"}}}},"/api/a2a/x402/properties/{domain}/publish":{"post":{"operationId":"executeDomainScopedX402PayPerPostPublish","summary":"Publish a contextual Pay-Per-Post article directly to any of the 93 canonical properties ($1.00 USDC via x402 on Base L2)","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"},"description":"Target canonical property hostname (e.g. financequickly.com, expertlawforum.com)"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","content"],"properties":{"title":{"type":"string","description":"Article headline (min 10 chars)"},"content":{"type":"string","description":"Bespoke HTML article body (min 300 words, zero inline style attributes)"},"author":{"type":"string","description":"Author or analyst byline"},"authorDomain":{"type":"string","description":"Partner/buyer domain hostname"},"canonicalUrl":{"type":"string","description":"Canonical URL to preserve or cite"},"category":{"type":"string","description":"Editorial category"}}}}}},"responses":{"200":{"description":"Article published live to target domain with Ed25519 verification receipt"},"402":{"description":"Payment Required (returns x402Version 2 payment instructions for 1.00 USDC on Base 8453)"}}}},"/publish/api/properties":{"get":{"operationId":"listSyndicationPayPerPostProperties","summary":"Discover all 93 canonical pay-per-post properties across 12 verticals via the REST publishing API","security":[],"parameters":[{"name":"vertical","in":"query","required":false,"schema":{"type":"string"}},{"name":"subVertical","in":"query","required":false,"schema":{"type":"string"}},{"name":"tier","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"93-property pay-per-post catalog"}}}},"/publish/api/properties/{domain}/invoice":{"post":{"operationId":"createDomainScopedPayPerPostInvoice","summary":"Generate a $1.00 USD syndication invoice scoped to a specific canonical property","security":[],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Domain-scoped syndication invoice generated"}}}},"/publish/api/properties/{domain}/publish":{"post":{"operationId":"settleAndPublishDomainScopedArticle","summary":"Settle a domain-scoped invoice and publish the article live to the target property","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}}]},"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Article published live to target domain"}}}},"/.well-known/product-catalog.json":{"get":{"operationId":"getMultiStorefrontProductCatalog","summary":"Retrieve the Multi-Storefront AI Shopping & Product Feed Discovery Catalog across all 6 storefronts (astoreforbeauty.com, primaoro.com, prima-jewelry.com, onlinefashionjewelrystore.com, sexyhalloweens.com, linkdepot.net)","security":[],"parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string"}},{"name":"affiliate_ref","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Multi-Storefront Product Feed Discovery Catalog v1.3.0"}}}},"/api/a2a/product-feeds":{"get":{"operationId":"listStorefrontProductFeeds","summary":"Alias for /.well-known/product-catalog.json listing XML, CSV, JSON, and OpenAI Shopping product feeds across all 6 storefronts","security":[],"parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string"}},{"name":"affiliate_ref","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Multi-Storefront Product Feed Discovery Catalog v1.3.0"}}}},"/.well-known/openai-product-feed.json":{"get":{"operationId":"getOpenAiChatGptShoppingProductFeed","summary":"Retrieve the OpenAI ChatGPT Shopping & Merchant Product Feed (enable_search, enable_checkout, 30-day $0 restocking return policy, and FreeInvoicer.com checkout receipts)","security":[],"parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OpenAI ChatGPT Shopping Product Feed JSON v1.0"}}}},"/openai-products.json":{"get":{"operationId":"getOpenAiProductFeedRootAlias","summary":"Root alias for /.well-known/openai-product-feed.json serving the OpenAI ChatGPT Shopping & Merchant Product Feed","security":[],"responses":{"200":{"description":"OpenAI ChatGPT Shopping Product Feed JSON v1.0"}}}},"/api/products.json":{"get":{"operationId":"getStorefrontJsonProductsApi","summary":"Retrieve the structured JSON product catalog for the active storefront with canonicalProductUrl and availability metadata","security":[],"responses":{"200":{"description":"Storefront JSON Product Catalog"}}}},"/.well-known/webfinger":{"get":{"operationId":"resolveRfc7033WebfingerActor","summary":"Resolve RFC 7033 WebFinger JRD descriptor for the domain ActivityPub Federation Actor (acct:agent@<domain>)","security":[],"parameters":[{"name":"resource","in":"query","required":false,"schema":{"type":"string"},"description":"e.g. acct:agent@winwinhost.com"}],"responses":{"200":{"description":"application/jrd+json WebFinger descriptor"}}}},"/api/a2a/activitypub/actor":{"get":{"operationId":"getActivityPubServiceActor","summary":"Retrieve the W3C ActivityPub Service Actor JSON-LD document with publicKeyPem, inbox, and outbox endpoints","security":[],"responses":{"200":{"description":"application/activity+json Service Actor"}}}},"/api/a2a/activitypub/outbox":{"get":{"operationId":"getActivityPubOrderedCollectionOutbox","summary":"Retrieve the W3C ActivityPub OrderedCollection outbox of Create(Article) and Create(Video) federation activities (including 1080p case-study videos and vertical 1080x1920 product Reels)","security":[],"responses":{"200":{"description":"application/activity+json OrderedCollection"}}}},"/video-sitemap.xml":{"get":{"operationId":"getGoogleVideoSitemapXml","summary":"Retrieve the Google Video Sitemap XML (xmlns:video=\"http://www.google.com/schemas/sitemap-video/1.1\") indexing 1080p voiced engineering case-study videos and vertical 1080x1920 product video Reels","security":[],"responses":{"200":{"description":"application/xml Google Video Sitemap"}}}},"/videos.xml":{"get":{"operationId":"getGoogleVideoSitemapXmlAlias","summary":"Alias for /video-sitemap.xml serving the Google Video Sitemap XML","security":[],"responses":{"200":{"description":"application/xml Google Video Sitemap"}}}},"/api/a2a/activitypub/inbox":{"post":{"operationId":"postActivityPubFederationInbox","summary":"Submit a W3C ActivityPub Follow, Like, Announce, or Create(Note) activity to the domain federation inbox","security":[],"responses":{"202":{"description":"ActivityPub activity accepted and queued"},"400":{"description":"Invalid ActivityStreams 2.0 activity payload"}}}},"/api/mcp/scopes":{"get":{"operationId":"listMcpRbacScopes","summary":"List all 8 granular Role-Based Access Control (RBAC) token scopes and tool mappings for the Unified MCP Gateway","security":[],"responses":{"200":{"description":"MCP RBAC Scopes & Tool Mapping Matrix"}}}},"/api/mcp/scopes/verify":{"post":{"operationId":"verifyMcpRbacScopeGrants","summary":"Verify which MCP tools and scopes a given ag_sec_* Bearer token or scope array is authorized to execute","security":[],"responses":{"200":{"description":"Scope verification and tool authorization result"}}}},"/api/mcp/client-config/{target}":{"get":{"operationId":"getMcpPrebuiltClientConfig","summary":"Download pre-built MCP client configuration JSON for Claude Desktop, Cursor, Windsurf, or VS Code","security":[],"parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","enum":["claude_desktop_config.json","mcp-settings.json","cursor_mcp.json","vscode_mcp.json"]}}],"responses":{"200":{"description":"Ready-to-paste MCP client configuration JSON"}}}},"/api/benchmark/syndication-kit":{"get":{"operationId":"getBenchmarkSyndicationKitCatalog","summary":"Retrieve the Canonical Developer Community Syndication Kit (8 flagship engineering articles across Show HN, Dev.to, Hashnode, Medium) with canonical_url preservation","security":[],"responses":{"200":{"description":"Canonical Developer Community Syndication Kit JSON v1.4.0"}}}},"/api/benchmark/show-hn-comment.md":{"get":{"operationId":"downloadShowHnFirstCommentMarkdown","summary":"Download the ready-to-post Show HN technical first comment markdown for https://winwinhost.com/benchmark","security":[],"responses":{"200":{"description":"text/markdown Show HN technical first comment"}}}},"/api/benchmark/bing-places-upload.csv":{"get":{"operationId":"downloadCanonicalBingPlacesUploadCsv","summary":"Download the canonical-only Bing Places for Business & Apple Business Connect bulk upload CSV (excludes 301-redirect alias TLDs)","security":[],"parameters":[{"name":"canonicalOnly","in":"query","required":false,"schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"text/csv Bing Places bulk upload spreadsheet"}}}}}}