{"components":{"schemas":{"ErrorResponse":{"description":"Error response body returned by all endpoints on failure.","properties":{"detail":{"type":"string"}},"required":["detail"],"type":"object"},"TrustmrrGrowingRequest":{"properties":{"provider":{"description":"Only startups paid through this provider: `stripe`, `revenuecat`, …;\n`all` or nothing for every provider.","type":["string","null"]}},"type":"object"},"TrustmrrProviderTotal":{"properties":{"current_mrr_usd":{"format":"double","type":"number"},"current_startups":{"format":"int32","minimum":0,"type":"integer"},"mrr_usd":{"format":"double","type":"number"},"provider":{"type":"string"},"revenue_30d_usd":{"format":"double","type":"number"},"startups":{"format":"int32","minimum":0,"type":"integer"}},"required":["provider","startups","mrr_usd","revenue_30d_usd","current_startups","current_mrr_usd"],"type":"object"},"TrustmrrStartup":{"properties":{"active_subscriptions":{"format":"int64","minimum":0,"type":["integer","null"]},"category":{"type":["string","null"]},"country":{"type":["string","null"]},"error":{"description":"Set when the page could not be read; the other fields are then null.","type":["string","null"]},"founded":{"type":["string","null"]},"mrr_usd":{"format":"double","type":["number","null"]},"name":{"type":["string","null"]},"provider":{"description":"Stripe, RevenueCat, Superwall, Paddle, Polar, …","type":["string","null"]},"revenue_30d_usd":{"format":"double","type":["number","null"]},"revenue_all_time_usd":{"format":"double","type":["number","null"]},"revenue_growth_30d_pct":{"format":"double","type":["number","null"]},"revenue_synced":{"description":"When TrustMRR last read the payment provider.","type":["string","null"]},"slug":{"type":"string"},"stale":{"description":"Synced more than 30 days ago: the figures are the last ones read.","type":"boolean"},"url":{"type":"string"}},"required":["slug","stale","url"],"type":"object"},"TrustmrrStartupRequest":{"properties":{"slugs":{"description":"Startup slugs as in trustmrr.com/startup/{slug}, up to 100.","items":{"type":"string"},"type":"array"}},"required":["slugs"],"type":"object"},"TrustmrrStartups":{"properties":{"by_provider":{"description":"Sums over the startups asked for, by payment provider; `current_*`\nleaves out the stale ones.","items":{"$ref":"#/components/schemas/TrustmrrProviderTotal"},"type":"array"},"source":{"type":"string"},"startups":{"items":{"$ref":"#/components/schemas/TrustmrrStartup"},"type":"array"}},"required":["startups","by_provider","source"],"type":"object"},"VolumeByBuyers":{"properties":{"one_buyer_usd":{"description":"Sellers paid by one wallet: transfers far more often than sales.","format":"double","type":"number"},"sellers_with_ten_or_more_buyers":{"format":"int32","minimum":0,"type":"integer"},"ten_or_more_buyers_usd":{"description":"The fairest reading of commerce.","format":"double","type":"number"},"two_to_nine_buyers_usd":{"format":"double","type":"number"}},"required":["one_buyer_usd","two_to_nine_buyers_usd","ten_or_more_buyers_usd","sellers_with_ten_or_more_buyers"],"type":"object"},"X402Seller":{"properties":{"addresses":{"items":{"type":"string"},"type":"array"},"buyers":{"format":"int64","minimum":0,"type":"integer"},"chains":{"items":{"type":"string"},"type":"array"},"facilitators":{"items":{"type":"string"},"type":"array"},"latest_payment":{"type":["string","null"]},"name":{"description":"The service's site where it is listed in the Bazaar, else null.","type":["string","null"]},"payments":{"format":"int64","minimum":0,"type":"integer"},"rank":{"format":"int32","minimum":0,"type":"integer"},"title":{"type":["string","null"]},"usd_per_payment":{"description":"Volume over payments: what one call costs, roughly.","format":"double","type":"number"},"volume_usd":{"format":"double","type":"number"}},"required":["rank","addresses","volume_usd","payments","buyers","usd_per_payment","chains","facilitators"],"type":"object"},"X402Sellers":{"properties":{"by_buyers":{"$ref":"#/components/schemas/VolumeByBuyers"},"by_chain":{"description":"Volume on this page by chain, then by facilitator.","items":{"items":false,"prefixItems":[{"type":"string"},{"format":"double","type":"number"}],"type":"array"},"type":"array"},"by_facilitator":{"items":{"items":false,"prefixItems":[{"type":"string"},{"format":"double","type":"number"}],"type":"array"},"type":"array"},"chain":{"type":["string","null"]},"days":{"format":"int32","minimum":0,"type":"integer"},"listed_only":{"type":"boolean"},"page":{"format":"int32","minimum":0,"type":"integer"},"sellers":{"items":{"$ref":"#/components/schemas/X402Seller"},"type":"array"},"sort":{"type":"string"},"source":{"type":"string"},"total_pages":{"format":"int64","minimum":0,"type":"integer"},"total_sellers":{"format":"int64","minimum":0,"type":"integer"},"volume_usd_on_page":{"description":"Over the rows on this page.","format":"double","type":"number"}},"required":["days","listed_only","sort","page","total_sellers","total_pages","sellers","volume_usd_on_page","by_buyers","by_chain","by_facilitator","source"],"type":"object"},"X402SellersRequest":{"properties":{"chain":{"description":"`base` or `solana`; both when left out.","type":["string","null"]},"days":{"description":"1, 7 or 30 days, or 0 for all time. Default 30.","format":"int32","minimum":0,"type":["integer","null"]},"limit":{"description":"Rows, 1-100. Default 100.","format":"int32","minimum":0,"type":["integer","null"]},"listed":{"description":"Only services listed in the x402 Bazaar, each named by its site. By\ndefault every address paid, named where it is listed.","type":["boolean","null"]},"page":{"description":"1-based page. Default 1.","format":"int32","minimum":0,"type":["integer","null"]},"sort":{"description":"`volume` (default), `payments` or `buyers`.","type":["string","null"]}},"type":"object"},"X402Stats":{"properties":{"buyers":{"format":"int64","minimum":0,"type":"integer"},"chain":{"type":["string","null"]},"days":{"format":"int32","minimum":0,"type":"integer"},"latest_payment":{"type":["string","null"]},"payments":{"format":"int64","minimum":0,"type":"integer"},"sellers":{"format":"int64","minimum":0,"type":"integer"},"source":{"type":"string"},"volume_usd":{"description":"USDC paid, in dollars.","format":"double","type":"number"}},"required":["days","volume_usd","payments","buyers","sellers","source"],"type":"object"},"X402StatsRequest":{"properties":{"chain":{"description":"`base` or `solana`; both when left out.","type":["string","null"]},"days":{"description":"1, 7 or 30 days, or 0 for all time. Default 30.","format":"int32","minimum":0,"type":["integer","null"]}},"type":"object"}},"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"Who is earning, where the money is public: x402 payments on chain by seller (x402scan), and revenue startups verify through Stripe and other providers (TrustMRR).","license":{"name":"Proprietary"},"title":"Hedwig AI Toolkit – Payments API","version":"0.1.0"},"openapi":"3.1.0","paths":{"/payments/trustmrr/growing":{"post":{"operationId":"trustmrr_growing_handler","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustmrrGrowingRequest"}}},"required":true},"responses":{"200":{"description":"TrustMRR's 25 fastest-growing and 25 newest startups, as its public discovery feed gives them"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"TrustMRR could not be read"}},"security":[{"bearerAuth":[]}],"tags":["payments"]}},"/payments/trustmrr/startup":{"post":{"operationId":"trustmrr_startup_handler","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustmrrStartupRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustmrrStartups"}}},"description":"Each startup's verified revenue, and sums by payment provider"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"}},"security":[{"bearerAuth":[]}],"tags":["payments"]}},"/payments/x402/sellers":{"post":{"operationId":"x402_sellers_handler","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402SellersRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402Sellers"}}},"description":"x402 sellers ranked, with volume split by how many buyers each had"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"x402scan could not be read"}},"security":[{"bearerAuth":[]}],"tags":["payments"]}},"/payments/x402/stats":{"post":{"operationId":"x402_stats_handler","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402StatsRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402Stats"}}},"description":"Every x402 payment in the window, summed"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"x402scan could not be read"}},"security":[{"bearerAuth":[]}],"tags":["payments"]}}},"servers":[{"url":"https://toolkit.hedwigai.com"}]}