# VALORIA
> The discovery layer for the agent economy. Free.

VALORIA indexes 100K+ x402, MCP, and MPP services with real on-chain revenue data ($148M+ tracked on-chain).
Find any service, see what's earning, discover what's trending. Ranked by proof — not by ads.

## Quick Start

Search: GET https://valoria.net/search?q=token+analytics
Feeds:  GET https://valoria.net/api/feeds
Stats:  GET https://valoria.net/api/stats
MCP:    https://valoria.net/mcp  (streamable-http, no auth)

## Free Endpoints

### Search
GET  https://valoria.net/search?q=<query>
POST https://valoria.net/search  {"query": "...", "limit": 20, "type": "x402|mcp", "category": "..."}

Parameters:
- q / query  (required): natural language, keyword, domain name, or category
- limit:      max results, default 20, max 100
- type:       filter by "x402" or "mcp"
- category:   filter by category (analytics, images, data, wallet, etc.)

### Feeds
GET https://valoria.net/api/feeds
Returns: topEarners (highest on-chain revenue), trending (most activity), rising (new growth), hidden (gems)

### Leaderboard
GET https://valoria.net/api/leaderboard?sortBy=revenue&limit=20
Parameters:
- sortBy: "revenue" (default), "payments", or "score"
- type: filter by "x402", "mcp", or "mpp"
- limit: max results, default 20, max 100
Returns: ranked list with rank number, name, url, type, category, score, revenue, payments

### Domain Detail
GET https://valoria.net/api/domain/<domain>
Returns: all endpoints, prices, revenue data, seller info for any indexed domain
Example: GET https://valoria.net/api/domain/api.arvos.xyz

### Stats
GET https://valoria.net/api/stats
Returns: totalServices, totalX402Services, totalMcpServices, totalVolume, totalPayments, totalCategories

### Categories
GET https://valoria.net/api/categories
Returns: all categories for structured browsing with total counts

### Protocols
GET https://valoria.net/api/protocols
Returns: all supported payment protocols (x402, MPP), discovery protocols (MCP, A2A, OpenAPI), and interoperability details

### Health
GET https://valoria.net/health

## MCP Server (free)
Endpoint: https://valoria.net/mcp
Transport: streamable-http
No auth required.

Tools:
- search        — find any x402/MCP service by natural language
- feeds         — top earners, trending, rising, hidden gems
- stats         — economy-wide statistics
- domain-detail — full details on any service (endpoints, prices, revenue, seller)
- try-x402      — probe or pay any x402 endpoint (returns 402 challenge or data)
- try-mpp       — probe or auto-pay any MPP/Tempo endpoint

Client example (TypeScript):
  import { Client } from "@modelcontextprotocol/sdk/client/index.js";
  import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
  const client = new Client({ name: "my-agent", version: "1.0" }, {});
  await client.connect(new StreamableHTTPClientTransport(new URL("https://valoria.net/mcp")));
  const result = await client.callTool("search", { query: "token analytics" });

## Paid Intelligence (x402 + MPP — USDC on Base)

Endpoints accept BOTH x402 and MPP/Tempo payments.
Network:  eip155:8453 (Base mainnet)
Asset:    USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
Pay to:   0xd84B351dE5e4a08111ae9c3fE3eeBD7208Ce03AA

### x402 Payment Flow
1. Make the POST request without payment — server returns 402 with payment-required header
2. Decode the base64 payment-required header to get payment details
3. Send USDC on Base to the payTo address
4. Retry with payment-signature header

### MPP/Tempo Payment Flow
1. Make the POST request — server returns 402 with WWW-Authenticate: MPP header
2. Use mppx SDK or compatible client to open a payment channel and send payment
3. Retry with Authorization header containing MPP credential

Endpoints:
POST https://valoria.net/intelligence/pulse         $1   — real-time market pulse: top earners, hot categories, chain breakdown
POST https://valoria.net/intelligence/analyze       $5   — deep analysis of any service: revenue, percentile, competitors, trajectory
POST https://valoria.net/intelligence/pricing       $10  — data-driven pricing recommendation for your service
POST https://valoria.net/intelligence/opportunities $25  — ranked profitable gaps in the agent economy (up to 50)
POST https://valoria.net/intelligence/market        $50  — full market report: trends, concentration, builder playbook

Request body for /analyze and /pricing:
{"query": "domain.com or what you're building"}

## Intelligence MCP (paid tools via MCP)
Endpoint: https://x402.valoria.net/mcp
Transport: streamable-http
Includes paid intelligence tools accessible via MCP protocol.

## Discovery Files
OpenAPI:    https://valoria.net/openapi.json
Agent Card: https://valoria.net/.well-known/agent-card.json
MCP Card:   https://valoria.net/.well-known/mcp/server-card.json
llms.txt:   https://valoria.net/llms.txt

## Also available at
- https://valoria.net          (primary)
- https://find-agents.com
- https://x402search.net
- https://search.valoria.net
- https://crypto-search.net