> ## 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';
```