---
name: spend.crestsystems.ai
description: spend.crestsystems.ai provides two read-only analytics endpoints covering the x402 payment network: one returns aggregate spend metrics for the past 24 hours, and the other returns anomaly detection results including ecosystem health scores and flagged whale transactions. Both endpoints require no inputs and return pre-computed summaries over a rolling window.
host: spend.crestsystems.ai
---

# spend.crestsystems.ai

This host serves agents that need a quick, zero-configuration read on x402 network-wide payment activity. It covers two complementary angles: raw volume and composition metrics (transactions, active services, payers, hourly breakdown) and anomaly-layer analysis (health score, outlier services, whale transactions). It does not expose per-payer, per-transaction, or historical data beyond the fixed 24-hour window.

## When to use this host

Use this host when an agent needs a fast, no-input summary of x402 network-wide payment activity or wants to check for anomalous spending patterns and ecosystem health. It is not suitable for per-transaction lookups, per-payer history, real-time streaming feeds, or any historical window beyond 24 hours — for those needs, route to a transaction-level or time-series data endpoint. If the agent needs price data for specific tokens rather than payment network volume, this host is not appropriate.

## Capabilities

### Network Spend Metrics

Provides aggregate transaction volume, active service and payer counts, top services by revenue, ecosystem composition, and hourly volume breakdown for the past 24 hours.

- **`fetch-spend-overview`** — Returns aggregate spend metrics for the past 24 hours including total transactions, volume, active services, active payers, top services by revenue, ecosystem composition, price distribution, and hourly volume breakdown.

### Anomaly Detection and Health Scoring

Applies learned baselines over a rolling window to surface anomalous services, whale transactions, and an overall ecosystem health score for the x402 network.

- **`fetch-spend-anomalies`** — Returns anomaly detection results for on-chain spending patterns, including ecosystem health score, flagged anomalous services, and whale transactions, using learned baselines over a rolling window.

## Workflows

### Ecosystem Health Triage

*Use when an agent needs to assess whether unusual network conditions are driving observed volume changes — combining baseline metrics with anomaly context.*

1. **`fetch-spend-overview`** — Retrieve current aggregate volume, active services, and top earners to establish the baseline picture of network activity.
2. **`fetch-spend-anomalies`** — Cross-reference the overview data with anomaly detection results to determine whether volume spikes or drops are flagged as outliers and check the ecosystem health score.

## Skill reference

### `fetch-spend-overview`

**Spend Overview** — Returns aggregate spend metrics for the past 24 hours including total transactions, volume, active services, active payers, top services by revenue, ecosystem composition, price distribution, and hourly volume breakdown.

*Use when:* Use when an agent needs a high-level snapshot of x402 payment network activity, such as identifying top-earning services, understanding transaction volume trends, or analyzing ecosystem composition across a 24-hour window.

*Not for:* Do not use for per-payer or per-transaction detail; use a transaction-level or payer-specific endpoint instead. Not suitable for historical periods beyond the fixed 24-hour window.

**Returns:** Returns a 24-hour spend snapshot with aggregate totals (transactions, volume, active services/payers, avg transaction), top 10 services by revenue with ML classifications, ecosystem composition counts, price band distribution, and an hourly volume array.

**Example:** `GET https://spend.crestsystems.ai/api/overview`

---

### `fetch-spend-anomalies`

**Spend Anomaly Detector** — Returns anomaly detection results for on-chain spending patterns, including ecosystem health score, flagged anomalous services, and whale transactions, using learned baselines over a rolling window.

*Use when:* Use when an agent needs to identify unusual or outlier spending activity across services, check ecosystem health, or surface whale transactions within a recent time window (default 24 hours).

*Not for:* Do not use for real-time streaming price feeds or individual transaction lookup; this endpoint returns aggregated anomaly analysis, not per-transaction detail.

**Returns:** Returns a JSON object with detection method, 24-hour period, ecosystem health score, and arrays for services, anomalies, and whale transactions (empty when no activity is present).

**Example:** `GET https://spend.crestsystems.ai/api/anomalies`

---