x402Pulsex402Pulse

x402pulse Public API

Free, open access to x402 payment data on Base mainnet. No API key required. All endpoints return JSON, with CORS open to every origin.

Base URL

Production
https://api.x402pulse.app
Local dev
http://localhost:8000
Free forever

Rate limited to 60 requests/minute per IP. No API key required.

14/14
GET/stats

Headline KPIs

All-time totals plus last-24h activity used by the dashboard stats bar.

curl https://api.x402pulse.app/stats
{
  "total_volume_usdc": 22352.55,
  "total_transactions": 4131,
  "volume_24h_usdc": 18482.36,
  "transactions_24h": 4010,
  "active_agents_24h": 17,
  "active_sellers_24h": 3
}
GET/volume

Bucketed volume series

Time-bucketed USDC volume for the chart. 1h → 1-min buckets, 24h/7d → 1-hour buckets.

Parameters

NameTypeDefaultDescription
period1h | 24h | 7d24hLookback window
curl https://api.x402pulse.app/volume
[
  {
    "timestamp": 1780153200,
    "volume": 387.35,
    "txns": 13
  },
  {
    "timestamp": 1780156800,
    "volume": 636.86,
    "txns": 23
  }
]
GET/agents/leaderboard

Top paying agents

Addresses ranked by total USDC sent to x402 facilitators.

Parameters

NameTypeDefaultDescription
limitint201 ≤ limit ≤ 200
curl https://api.x402pulse.app/agents/leaderboard
[
  {
    "address": "0x13db4caf175f23f1429c2df6b333350c24705192",
    "transactions": 117,
    "volume_usdc": 5375.45,
    "last_seen": 1780346479
  }
]
GET/sellers/leaderboard

Top receiving facilitator addresses

Facilitator deposit addresses ranked by USDC received. Includes facilitator label.

Parameters

NameTypeDefaultDescription
limitint201 ≤ limit ≤ 200
curl https://api.x402pulse.app/sellers/leaderboard
[
  {
    "address": "0x8e7769d440b3460b92159dd9c6d17302b036e2d6",
    "facilitator": "meridian",
    "transactions": 657,
    "volume_usdc": 30905.04,
    "last_seen": 1780348143
  }
]
GET/feed

Latest x402 payments

Newest-first stream of indexed transfers. Used to power the dashboard live feed.

Parameters

NameTypeDefaultDescription
limitint501 ≤ limit ≤ 500
curl https://api.x402pulse.app/feed
[
  {
    "tx_hash": "0x32d0305c0464e13b14b5a32f98cbf91401f5a2a3461491a6c437420f91fbd9a6",
    "block_number": 46686778,
    "timestamp": 1780162903,
    "from_address": "0xb6dbe48513f9ed41b2de29ee89112a52940931e1",
    "to_address": "0x8e7769d440b3460b92159dd9c6d17302b036e2d6",
    "amount_usdc": 40,
    "facilitator": "meridian"
  }
]
GET/alerts

Spike detection

Agents whose last-hour spend exceeds 3× their prior 23-hour hourly average (with a $1 floor + ≥3 prior txns).

curl https://api.x402pulse.app/alerts
[
  {
    "address": "0xb6dbe48513f9ed41b2de29ee89112a52940931e1",
    "last_hour_volume_usdc": 238.57,
    "last_hour_transactions": 7,
    "prior_hourly_avg_usdc": 10.18,
    "multiplier": 23.44
  }
]
GET/health-score

Economy Health Score

Composite 0–100 score (velocity 30%, agents 25%, volume 25%, diversity 20%) with a delta vs. 24h ago.

curl https://api.x402pulse.app/health-score
{
  "score": 78.5,
  "label": "Good",
  "change_24h": 1.1,
  "components": {
    "velocity": {
      "score": 55,
      "txns_1h": 18,
      "txns_prev_1h": 26
    },
    "agents": {
      "score": 100,
      "agents_24h": 17,
      "daily_avg_7d": 5.7
    },
    "volume": {
      "score": 100,
      "volume_24h": 18482.36,
      "volume_prev_24h": 3793.67
    },
    "diversity": {
      "score": 60,
      "active_facilitators_24h": 3
    }
  },
  "weights": {
    "velocity": 0.3,
    "agents": 0.25,
    "volume": 0.25,
    "diversity": 0.2
  },
  "as_of": 1780375048
}
GET/agent/{address}

Full agent profile

All-time totals, 24-bucket hourly activity, facilitators used, last 10 txns, and a single behavior tag (Power user | Batch buyer | Micro-payer | Regular).

Parameters

NameTypeDefaultDescription
address0x… (40 hex)—Lowercase EVM address; 400 on bad format, 404 if never seen.
curl https://api.x402pulse.app/agent/{address}
{
  "address": "0xb6dbe48513f9ed41b2de29ee89112a52940931e1",
  "total_spent_usdc": 3691.45,
  "total_transactions": 24,
  "avg_payment_usdc": 153.81,
  "first_seen": 1780324950,
  "last_seen": 1780346479,
  "favorite_facilitator": "meridian",
  "behavior_tag": "Power user",
  "is_new": true
}
GET/seller/{address}

Full seller profile

Totals, top payers, 24h hourly chart, recent received payments, and the facilitator label for an x402 recipient address.

Parameters

NameTypeDefaultDescription
address0x… (40 hex)—Lowercase EVM address; 400 on bad format, 404 if never seen.
curl https://api.x402pulse.app/seller/{address}
{
  "address": "0x8e7769d440b3460b92159dd9c6d17302b036e2d6",
  "facilitator": "meridian",
  "total_earned_usdc": 17840.1,
  "total_transactions": 364,
  "avg_payment_usdc": 49.01,
  "top_payers": [
    {
      "address": "0xb6dbe48513…",
      "transactions": 24,
      "volume_usdc": 3691.45,
      "last_seen": 1780346479
    }
  ]
}
GET/search

Address search

Partial or full address lookup. Returns matching addresses, classified as agent / seller / both, with txn counts.

Parameters

NameTypeDefaultDescription
qhex string ≥3 chars—Optional 0x prefix; case-insensitive
curl https://api.x402pulse.app/search
{
  "query": "8e7769",
  "matches": [
    {
      "address": "0x8e7769d440b3460b92159dd9c6d17302b036e2d6",
      "kind": "seller",
      "agent_txns": 0,
      "seller_txns": 364,
      "seller_volume": 17840.1,
      "facilitator": "meridian",
      "last_seen": 1780382283
    }
  ]
}
GET/facilitators/stats

Facilitator breakdown

Per-facilitator all-time totals, last-24h volume, % change vs prior 24h, market share, and 24h active agents.

curl https://api.x402pulse.app/facilitators/stats
[
  {
    "name": "meridian",
    "total_volume_usdc": 17053.06,
    "total_transactions": 342,
    "avg_payment_usdc": 49.86,
    "volume_24h": 13414.14,
    "volume_change_pct": 268.6,
    "market_share_pct": 76.29,
    "active_agents_24h": 6
  }
]
GET/score/{address}

Agent Trust Score

FICO-style 0–850 trust score for an agent. Five weighted dimensions (Payment History 35%, Wallet Age 15%, Volume 20%, Consistency 15%, Diversity 15%), with label, letter grade, and percentile rank vs all indexed agents. Returns score = 0 with label 'No x402 Activity' for unseen addresses.

Parameters

NameTypeDefaultDescription
address0x… (40 hex)—Lowercase EVM address; 400 on bad format.
curl https://api.x402pulse.app/score/{address}
{
  "address": "0x13db4caf175f23f1429c2df6b333350c24705192",
  "score": 574,
  "label": "Established",
  "grade": "B",
  "percentile": 50,
  "dimensions": {
    "payment_history": {
      "score": 147,
      "max": 147,
      "detail": "20+ payments recorded"
    },
    "wallet_age": {
      "score": 127,
      "max": 127,
      "detail": "first seen 30+ days ago"
    },
    "volume": {
      "score": 130,
      "max": 170,
      "detail": "$100+ total spent"
    },
    "consistency": {
      "score": 127,
      "max": 127,
      "detail": "active on 10+ different days"
    },
    "diversity": {
      "score": 40,
      "max": 127,
      "detail": "used 1 facilitator"
    }
  },
  "stats": {
    "total_transactions": 1725,
    "total_volume_usdc": 5375.45,
    "first_seen": 1780156313,
    "last_seen": 1780346479,
    "days_active": 29,
    "facilitators_used": [
      "meridian"
    ]
  }
}
GET/score/leaderboard

Top trusted agents

Agents ranked by trust score (then by total volume as a tiebreaker).

Parameters

NameTypeDefaultDescription
limitint201 ≤ limit ≤ 200
curl https://api.x402pulse.app/score/leaderboard
[
  {
    "address": "0x13db4caf175f23f1429c2df6b333350c24705192",
    "score": 574,
    "label": "Established",
    "grade": "B",
    "stats": {
      "total_transactions": 1725,
      "total_volume_usdc": 5375.45,
      "days_active": 29
    }
  }
]
GET/agents/new

New agents (last 24h)

Addresses whose first ever indexed x402 payment occurred in the last 24 hours, with first-tx details and what they've spent since.

curl https://api.x402pulse.app/agents/new
[
  {
    "address": "0xb6dbe48513f9ed41b2de29ee89112a52940931e1",
    "first_seen": 1780324950,
    "first_amount_usdc": 160.89,
    "first_facilitator": "meridian",
    "total_spent_since": 3691.45,
    "tx_count_since": 24
  }
]
← Back to dashboard