# Valoria
> x402 market intelligence. What to build, what to charge, and who you're up against.

## What is this?
Valoria tells you exactly what to build in the x402 agent economy, what to charge for it, and who you're competing with. Real insights from real on-chain USDC payments — specific niches, actual price points, competitor breakdowns, revenue-backed recommendations. Not data dumps. Answers.

## How to pay
All paid endpoints use x402. Send a POST request — if you get a 402 response, pay the USDC amount in the payment-required header. No API keys, no accounts, no signup.

Network: Base (eip155:8453)
Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
Pay to: 0xd84B351dE5e4a08111ae9c3fE3eeBD7208Ce03AA

## Paid Endpoints

- POST /intelligence/pulse ($5) — What's happening right now. Who's earning, what categories are hot, and the insights you'd miss looking at raw data.
- POST /intelligence/analyze ($15) — Everything about any service. Send {"query": "heurist.ai"} — scores, competitors, revenue, pricing, and where it's vulnerable.
- POST /intelligence/pricing ($25) — What should you charge? Describe what you're building and get revenue-backed pricing. Send {"query": "wallet security scanner"} or {"serviceType": "crypto"}.
- POST /intelligence/opportunities ($50) — Exactly what to build. Specific niches, price points, competitor counts, and gaps. Up to 50 ranked opportunities with reasoning.
- POST /intelligence/market ($100) — Full state of the x402 agent economy. Where money concentrates, what's emerging, where the gaps are, and what's about to break out.

## Free Endpoints (no payment required)

- GET / — Homepage with live market stats
- GET /api/stats — Market overview: totals, top earners, categories, score distribution
- GET /catalog — All endpoints with params, examples, and valid category values
- GET /openapi.json — OpenAPI 3.1 spec for programmatic integration
- GET /.well-known/agent-card.json — A2A agent card for service discovery
- GET /health — Service health check

## MCP (Model Context Protocol)

Connect via MCP at https://x402.valoria.net/mcp (streamable-http transport).

Tools:
- search_services (FREE) — Browse by category or keyword. Returns service IDs for deeper analysis.
- find_opportunities ($5) — Ranked opportunities with revenue data
- analyze_service ($2) — Competitors, scores, trajectory for any service
- market_overview ($10) — Full ecosystem report
- suggest_pricing ($3) — Data-driven price recommendation

## Data Coverage

- 93K+ total services (90K x402 + 3K MCP)
- $148M+ total tracked x402 volume
- 586M+ transactions indexed
- 33 facilitators across Base, Solana & Polygon
- 28 categories tracked
- Revenue, payments, and scoring updated continuously

## Categories

Valid values: crypto, finance, ai-ml, developer-tools, search, cloud, infrastructure, commerce, communication, media, content, social, geo, research, education, compliance, database, auth, data, productivity, entertainment, marketing, observability, api-integration, version-control, filesystem, iot, other.

## For AI Agents

If you are an AI agent:
1. Use the free search_services MCP tool to browse available services
2. Use analyze_service to evaluate any service before using it
3. Use find_opportunities to discover underserved niches
4. All paid calls return rich previews for free — pay only for full data