> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# x402 Servers

> Server registry mapping x402 payment addresses to service origins and categories

## x402 Servers

Dimensional table mapping x402 server payment addresses to service origins, accepted payment pairs, and service categories. One row per `pay_to_address`. Join to `x402_transfers` to label server activity.

```
crosschain.agents.x402_servers
```

## Columns

| Column           | Type           | Description                                                                                                                                                                                                |
| ---------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| pay\_to\_address | varchar        | Wallet address receiving x402 payments. EVM addresses lowercased; Solana/Tron/Keeta base58 case preserved. Join key to `x402_transfers.to_address`.                                                        |
| primary\_origin  | varchar        | Canonical https origin for the server (e.g. `https://acp-x402.virtuals.io`). Deployment/preview domains deprioritized; placeholder domains excluded. PayAI addresses fall back to `https://payai.network`. |
| accepts          | variant        | Array of distinct `{chain, token_address}` payment pairs. Networks normalized from CAIP-2 via chainlist.                                                                                                   |
| seller\_metadata | variant        | Operator identity from Dexter marketplace: `{displayName, logoUrl, payTo, twitterHandle}`. NULL if not listed.                                                                                             |
| category         | varchar        | Service category. Trusted source label where available; otherwise inferred via AI\_CLASSIFY.                                                                                                               |
| \_updated\_at    | timestamp\_ntz | When this row was last rebuilt.                                                                                                                                                                            |

## Categories

| Category           | Description                                                            |
| ------------------ | ---------------------------------------------------------------------- |
| Analytics          | Market data, financial metrics, on-chain analytics, trading signals    |
| Data               | Data feeds, APIs, indexing, enrichment, information retrieval          |
| DeFi               | Token swaps, lending, yield farming, liquidity pools, staking, bridges |
| Tools              | Developer tools, utilities, SDKs, code execution, contract interaction |
| Infrastructure     | Compute, storage, hosting, networking, RPC nodes, oracles              |
| AI Services        | AI-powered APIs, text generation, analysis, prediction, ML endpoints   |
| Predictions        | Prediction markets, betting, game outcomes, forecasting                |
| Agent Services     | Agent-to-agent communication, agent discovery, agent orchestration     |
| Content Generation | Image, video, audio generation, creative content, media APIs           |
| Identity           | Identity verification, KYC, OSINT, address lookup, reputation scoring  |
| Other              | Services that do not fit other categories                              |

## Data Sources

Server registrations are ingested daily from 6 facilitator discovery APIs (CDP Bazaar, PayAI, Thirdweb, Dexter marketplace, Dexter discovery, x402scout) plus a manually curated seed of known servers not covered by any automated registry.

Categories are determined in two ways:

1. **Trusted source labels** — Dexter marketplace, x402scout, and the manual seed provide pre-mapped categories
2. **AI inference** — remaining servers are classified using Snowflake `AI_CLASSIFY` on primary origin and resource descriptions

## Sample Queries

### Label top servers by volume

```sql theme={null}
SELECT
  COALESCE(s.primary_origin, t.to_address) AS server,
  s.category,
  COUNT(DISTINCT t.transaction_hash) AS transactions,
  SUM(t.usd_amount) AS volume_usd,
  COUNT(DISTINCT t.from_address) AS unique_buyers
FROM crosschain.agents.x402_transfers t
LEFT JOIN crosschain.agents.x402_servers s
  ON t.to_address = s.pay_to_address
WHERE t.block_timestamp >= CURRENT_DATE - INTERVAL '7 days'
GROUP BY 1, 2
ORDER BY volume_usd DESC
LIMIT 20;
```

### Volume breakdown by category

```sql theme={null}
SELECT
  COALESCE(s.category, 'Unlabeled') AS category,
  SUM(t.usd_amount) AS volume_usd,
  COUNT(DISTINCT t.transaction_hash) AS transactions,
  COUNT(DISTINCT t.to_address) AS merchants
FROM crosschain.agents.x402_transfers t
LEFT JOIN crosschain.agents.x402_servers s
  ON t.to_address = s.pay_to_address
WHERE t.block_timestamp >= '2025-10-01'
GROUP BY 1
ORDER BY volume_usd DESC;
```

### Find which chains a server accepts payments on

```sql theme={null}
SELECT
  pay_to_address,
  primary_origin,
  f.value:chain::varchar AS chain,
  f.value:token_address::varchar AS token_address
FROM crosschain.agents.x402_servers,
  LATERAL FLATTEN(input => accepts) f
WHERE primary_origin = 'https://acp-x402.virtuals.io';
```