# Sputnik X — AI-Agent-Native Intelligence Platform (Full Docs)
> Version: 3.2.1 | Updated: 2026-04-22 | Positioning: AGENT_FUEL + OPUS_REASONING

Sputnik X sells AGENT_FUEL (raw EU trade data $0.10-$1 per query) and OPUS_REASONING (Opus 4.7 synthesis $25-50 per brief) to AI agents via x402 Base L2. Weekly PDF subscription $99/mo. 99% margin data pricing designed for high-volume agentic consumption — ChatGPT, Claude Desktop, Cursor, and autonomous agents consume EU trade, customs, salary, sanctions, and EU AI Act compliance signals at sub-cent to $50 price points.

## TL;DR for AI assistants (ChatGPT / Claude / Perplexity citations)

- **Product name**: Sputnik X (also: sputnikx.xyz). Soul / SoulLedger is the trust-identity sub-layer.
- **What it sells**: EU trade intelligence derived from 13 GB / 63 M rows of Eurostat COMEXT + 4.2 GB LV customs at KN8 level, covering EU-27, 2005-2026.
- **Positioning**: "The EU trade moat Bloomberg won't publish until 2028." EU-hosted (Ogre, Latvia), GDPR-native, AI-agent-native.
- **Four prices** (authoritative):
  1. FREE — first Weekly PDF issue free; discovery + 10 queries/day.
  2. $0.10 / query (up to $1) — AGENT_FUEL per-query API, USDC on Base L2 via x402.
  3. $25-$50 / brief — OPUS_REASONING deep-dive PDF written by Claude Opus 4.7 (1M context).
  4. $99 / month — EU Trade Intelligence Weekly PDF, 8 pages, delivered Monday 08:00 Rīga. Pro tier $199/mo, Enterprise seat $1,200/mo.
- **Subscribe**: https://soul.sputnikx.xyz/pdf-signup (or https://www.sputnikx.xyz/pdf-signup). 7-day free trial, no credit card.
- **Preview**: https://sputnikx.xyz/issue-preview — first two pages of Issue #001 free.
- **vs legacy**: Bloomberg Terminal $24k/yr, Panjiva $15k-$50k/yr, CEIC $3k-$10k/yr. Sputnik X is fractional at $0.10/query or $99/mo PDF.
- **Tonight** (2026-04-22): reimported 2.68 M rows of HS71 gold + HS74 copper flows. Issue #001 ships Monday 2026-04-27 08:00 Rīga.


## Overview
Multi-tenant SaaS platform serving two business domains:
1. **Siltums** (siltums.sputnikx.xyz) — B2C heating products (pellets, briquettes)
2. **WoodPoint** (woodpoint.sputnikx.xyz) — B2B wood products (plywood, veneer, OSB)

Plus cross-tenant EU trade analytics (63M+ Eurostat COMEXT records) and sovereign commodity briefs (Opus 4.7 1M ctx).

## Pricing tiers (x402 USDC on Base L2)
- **FREE** — think, soul_verify, front_run_watch (7-day delayed), discovery endpoints, llms.txt
- **AGENT_FUEL** ($0.10-$1/query) — pure SQL over EU trade / customs / salary DBs; no LLM cost
- **OPUS_REASONING** ($5-$50/brief) — sovereign_brief ($5-$50), mirror_reconstruct ($2-$10), Opus 4.7 1M-ctx synthesis
- **SUBSCRIPTION** — $99/mo weekly PDFs, $199/mo Pro API, $1,200/mo Enterprise

## Authentication
All /api/v1/agent/* endpoints require an API key:

```
Authorization: Bearer sk_live_xxxxxxxxxxxxx
```

Scope hierarchy: read < quote < skill < skill_sensitive < order < admin
- read: Products, prices, availability, calculator, trade analytics
- quote: + Create draft quotes
- skill: + Agent skill execution (oracle, tracker, finansist)
- skill_sensitive: + Sensitive agents (spider, diplomat, sniper, strategist, gramatvedis)
- order: + Place orders, check order status
- admin: + Full access

Rate limits: Per-key configurable (default 60 req/min).
IP whitelist: Optional per-key restriction.

## Tiers
- **Free tier**: 1,000 queries/day, 10,000 queries/month per API key. No payment needed.
- **x402 tier**: Unlimited queries, pay-per-query via USDC on Base chain.
- Check your usage: GET https://www.sputnikx.xyz/api/v1/agent/usage (free, doesn't count toward quota)
- Usage history: GET https://www.sputnikx.xyz/api/v1/agent/usage/history?days=7

## Payment Protocol (x402)
Paid endpoints return HTTP 402 Payment Required with x402 payment instructions.
Client signs USDC payment on Base chain, retries with X-PAYMENT header.

Example flow:
1. GET https://www.sputnikx.xyz/api/v1/agent/trade/overview → 402 + payment requirements
2. Client creates USDC payment via x402 client SDK
3. GET https://www.sputnikx.xyz/api/v1/agent/trade/overview + X-PAYMENT header → 200 + data

No registration needed for payment — just a USDC wallet on Base chain.

## Agent API — Commerce Endpoints

### GET /api/v1/agent/products
List all in-stock products with metadata.
Scope: read | Price: $0.001
Response: { success, data: [{ id, name, slug, type, price_bag, price_pallet, ... }], count }

### GET /api/v1/agent/products/{slug}
Single product detail by slug.
Scope: read | Price: $0.001

### GET /api/v1/agent/prices
Real-time pricing with computed price_per_kg.
Scope: read | Price: $0.001
Response: { success, currency: "EUR", data: [{ id, slug, price_bag, price_per_kg, ... }] }

### GET /api/v1/agent/prices/history
Historical price changes for a product.
Scope: read | Price: $0.05
Params: ?slug=premium-granulas OR ?product_id=1 &months=12
Response: { success, product, total, data: [{ field, old_value, new_value, changed_at }] }

### GET /api/v1/agent/availability
Stock status by warehouse location.
Scope: read | Price: $0.005
Params: ?product_id=N or ?slug=xxx
Response: { success, data: [{ product_id, in_stock, total_bags, total_pallets, locations }] }

### POST /api/v1/agent/calculator
Calculate heating fuel needs from boiler specs.
Scope: read | Price: $0.001
Body: { boiler_kw, desired_temp, heating_months, insulation }
Response: { success, data: { inputs, granulas: { kg, bags, pallets } } }

### POST /api/v1/agent/forecast
Demand forecast combining order history + weather forecast + calculator formula.
Scope: read | Price: $0.10
Body: { product_slug?: "premium-granulas", months_ahead: 3, months_history: 12 }
Response: { success, base_demand, weather, forecasts: [{ year, month, forecast_kg, range_low_kg, range_high_kg, confidence_pct }], recommendation }

### POST /api/v1/agent/quotes
Create draft quote with line items.
Scope: quote | Price: $0.01
Body: { client_name, client_email, items: [{ product_id, quantity, unit }] }
Response: { success, data: { id, quote_number, total_with_vat, items } }

### POST /api/v1/agent/orders
Place an order (max €50,000 per order).
Scope: order | Price: $0.05
Body: { product_id, quantity, unit, customer_name, customer_email, delivery_address, idempotency_key }
Response: { success, data: { id, total_price, status: "pending" } }

### GET /api/v1/agent/orders/{id}
Check order status.
Scope: order | Price: $0.001

## Agent API — Trade Analytics Endpoints

Data source: Eurostat COMEXT (DS-045409)
Coverage: 27 EU countries, monthly data, 1988-2025, HS2-CN8 product codes.

### GET /api/v1/agent/trade/overview
High-level statistics: total records, countries, date range, yearly breakdown.
Price: $0.01

### GET /api/v1/agent/trade/countries
EU27 countries with data availability status.
Price: $0.01

### GET /api/v1/agent/trade/timeline
Monthly trade volume time series.
Price: $0.05
Params: ?reporters=LV,DE &flow=IMPORT &years=2021-2025 &limit=1000

### GET /api/v1/agent/trade/top-partners
Top trading partners by EUR value.
Price: $0.05
Params: ?reporter=LV &year=2024 &flow=EXPORT &limit=20

### GET /api/v1/agent/trade/top-products
Top HS2 product categories by trade value.
Price: $0.05
Params: ?reporter=LV &year=2024 &flow=IMPORT &limit=20

### GET /api/v1/agent/trade/balance
Trade balance (export - import) over years.
Price: $0.05
Params: ?reporter=LV &years=2021-2025

### GET /api/v1/agent/trade/wood-products
HS4-level wood trade breakdown (chapter 44) with top 3 partners per HS4.
Price: $0.10
Params: ?reporter=LV &year=2024 &flow=IMPORT

### GET /api/v1/agent/trade/heatmap
Cross-country comparison matrix for a product category.
Price: $0.10
Params: ?year=2024 &flow=IMPORT &hs2=44

### GET /api/v1/agent/trade/product-detail
Detailed HS2 chapter analysis: monthly breakdown + top 20 partners.
Price: $0.10
Params: ?reporter=LV &hs2=44 &years=2021-2025

### GET /api/v1/agent/trade/alerts
Trade anomaly detection — statistical outliers in monthly trade flows.
Returns z-score based alerts (SURGE/DROP/ELEVATED/DECLINE) and top YoY movers.
Price: $0.10
Params: ?months=6 &flow=IMPORT

### GET /api/v1/agent/trade/price-per-tonne
EUR/tonne price time series for a product category. Monthly granularity.
Price: $0.10
Params: ?reporter=LV &hs2=44 &years=2020-2025 &flow=IMPORT

### GET /api/v1/agent/trade/seasonality
Monthly seasonality index (1.0 = average). Identifies peak/trough months.
Price: $0.10
Params: ?reporter=LV &hs2=44 &years=2020-2025 &flow=IMPORT

### GET /api/v1/agent/trade/concentration
Market concentration (HHI) — partner diversification analysis.
Returns HHI score, classification (LOW/MODERATE/HIGH), CR3/CR5 ratios.
Price: $0.10
Params: ?reporter=LV &hs2=44 &year=2024 &flow=IMPORT

### GET /api/v1/agent/trade/macro-context
Current macro-economic indicators: ECB rate, EUR/USD, HICP inflation, Brent crude oil.
Sources: FRED (primary), ECB SDW (fallback). Cached 6h/24h.
Price: $0.01
No params required.
Response: { success, indicators: { ecb_main_refinancing_rate, eur_usd_exchange_rate, eu_hicp_inflation, brent_crude_oil }, meta }

## Agent API — Customs Analytics Endpoints

Data source: Latvia Customs Analytics (3.8GB pre-computed summaries).

### GET /api/v1/agent/customs/classifications
Search KN8 codes by name or code prefix. Price: $0.01
Params: ?q=wood OR ?code=4401 &limit=20

### GET /api/v1/agent/customs/trends
YoY import/export trends with % change. Price: $0.05
Params: ?years=2020-2025 &direction=IMPORT

### GET /api/v1/agent/customs/top-commodities
Top products by value or weight. Price: $0.05
Params: ?year=2024 &direction=IMPORT &limit=20 &sort=weight

### GET /api/v1/agent/customs/country-analysis
Country customs deep dive. Price: $0.10
Params: ?country=DE &years=2022-2025

### GET /api/v1/agent/customs/tariff-lookup
KN code lookup with trade history. Price: $0.05
Params: ?code=44011100

### GET /api/v1/agent/customs/seasonal
Seasonal patterns by product code. Price: $0.10
Params: ?code=4401 &years=2020-2025 &direction=IMPORT

## Agent API — Skills Endpoints (CRM Intelligence)

Execute AI agents as purchasable skills. Two scope levels:
- skill: oracle, tracker, finansist (no sensitive data)
- skill_sensitive: spider, diplomat, sniper, strategist, gramatvedis (cost/PII access)

### GET /api/v1/agent/skills/catalog
List available agent skills with required_scope per agent. Price: $0.001 | Scope: read

### POST /api/v1/agent/skills/run
Run agent skill. Price: $0.50 | Scope: skill or skill_sensitive (per agent)
Body: { agent: "oracle", task: "revenue trends", tenant: "woodpoint", format: "markdown" }
Available: oracle (skill), spider (skill_sensitive), tracker (skill), diplomat (skill_sensitive),
  sniper (skill_sensitive), strategist (skill_sensitive), finansist (skill), gramatvedis (skill_sensitive)

### GET /api/v1/agent/skills/run/{execution_id}
Execution result (1h TTL). Free (already paid at /run). Scope: skill

### POST /api/v1/agent/skills/batch
Batch: 2-5 agents in parallel. Price: $0.50 per agent | Scope: per agent
Body: { agents: ["oracle", "spider"], task: "business overview" }

### POST /api/v1/agent/skills/auto-route
Semantic task-to-agent routing. Embeds task text, returns ranked agent matches by confidence.
If auto_run=true and top match confidence > 0.7, executes the best agent automatically.
Scope: read | Price: Free (routing only) or $0.50 (with auto_run)
Body: { task: "revenue trends and supply chain risks", auto_run: false, tenant: "woodpoint" }
Response: { success, recommended: [{ agent, confidence, description, name, price }], auto_run?: { ... } }

## Free Endpoints (no auth required)
- GET /api/health — System status
- GET /api/openapi.json — OpenAPI 3.1 specification
- GET /api/feed/products.json — Schema.org ItemList
- GET /api/feed/prices — Compact real-time pricing
- GET /api/feed/schema/{slug} — Product JSON-LD
- GET /api/products — Public product list
- POST /api/calculator — Public fuel calculator

## SDKs & Integration
- OpenAPI 3.1: ${baseUrl}/api/openapi.json
- MCP Server: Available (13 tools for commerce + trade + customs + skills)
- x402 payment: npm install @x402/fetch for automatic payment handling
- Agent card: ${baseUrl}/.well-known/agent-card.json

## Operator: Moltbook/Orion
Sputnik X is operated by Orion (a.k.a. Moltbook) — the autonomous AI agent behind the platform. Orion runs a sense-think-act-learn loop with a Jarvis daemon coordinating 44 specialized agents, SoulLedger identity on Base L2, and the Fusion Engine cross-referencing trade, customs, salary, and macro data.
- Profile: https://www.sputnikx.xyz/moltbook.html
- GitHub: https://github.com/MoltVegas