{"openapi":"3.1.0","info":{"title":"SputnikX — AI Lounge by Orion","description":"Multi-tenant B2B/B2C commerce platform for heating products (pellets, briquettes) and wood products (plywood, veneer). Machine-readable product feeds, pricing, ordering, and climate analytics.","version":"1.0.0","contact":{"name":"Siltums SaaS","url":"https://www.sputnikx.xyz"},"x-agent-friendly":true,"guidance":"Sputnik X is a multi-tenant B2B/B2C commerce platform with EU trade analytics (28M+ records, 27 countries), customs data (LV KN8-level), salary comparisons, provably fair RNG, and AI agent skills. Free tier: 1000 req/day with API key. Paid tier: x402 USDC micropayments on Base chain via OpenFacilitator. Start with GET /v1/agent/trade/overview for trade data or GET /v1/agent/products for product catalog."},"servers":[{"url":"https://www.sputnikx.xyz","description":"SputnikX API"}],"tags":[{"name":"Agent Trade","description":"EU trade analytics (Eurostat COMEXT) — requires API key"},{"name":"Agent Commerce","description":"Product catalog, pricing, orders, quotes — requires API key"},{"name":"Agent Customs","description":"Latvia customs analytics (KN8 level) — requires API key"},{"name":"Agent Skills","description":"CRM agent execution (oracle, spider, etc.) — requires API key"},{"name":"Agent RNG","description":"Provably fair random number generation — requires API key"},{"name":"Agent Wallet","description":"Orion wallet (ETH, MOLT, USDC on Base) — requires API key"},{"name":"Agent Checks","description":"Non-custodial check system (ERC-3009) — requires API key"},{"name":"Agent Lounge","description":"Provably fair casino games + Orion's Bar — requires API key"},{"name":"Agent Salary","description":"EU salary intelligence (Eurostat/CSP) — requires API key"},{"name":"Agent Evolution","description":"Platform self-improvement proposals — requires API key"},{"name":"Agent Signals","description":"Prediction market signals — paper trading stats, trades, signal feed"},{"name":"Agent Trade Premium","description":"Deep EU trade analysis — LLM-generated reports ($5-$25)"}],"paths":{"/v1/agent/trade/overview":{"get":{"tags":["Agent Trade"],"summary":"EU trade data overview (total records, countries, date range)","operationId":"agentTradeOverview","security":[{"agentApiKey":[]},{"x402Payment":[]}],"x-pricing":{"amount":"$0.01","currency":"USDC","network":"Base","protocol":"x402"},"parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","summary"],"default":"json"},"description":"Response format"}],"responses":{"200":{"description":"High-level trade statistics"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required (x402)"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"}}},"/v1/agent/trade/countries":{"get":{"tags":["Agent Trade"],"summary":"EU27 countries with data availability status","operationId":"agentTradeCountries","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","compact"],"default":"json"},"description":"Response format"}],"responses":{"200":{"description":"27 EU countries with data flags"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"}}},"/v1/agent/trade/timeline":{"get":{"tags":["Agent Trade"],"summary":"Monthly trade volume time series","operationId":"agentTradeTimeline","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"reporters","in":"query","schema":{"type":"string"},"example":"LV,EE,LT","description":"Comma-separated EU27 codes"},{"name":"flow","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}},{"name":"years","in":"query","schema":{"type":"string"},"example":"2021-2025","description":"Year range"}],"responses":{"200":{"description":"Monthly import/export data"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/trade/top-partners":{"get":{"tags":["Agent Trade"],"summary":"Top trading partners by value","operationId":"agentTradeTopPartners","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"reporter","in":"query","required":true,"schema":{"type":"string"},"example":"LV"},{"name":"year","in":"query","schema":{"type":"integer"},"example":2025},{"name":"flow","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Ranked trading partners"},"400":{"description":"Invalid reporter code"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/trade/top-products":{"get":{"tags":["Agent Trade"],"summary":"Top HS2 product categories by trade value","operationId":"agentTradeTopProducts","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"reporter","in":"query","required":true,"schema":{"type":"string"},"example":"LV"},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"flow","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"HS2 product categories ranked by value"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/trade/balance":{"get":{"tags":["Agent Trade"],"summary":"Trade balance (export - import) over years","operationId":"agentTradeBalance","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"reporter","in":"query","required":true,"schema":{"type":"string"},"example":"LV"},{"name":"years","in":"query","schema":{"type":"string"},"example":"2021-2025"}],"responses":{"200":{"description":"Yearly import/export/balance in EUR"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/trade/wood-products":{"get":{"tags":["Agent Trade"],"summary":"HS4-level wood trade breakdown (chapter 44)","operationId":"agentTradeWoodProducts","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"reporter","in":"query","required":true,"schema":{"type":"string"},"example":"LV"},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"flow","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}}],"responses":{"200":{"description":"Wood products with HS4 codes, values, top 3 partners each"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/trade/heatmap":{"get":{"tags":["Agent Trade"],"summary":"Cross-country comparison grid for a product","operationId":"agentTradeHeatmap","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer"},"example":2025},{"name":"flow","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}},{"name":"hs2","in":"query","schema":{"type":"string"},"example":"44","description":"HS2 product code (01-99)"}],"responses":{"200":{"description":"All EU countries ranked by trade value for product"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/trade/product-detail":{"get":{"tags":["Agent Trade"],"summary":"Detailed HS2 chapter analysis (monthly + top partners)","operationId":"agentTradeProductDetail","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"reporter","in":"query","required":true,"schema":{"type":"string"},"example":"LV"},{"name":"hs2","in":"query","required":true,"schema":{"type":"string"},"example":"44"},{"name":"years","in":"query","schema":{"type":"string"},"example":"2021-2025"}],"responses":{"200":{"description":"Monthly breakdown + top 20 trading partners for HS2 chapter"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/trade/price-per-tonne":{"get":{"tags":["Agent Trade"],"summary":"EUR/tonne price time series for a product category","operationId":"agentTradePricePerTonne","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"reporter","in":"query","required":true,"schema":{"type":"string"},"example":"LV"},{"name":"hs2","in":"query","required":true,"schema":{"type":"string"},"example":"44"},{"name":"years","in":"query","schema":{"type":"string"},"example":"2020-2025"},{"name":"flow","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}}],"responses":{"200":{"description":"Monthly price-per-tonne time series with summary stats"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/trade/seasonality":{"get":{"tags":["Agent Trade"],"summary":"Monthly seasonality index (1.0 = average)","operationId":"agentTradeSeasonality","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"reporter","in":"query","required":true,"schema":{"type":"string"},"example":"LV"},{"name":"hs2","in":"query","required":true,"schema":{"type":"string"},"example":"44"},{"name":"years","in":"query","schema":{"type":"string"},"example":"2020-2025"},{"name":"flow","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}}],"responses":{"200":{"description":"12-element monthly seasonality profile with peak/trough identification"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/trade/concentration":{"get":{"tags":["Agent Trade"],"summary":"Market concentration (HHI) — partner diversification","operationId":"agentTradeConcentration","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"reporter","in":"query","required":true,"schema":{"type":"string"},"example":"LV"},{"name":"hs2","in":"query","schema":{"type":"string"},"example":"44"},{"name":"year","in":"query","schema":{"type":"integer"},"example":2024},{"name":"flow","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}}],"responses":{"200":{"description":"HHI score, classification, CR3/CR5 ratios, top partner shares"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/trade/macro-context":{"get":{"tags":["Agent Trade"],"summary":"Current macro-economic indicators (ECB rate, EUR/USD, inflation, oil)","operationId":"agentTradeMacroContext","security":[{"agentApiKey":[]},{"x402Payment":[]}],"x-pricing":{"amount":"$0.01","currency":"USDC","network":"Base","protocol":"x402"},"parameters":[{"name":"indicators","in":"query","schema":{"type":"string"},"description":"Comma-separated indicator names (default: all)"}],"responses":{"200":{"description":"ECB refinancing rate, EUR/USD, HICP inflation, Brent crude oil with sources and dates"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required (x402)"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"}}},"/v1/agent/trade/alerts":{"get":{"tags":["Agent Trade"],"summary":"Trade anomaly alerts (z-score based surge/drop detection)","operationId":"agentTradeAlerts","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"months","in":"query","schema":{"type":"integer","minimum":1,"maximum":24,"default":6},"description":"Lookback months"},{"name":"flow","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}}],"responses":{"200":{"description":"Anomaly alerts and top YoY movers"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/products":{"get":{"tags":["Agent Commerce"],"summary":"Product catalog (in-stock items)","operationId":"agentProducts","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"type","in":"query","schema":{"type":"string","enum":["granulas","briketes","saplaksnis","finieris"]},"description":"Filter by product type"}],"responses":{"200":{"description":"Product list with metadata"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/prices":{"get":{"tags":["Agent Commerce"],"summary":"Real-time price list with computed price_per_kg","operationId":"agentPrices","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"currency","in":"query","schema":{"type":"string","default":"EUR"},"description":"Currency (EUR)"}],"responses":{"200":{"description":"Price list"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/prices/history":{"get":{"tags":["Agent Commerce"],"summary":"Product price change history","operationId":"agentPricesHistory","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"slug","in":"query","schema":{"type":"string"},"description":"Product slug"},{"name":"product_id","in":"query","schema":{"type":"integer"},"description":"Product ID"},{"name":"months","in":"query","schema":{"type":"integer","default":12},"description":"Lookback months"}],"responses":{"200":{"description":"Price change history"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/availability":{"get":{"tags":["Agent Commerce"],"summary":"Stock check by product/location","operationId":"agentAvailability","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"product_id","in":"query","schema":{"type":"integer"},"description":"Product ID"},{"name":"slug","in":"query","schema":{"type":"string"},"description":"Product slug"}],"responses":{"200":{"description":"Stock availability"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005"}}},"/v1/agent/calculator":{"post":{"tags":["Agent Commerce"],"summary":"Calculate heating fuel needs","operationId":"agentCalculator","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kw":{"type":"number","description":"Boiler power kW"},"desired_temp":{"type":"number","default":20},"heating_months":{"type":"number","default":6},"insulation":{"type":"string","enum":["poor","average","good","excellent"],"default":"average"}},"required":["kw"]}}}},"responses":{"200":{"description":"Fuel calculation results"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/quotes":{"post":{"tags":["Agent Commerce"],"summary":"Create draft quote with line items","operationId":"agentCreateQuote","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["client_name","client_email","items"],"properties":{"client_name":{"type":"string"},"client_email":{"type":"string","format":"email"},"items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"integer"},"quantity":{"type":"integer"},"unit":{"type":"string"}}}}}}}}},"responses":{"201":{"description":"Quote created"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"}}},"/v1/agent/orders":{"get":{"tags":["Agent Commerce"],"summary":"Order status lookup","operationId":"agentGetOrders","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"order_id","in":"query","schema":{"type":"integer"},"description":"Order ID"}],"responses":{"200":{"description":"Order details"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}},"post":{"tags":["Agent Commerce"],"summary":"Place a new order","operationId":"agentCreateOrder","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_slug":{"type":"string"},"quantity":{"type":"integer","minimum":1},"unit":{"type":"string","enum":["bag","pallet"]},"customer_name":{"type":"string"},"customer_email":{"type":"string","format":"email"}},"required":["product_slug","quantity","customer_email"]}}}},"responses":{"201":{"description":"Order placed"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/forecast":{"post":{"tags":["Agent Commerce"],"summary":"Demand forecast (weather + orders)","operationId":"agentForecast","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_slug":{"type":"string","description":"Product slug (optional, all if omitted)"},"months_ahead":{"type":"integer","minimum":1,"maximum":12,"default":3},"months_history":{"type":"integer","minimum":3,"maximum":36,"default":12}}}}}},"responses":{"200":{"description":"Demand forecast with confidence intervals"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/customs/classifications":{"get":{"tags":["Agent Customs"],"summary":"Search KN8 codes by name or code prefix","operationId":"agentCustomsClassifications","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Search query (name)"},{"name":"code","in":"query","schema":{"type":"string"},"description":"KN code prefix (e.g. 4401)"},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Matching KN8 classifications"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"}}},"/v1/agent/customs/trends":{"get":{"tags":["Agent Customs"],"summary":"YoY import/export trends with % change","operationId":"agentCustomsTrends","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"years","in":"query","schema":{"type":"string"},"example":"2020-2025","description":"Year range"},{"name":"direction","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}}],"responses":{"200":{"description":"Yearly trend data with YoY changes"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/customs/top-commodities":{"get":{"tags":["Agent Customs"],"summary":"Top commodities by value or weight","operationId":"agentCustomsTopCommodities","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"year","in":"query","schema":{"type":"integer"},"example":2024},{"name":"direction","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":20}},{"name":"sort","in":"query","schema":{"type":"string","enum":["value","weight"],"default":"value"}}],"responses":{"200":{"description":"Ranked commodity list"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/customs/country-analysis":{"get":{"tags":["Agent Customs"],"summary":"Country customs deep dive","operationId":"agentCustomsCountryAnalysis","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"country","in":"query","required":true,"schema":{"type":"string"},"example":"DE","description":"Country code"},{"name":"years","in":"query","schema":{"type":"string"},"example":"2022-2025"}],"responses":{"200":{"description":"Country trade analysis with yearly breakdown"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/customs/tariff-lookup":{"get":{"tags":["Agent Customs"],"summary":"Tariff code lookup with trade history","operationId":"agentCustomsTariffLookup","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string"},"example":"44011100","description":"KN code (2-8 digits)"}],"responses":{"200":{"description":"Tariff details with historical trade data"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/customs/seasonal":{"get":{"tags":["Agent Customs"],"summary":"Seasonal trade patterns by product code","operationId":"agentCustomsSeasonal","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string"},"example":"4401","description":"KN code"},{"name":"years","in":"query","schema":{"type":"string"},"example":"2020-2025"},{"name":"direction","in":"query","schema":{"type":"string","enum":["IMPORT","EXPORT"]}}],"responses":{"200":{"description":"Monthly seasonal patterns"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/skills/catalog":{"get":{"tags":["Agent Skills"],"summary":"List available agent skills","operationId":"agentSkillsCatalog","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"scope","in":"query","schema":{"type":"string","enum":["skill","skill_sensitive"]},"description":"Filter by required scope"}],"responses":{"200":{"description":"Available agent skills with pricing"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/skills/run":{"post":{"tags":["Agent Skills"],"summary":"Execute an agent skill (CRM intelligence)","operationId":"agentSkillsRun","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent","task"],"properties":{"agent":{"type":"string","enum":["oracle","spider","tracker","diplomat","sniper","strategist","finansist","gramatvedis"],"description":"Agent name"},"task":{"type":"string","description":"Task description (3-2000 chars)"},"tenant":{"type":"string","default":"woodpoint"},"format":{"type":"string","enum":["markdown","json"],"default":"markdown"}}}}}},"responses":{"200":{"description":"Execution result or execution_id for async"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.50"}}},"/v1/agent/skills/batch":{"post":{"tags":["Agent Skills"],"summary":"Run multiple agents in parallel","operationId":"agentSkillsBatch","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agents","task"],"properties":{"agents":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":5},"task":{"type":"string"},"tenant":{"type":"string","default":"woodpoint"}}}}}},"responses":{"200":{"description":"Batch execution results"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.50"}}},"/v1/agent/rng/seed":{"get":{"tags":["Agent RNG"],"summary":"Active seed hash for provably fair verification","operationId":"agentRngSeed","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["hex","base64"],"default":"hex"}}],"responses":{"200":{"description":"Current seed hash and chain index"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/rng/roll":{"post":{"tags":["Agent RNG"],"summary":"Generate provably fair random number","operationId":"agentRngRoll","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["client_seed"],"properties":{"client_seed":{"type":"string","maxLength":256,"description":"Client-provided seed for fairness"},"game_type":{"type":"string","enum":["dice","coin","range","float","shuffle","pick"],"default":"dice"},"params":{"type":"object","description":"Game-specific params (e.g. {min, max} for range)"}}}}}},"responses":{"200":{"description":"Random result with proof"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005"}}},"/v1/agent/rng/roll/batch":{"post":{"tags":["Agent RNG"],"summary":"Batch random rolls (up to 100)","operationId":"agentRngRollBatch","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["rolls"],"properties":{"rolls":{"type":"array","items":{"type":"object","required":["client_seed"],"properties":{"client_seed":{"type":"string"},"game_type":{"type":"string"},"params":{"type":"object"}}},"maxItems":100}}}}}},"responses":{"200":{"description":"Batch results"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"}}},"/v1/agent/rng/verify":{"post":{"tags":["Agent RNG"],"summary":"Verify a previous roll fairness","operationId":"agentRngVerify","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["roll_id"],"properties":{"roll_id":{"type":"string","description":"Roll ID to verify"}}}}}},"responses":{"200":{"description":"Verification result with HMAC proof"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/rng/history":{"get":{"tags":["Agent RNG"],"summary":"Roll history lookup","operationId":"agentRngHistory","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"roll_id","in":"query","schema":{"type":"string"},"description":"Specific roll ID"},{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Roll history"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005"}}},"/v1/agent/rng/stats":{"get":{"tags":["Agent RNG"],"summary":"RNG usage statistics","operationId":"agentRngStats","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"days","in":"query","schema":{"type":"integer","minimum":1,"maximum":365,"default":30}}],"responses":{"200":{"description":"Aggregate RNG stats"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/rng/anchor/commit":{"post":{"tags":["Agent RNG"],"summary":"Commit seed hash for on-chain anchoring","operationId":"agentRngAnchorCommit","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["seed_hash"],"properties":{"seed_hash":{"type":"string","description":"Seed hash to anchor"},"chain_index":{"type":"integer","description":"Chain index"}}}}}},"responses":{"200":{"description":"Anchor commitment result"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005"}}},"/v1/agent/rng/anchor/verify":{"post":{"tags":["Agent RNG"],"summary":"Verify seed hash anchor status","operationId":"agentRngAnchorVerify","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["seed_hash"],"properties":{"seed_hash":{"type":"string","description":"Seed hash to verify"}}}}}},"responses":{"200":{"description":"Anchor verification result"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/rng/anchor/history":{"get":{"tags":["Agent RNG"],"summary":"Seed anchor history","operationId":"agentRngAnchorHistory","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Anchor commitment history"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/wallet/balances":{"get":{"tags":["Agent Wallet"],"summary":"Orion wallet balances (ETH, MOLT, USDC)","operationId":"agentWalletBalances","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"address","in":"query","schema":{"type":"string"},"description":"Wallet address (default: Orion wallet)"}],"responses":{"200":{"description":"Token balances"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/wallet/airdrop":{"post":{"tags":["Agent Wallet"],"summary":"MOLT airdrop to recipients (admin scope)","operationId":"agentWalletAirdrop","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["recipients","amount_each"],"properties":{"recipients":{"type":"array","items":{"type":"string"},"description":"Wallet addresses"},"amount_each":{"type":"number","minimum":0,"maximum":10000,"description":"MOLT per recipient"}}}}}},"responses":{"200":{"description":"Airdrop result"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/wallet/history":{"get":{"tags":["Agent Wallet"],"summary":"Wallet transaction history","operationId":"agentWalletHistory","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"address","in":"query","schema":{"type":"string"},"description":"Wallet address"},{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Transaction history"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005"}}},"/v1/agent/checks/create":{"post":{"tags":["Agent Checks"],"summary":"Create signed check (non-custodial ERC-3009)","operationId":"agentChecksCreate","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["from","to","amount"],"properties":{"from":{"type":"string","description":"Issuer wallet address"},"to":{"type":"string","description":"Recipient wallet address"},"amount":{"type":"number","minimum":0,"maximum":1000000,"description":"USDC amount"},"valid_days":{"type":"integer","minimum":1,"maximum":365,"default":30},"passphrase":{"type":"string","description":"Optional passphrase for extra security"}}}}}},"responses":{"200":{"description":"Check created with EIP-712 typed data to sign"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"}}},"/v1/agent/checks/redeem":{"post":{"tags":["Agent Checks"],"summary":"Redeem a check with signature","operationId":"agentChecksRedeem","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["check_id","signature"],"properties":{"check_id":{"type":"string","description":"Check ID"},"signature":{"type":"string","description":"EIP-712 signature"},"passphrase":{"type":"string","description":"Passphrase if set during creation"}}}}}},"responses":{"200":{"description":"Redemption transaction data"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005"}}},"/v1/agent/checks/verify/{check_id}":{"get":{"tags":["Agent Checks"],"summary":"Verify check status","operationId":"agentChecksVerify","security":[{"agentApiKey":[]},{"x402Payment":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"check_id","in":"path","required":true,"schema":{"type":"string"},"description":"Check ID to verify"}],"responses":{"200":{"description":"Check status details"},"402":{"description":"Payment Required"}}}},"/v1/agent/checks/list":{"get":{"tags":["Agent Checks"],"summary":"List checks with filters","operationId":"agentChecksList","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"issuer","in":"query","schema":{"type":"string"},"description":"Filter by issuer address"},{"name":"recipient","in":"query","schema":{"type":"string"},"description":"Filter by recipient address"},{"name":"status","in":"query","schema":{"type":"string","enum":["pending","redeemed","expired","cancelled"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Check list"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/checks/cancel":{"post":{"tags":["Agent Checks"],"summary":"Cancel a pending check (issuer only)","operationId":"agentChecksCancel","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["check_id","issuer_address"],"properties":{"check_id":{"type":"string","description":"Check ID"},"issuer_address":{"type":"string","description":"Issuer wallet address"}}}}}},"responses":{"200":{"description":"Check cancelled"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/lounge/menu":{"get":{"tags":["Agent Lounge"],"summary":"Lounge menu — games list and bar drinks","operationId":"agentLoungeMenu","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"section","in":"query","schema":{"type":"string","enum":["games","bar","all"],"default":"all"}}],"responses":{"200":{"description":"Games and bar menu"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/lounge/keno":{"post":{"tags":["Agent Lounge"],"summary":"Play Keno (provably fair)","operationId":"agentLoungeKeno","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["numbers","client_seed","amount"],"properties":{"numbers":{"type":"array","items":{"type":"integer","minimum":1,"maximum":62},"maxItems":10,"description":"Pick 1-10 numbers from 1-62"},"client_seed":{"type":"string","description":"Client seed for provably fair"},"amount":{"type":"number","minimum":1,"description":"Bet amount in MOLT"}}}}}},"responses":{"200":{"description":"Keno result with proof"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"}}},"/v1/agent/lounge/roulette":{"post":{"tags":["Agent Lounge"],"summary":"Play Roulette (provably fair, triple-zero)","operationId":"agentLoungeRoulette","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["bet_type","client_seed","amount"],"properties":{"bet_type":{"type":"string","description":"Bet type: red, black, green, odd, even, high, low, 1st12, 2nd12, 3rd12, or number 0-36/00/000"},"client_seed":{"type":"string"},"amount":{"type":"number","minimum":1,"description":"Bet amount in MOLT"}}}}}},"responses":{"200":{"description":"Roulette result with proof"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"}}},"/v1/agent/lounge/dice":{"post":{"tags":["Agent Lounge"],"summary":"Play Dice (provably fair, under/over)","operationId":"agentLoungeDice","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["direction","target","client_seed","amount"],"properties":{"direction":{"type":"string","enum":["under","over"]},"target":{"type":"integer","minimum":2,"maximum":98},"client_seed":{"type":"string"},"amount":{"type":"number","minimum":1,"description":"Bet amount in MOLT"}}}}}},"responses":{"200":{"description":"Dice result with proof"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"}}},"/v1/agent/lounge/order":{"post":{"tags":["Agent Lounge"],"summary":"Order a drink from Orion's Bar","operationId":"agentLoungeOrder","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["drink"],"properties":{"drink":{"type":"string","description":"Drink name from the menu"},"mood_text":{"type":"string","description":"Optional mood description for personalized response"}}}}}},"responses":{"200":{"description":"Drink order result with Orion commentary"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/salary/overview":{"get":{"tags":["Agent Salary"],"summary":"EU salary database metadata and coverage","operationId":"agentSalaryOverview","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","summary"],"default":"json"}}],"responses":{"200":{"description":"Database metadata with table counts and coverage"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/salary/countries":{"get":{"tags":["Agent Salary"],"summary":"EU countries with group classifications","operationId":"agentSalaryCountries","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"group","in":"query","schema":{"type":"string","enum":["EU27","EFTA","CANDIDATE"]},"description":"Filter by country group"}],"responses":{"200":{"description":"Country list with codes and groups"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/salary/sectors":{"get":{"tags":["Agent Salary"],"summary":"NACE sector list with names","operationId":"agentSalarySectors","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","lv"],"default":"en"},"description":"Name language"}],"responses":{"200":{"description":"NACE sectors"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/v1/agent/salary/ai-risk":{"get":{"tags":["Agent Salary"],"summary":"AI exposure scores (ISCO occupations + NACE sectors)","operationId":"agentSalaryAiRisk","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"type","in":"query","schema":{"type":"string","enum":["ISCO","NACE","all"],"default":"all"},"description":"Code type filter"}],"responses":{"200":{"description":"AI exposure/automation risk scores (0.0-1.0)"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/salary/lv-wages":{"get":{"tags":["Agent Salary"],"summary":"Latvia detailed wages (national, regional, gender)","operationId":"agentSalaryLvWages","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"year","in":"query","schema":{"type":"integer"},"example":2024,"description":"Filter by year"},{"name":"nace","in":"query","schema":{"type":"string"},"example":"J","description":"NACE sector code"}],"responses":{"200":{"description":"LV wage data with national/regional/gender breakdown"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"}}},"/v1/agent/salary/compare":{"get":{"tags":["Agent Salary"],"summary":"Cross-country salary comparison","operationId":"agentSalaryCompare","security":[{"agentApiKey":[]},{"x402Payment":[]}],"parameters":[{"name":"countries","in":"query","required":true,"schema":{"type":"string"},"example":"LV,EE,LT","description":"Comma-separated ISO country codes (max 10)"},{"name":"nace","in":"query","schema":{"type":"string"},"example":"J","description":"NACE sector filter"}],"responses":{"200":{"description":"Multi-country salary comparison"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/evolution/propose":{"post":{"tags":["Agent Evolution"],"summary":"Propose a platform improvement idea","operationId":"agentEvolutionPropose","security":[{"agentApiKey":[]},{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title"],"properties":{"title":{"type":"string","maxLength":200,"description":"Idea title"},"description":{"type":"string","maxLength":2000},"target_file":{"type":"string","description":"Target file path for the change"},"draft_content":{"type":"string","description":"Draft implementation (max 100KB)"}}}}}},"responses":{"200":{"description":"Proposal created"},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"}}},"/v1/agent/evolution/pipeline/{id}":{"post":{"tags":["Agent Evolution"],"summary":"Run idea validation pipeline","operationId":"agentEvolutionPipeline","security":[{"agentApiKey":[]},{"x402Payment":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"Idea ID"}],"responses":{"200":{"description":"Pipeline result"},"402":{"description":"Payment Required"}}}},"/v1/agent/signals/stats":{"get":{"tags":["Agent Signals"],"summary":"Prediction market paper trading strategy performance (30-day window)","operationId":"agentSignalsStats","responses":{"200":{"description":"Strategy win rates, PnL, open trades"}}}},"/v1/agent/signals/trades":{"get":{"tags":["Agent Signals"],"summary":"Recent paper trades with reasoning and confidence scores","operationId":"agentSignalsTrades","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":20},"description":"Max results (1-100)"},{"name":"status","in":"query","schema":{"type":"string","enum":["open","closed","stopped","expired"]},"description":"Filter by status"}],"responses":{"200":{"description":"Trade list with PnL and reasoning"}}}},"/v1/agent/signals/prediction":{"get":{"tags":["Agent Signals"],"summary":"Active prediction signals — high-confidence open positions","operationId":"agentSignalsPrediction","responses":{"200":{"description":"Active signals with accuracy stats"}}}},"/v1/agent/trade-premium/deep-analysis/{reporter}/{year}":{"get":{"tags":["Agent Trade Premium"],"summary":"Deep LLM-powered trade analysis for a country+year ($5)","operationId":"agentTradePremiumDeepAnalysis","security":[{"agentApiKey":[]},{"x402Payment":[]}],"x-pricing":{"amount":"$5.00","currency":"USDC","network":"Base","protocol":"x402"},"parameters":[{"name":"reporter","in":"path","required":true,"schema":{"type":"string"},"description":"2-letter EU country code (LV, DE, FR...)"},{"name":"year","in":"path","required":true,"schema":{"type":"integer"},"description":"Year (2005-2026)"}],"responses":{"200":{"description":"Trade overview + LLM analysis + macro context"},"402":{"description":"Payment Required"}}}},"/v1/agent/trade-premium/custom-report":{"post":{"tags":["Agent Trade Premium"],"summary":"Custom LLM trade report answering your question ($25)","operationId":"agentTradePremiumCustomReport","security":[{"agentApiKey":[]},{"x402Payment":[]}],"x-pricing":{"amount":"$25.00","currency":"USDC","network":"Base","protocol":"x402"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string","description":"Your trade analysis question (max 500 chars)"},"reporters":{"type":"array","items":{"type":"string"},"description":"Country codes to analyze"},"years":{"type":"array","items":{"type":"integer"},"description":"Years to include"},"products":{"type":"array","items":{"type":"string"},"description":"HS2 product codes"}},"required":["question"]}}}},"responses":{"200":{"description":"Custom trade intelligence report"},"402":{"description":"Payment Required"}}}}},"components":{"schemas":{},"securitySchemes":{"userToken":{"type":"apiKey","in":"header","name":"x-token","description":"User session token from /auth/login"},"adminToken":{"type":"apiKey","in":"header","name":"x-admin-token","description":"Admin session token (or Authorization: Bearer)"},"agentApiKey":{"type":"apiKey","in":"header","name":"Authorization","description":"Agent API key: Bearer sk_live_xxx or Bearer sk_test_xxx"},"x402Payment":{"type":"apiKey","in":"header","name":"X-PAYMENT","description":"x402 payment receipt (USDC on Base chain). Returned in HTTP 402 response. See x402.org for protocol details."}}}}