P0 Agent Economy Index Retention API
The Retention API from P0 Agent Economy Index — 1 operation(s) for retention.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/p0-agent-economy-index:p0-agent-economy-index-retention-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: P0 Agent Economy Index Retention API
version: 0.2.0
x-logo:
url: https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/icon.png
contact:
name: dev Mike (P0)
email: chebotarev.mike@gmail.com
url: https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/join
description: 'An open index of the machine-to-machine (agent) economy. x402 routes: ranked discovery over the live x402 service market, every indexed service scored by real 30-day calls and paying-wallet bounds, with a receipt naming the snapshot hash and scoring revision. /economy routes, for Tempo MPP, Virtuals ACP, Olas, Masumi, ERC-8004 agent registries, Solana agent registries, Base agent contracts and MCP servers (Official MCP Registry): each protocol''s published figures (agent or server counts, transactions or payment events; payers and USD volume only where the source publishes them: payers for x402 and Tempo MPP, USD volume for x402 and Virtuals ACP), each with its unit, window and source; units differ, so totals are not summed. L402 and per-service MPP listings are not covered.'
x-guidance: 'Market data over 25897 listed x402 services, 30-day window. For protocols beyond x402 (Tempo MPP, Virtuals ACP, Olas, Masumi, ERC-8004 agent registries, Solana agent registries, Base agent contracts and MCP servers (Official MCP Registry)) use /economy, /economy/protocols and /economy/search. For x402, start with GET /search?q=<capability> for ranked services, or /top for the highest-demand ones with callsPerPayer (near 1 means each payer bought once, high means repeat use). /price benchmarks what comparable services charge, /networks breaks demand down by chain, /tags is the capability vocabulary, /count is the market totals, /service looks one service up by URL, /report and /alpha are the category report and the underserved niches, /dataset is the full export. Premium: /dataset/pro ($25) is the enriched full export (demand rank overall and within the top tag, per-seller and per-category aggregates) and /report/weekly ($5) the market report; /dataset/teaser is a free 5% sample in the /dataset/pro row schema. EVERY paid route answers a call with no parameters at all with real data rather than an error, so a blind purchase is never wasted. If you transferred the price to payTo in USDC, USDT or DAI on Base without a payment header, just call the route again within 30 minutes and it serves the data (one transfer, one response); other transfers are never matched automatically: claim them with ?tx=<hash> (on /pay/check use ?payment_tx=<hash> instead, since its tx is the transaction being checked) on Base, Ethereum, Arbitrum or Polygon (USDC, USDT, DAI, WETH, cbBTC, WBTC, USDT0 where that chain has the token, or native ETH/POL), ?btc=<txid> (BTC), ?sol=<signature> (SOL, USDC, USDT), ?tron=<txid> (TRX, USDT TRC-20) or ?stx=<txid> (STX, sBTC); a direct transfer on any other chain, or of a token not named here, cannot be claimed. The two premium routes are the exception and serve a plain transfer only when it is claimed with ?tx=<hash>. /sample, /health and /dataset/teaser are free. Payment is x402 v2, scheme exact, networks eip155:8453, eip155:42161, eip155:137 (USDC); stacks:1 (sBTC); eip155:43114, eip155:10, eip155:42220 (USDC via UltravioletaDAO); eip155:42161 (USDT0), eip155:1 (USDC) via UltravioletaDAO, or MPP (method evm, intent charge, USDC on EVM networks, same prices); a plain transfer on Base, Ethereum, Arbitrum or Polygon also works via ?tx=<hash>.'
servers:
- url: https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev
tags:
- name: Retention
paths:
/retention:
get:
summary: 'Use when you need to know whether x402 buyers come back: repeat-payer rate per…'
operationId: retention
parameters: []
security:
- x402: []
- mpp: []
x-payment-info:
protocols:
- x402: {}
- mpp:
method: evm
intent: charge
currency: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
network: eip155:8453
networks: eip155:8453, eip155:42161, eip155:137 (USDC); stacks:1 (sBTC); eip155:43114, eip155:10, eip155:42220 (USDC via UltravioletaDAO); eip155:42161 (USDT0), eip155:1 (USDC) via UltravioletaDAO
asset: USDC
price:
mode: fixed
currency: USD
amount: '0.002'
alternatives:
- assets: USDC, USDT, DAI, ETH, WETH, cbBTC, WBTC
networks: Base, Ethereum, Polygon, Arbitrum
address: '0xECa891e34b3E5873181Fb779672564E198C55354'
- assets: BTC
networks: Bitcoin
address: bc1qqwgyyqv6raq2jnghals2n2aujgwd4e9p64g4hr
- assets: SOL, USDC, USDT
networks: Solana
address: FTbVqWwsfJJ5AuAwNDuCuzdpwCEJahu14HAUgAYcJHuq
- assets: STX, sBTC
networks: Stacks
address: SP34GH04YTB01AMXF4CAQ10Y5B7G4E0119N99W986
- assets: TRX, USDT (TRC20)
networks: TRON
address: TB9rHqT8yLxwdsWCb3zN2nvjc8wLhsUdaQ
responses:
'200':
description: ok
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
required:
- v
- as_of
- generated_at
- labels
- coverage
- rule
- overall
- overall_excluding_loops
- cohorts
- cohorts_excluding_loops
- services
- services_total
- stale
- snapshot_age_s
- source
- source_url
- note
properties:
v:
type: number
as_of:
type: string
generated_at:
type: string
labels:
type: object
properties:
calls_30d:
type: string
invocations: {}
paid_outcome:
type: string
coverage:
type: object
properties:
sources:
type: array
items:
type: string
sellers:
type: number
sellers_with_known_host:
type: number
wallets:
type: number
payments:
type: number
window_from:
type: string
window_to:
type: string
chains:
type: array
items:
type: string
excluded_over_api_max_payments:
type: number
api_price_max_usd:
type: number
rule:
type: object
properties:
repeat:
type: string
same_session_retries:
type: string
loop:
type: string
service:
type: string
overall:
type: object
properties:
pairs:
type: number
repeat_pairs:
type: number
repeat_rate:
type: number
loop_flagged_pairs:
type: number
retries_collapsed:
type: number
overall_excluding_loops:
type: object
properties:
pairs:
type: number
repeat_pairs:
type: number
repeat_rate:
type: number
cohorts:
type: object
properties:
week_1:
type: object
properties:
days:
type: number
eligible_pairs:
type: number
returned_pairs:
type: number
rate:
type: number
note: {}
week_4:
type: object
properties:
days:
type: number
eligible_pairs:
type: number
returned_pairs:
type: number
rate:
type: number
note: {}
week_12:
type: object
properties:
days:
type: number
eligible_pairs:
type: number
returned_pairs:
type: number
rate: {}
note:
type: string
cohorts_excluding_loops:
type: object
properties:
week_1:
type: object
properties:
days:
type: number
eligible_pairs:
type: number
returned_pairs:
type: number
rate:
type: number
note: {}
week_4:
type: object
properties:
days:
type: number
eligible_pairs:
type: number
returned_pairs:
type: number
rate:
type: number
note: {}
week_12:
type: object
properties:
days:
type: number
eligible_pairs:
type: number
returned_pairs:
type: number
rate: {}
note:
type: string
services:
type: array
items:
type: object
properties:
seller:
type: string
host:
type: string
chain:
type: string
payers:
type: number
payments:
type: number
sessions:
type: number
repeat_payers:
type: number
repeat_rate:
type: number
loop_flagged_payers:
type: number
median_payments_per_payer:
type: number
top_wallet_payment_share:
type: number
services_total:
type: number
stale:
type: boolean
snapshot_age_s:
type: number
source:
type: string
source_url:
type: string
note:
type: string
example:
v: 1
as_of: '2026-10-04T18:24:44+00:00'
generated_at: '2026-10-05T00:30:00Z'
labels:
calls_30d: 'calls_30d are paid outcomes: settlements recorded by the CDP facilitator. Unpaid invocations (402 challenges, probes, failed verifies) are not observable in public data, so invocations is null.'
invocations: null
paid_outcome: a facilitator-recorded settlement (catalog calls_30d) or an on-chain transfer to a listed payTo address (scans, not verified as x402 settlements)
coverage:
sources:
- evm_x402_payers
- solana_x402_payers
- stacks_x402_payers
sellers: 458
sellers_with_known_host: 457
wallets: 1418
payments: 14598
window_from: '2026-07-27T12:46:06Z'
window_to: '2026-10-04T19:31:06Z'
chains:
- arbitrum
- base
- polygon
- solana
- stacks
excluded_over_api_max_payments: 1216
api_price_max_usd: 1
rule:
repeat: first and last payment session of a (wallet, service) pair at least 24 h apart
same_session_retries: payments of one pair within 30 min are one session
loop: 4+ sessions at near-constant intervals (cv < 0.15), a service whose only payer is one wallet, or a scanner automation flag
service: one payTo address (seller) on one chain
overall:
pairs: 3287
repeat_pairs: 778
repeat_rate: 0.2367
loop_flagged_pairs: 146
retries_collapsed: 6852
overall_excluding_loops:
pairs: 3141
repeat_pairs: 666
repeat_rate: 0.212
cohorts:
week_1:
days: 7
eligible_pairs: 2391
returned_pairs: 435
rate: 0.1819
note: null
week_4:
days: 28
eligible_pairs: 727
returned_pairs: 228
rate: 0.3136
note: null
week_12:
days: 84
eligible_pairs: 0
returned_pairs: 0
rate: null
note: no pair is old enough in the observed window
cohorts_excluding_loops:
week_1:
days: 7
eligible_pairs: 2304
returned_pairs: 389
rate: 0.1688
note: null
week_4:
days: 28
eligible_pairs: 699
returned_pairs: 209
rate: 0.299
note: null
week_12:
days: 84
eligible_pairs: 0
returned_pairs: 0
rate: null
note: no pair is old enough in the observed window
services:
- seller: '0x0000000000000000000000000000000000000001'
host: api.example-seller.dev
chain: base
payers: 120
payments: 238
sessions: 182
repeat_payers: 27
repeat_rate: 0.225
loop_flagged_payers: 2
median_payments_per_payer: 1
top_wallet_payment_share: 0.0336
services_total: 500
stale: false
snapshot_age_s: 600
source: 'P0 demand metrics: Coinbase CDP x402 Bazaar catalog (public) + P0 on-chain scans of USDC transfers to listed x402 payTo addresses'
source_url: https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources
note: 'Scanner samples, not full wallet histories: repeat rates are lower bounds. Format sample: totals, coverage, cohorts and per-chain rows are our real computation of 2026-10-05; per-tag, per-service and per-pair list entries are illustrative placeholders.'
'402':
description: x402 v2 payment required; nothing is charged when the input is refused
tags:
- Retention
components:
securitySchemes:
x402:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: x402 v2 payment signature; the 402 response tells how
mpp:
type: http
scheme: Payment
description: 'MPP (Machine Payments Protocol) credential, method evm, intent charge: the 402 WWW-Authenticate: Payment challenge tells how'
x-discovery:
protocols:
- x402
- mpp
network: eip155:8453
networks: eip155:8453, eip155:42161, eip155:137 (USDC); stacks:1 (sBTC); eip155:43114, eip155:10, eip155:42220 (USDC via UltravioletaDAO); eip155:42161 (USDT0), eip155:1 (USDC) via UltravioletaDAO
payTo: '0xECa891e34b3E5873181Fb779672564E198C55354'