P0 Agent Economy Index Eu API

openapi: 3.2.0
info:
  title: P0 Agent Economy Index Eu 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: Eu
paths:
  /eu/fx:
    get:
      summary: 'Use for euro exchange rates: the latest ECB euro foreign exchange reference…'
      operationId: eu_fx
      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.001'
        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:
                - base
                - date
                - rates
                - prevDate
                - changeVsPrevPct
                - stale
                - businessDaysOld
                - source
                - sourceUrl
                - note
                - fetchedAt
                properties:
                  base:
                    type: string
                  date:
                    type: string
                  rates:
                    type: object
                    properties:
                      USD:
                        type: number
                      JPY:
                        type: number
                      GBP:
                        type: number
                      CHF:
                        type: number
                      PLN:
                        type: number
                  prevDate:
                    type: string
                  changeVsPrevPct:
                    type: object
                    properties:
                      USD:
                        type: number
                      JPY:
                        type: number
                      GBP:
                        type: number
                      CHF:
                        type: number
                      PLN:
                        type: number
                  stale:
                    type: boolean
                  businessDaysOld:
                    type: number
                  source:
                    type: string
                  sourceUrl:
                    type: string
                  note:
                    type: string
                  fetchedAt:
                    type: string
              example:
                base: EUR
                date: '2026-10-02'
                rates:
                  USD: 1.1225
                  JPY: 176.99
                  GBP: 0.85033
                  CHF: 0.9279
                  PLN: 4.3775
                prevDate: '2026-10-01'
                changeVsPrevPct:
                  USD: -0.6461
                  JPY: -0.8404
                  GBP: -0.3983
                  CHF: -1.6743
                  PLN: 0.0915
                stale: false
                businessDaysOld: 1
                source: ECB euro foreign exchange reference rates
                sourceUrl: https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html
                note: Reference rates published by the European Central Bank for information purposes only; not transaction rates. Usually updated around 16:00 CET on TARGET working days.
                fetchedAt: '2026-10-02T15:31:04Z'
        '402':
          description: x402 v2 payment required; nothing is charged when the input is refused
      tags:
      - Eu
  /eu/fx/history:
    get:
      summary: 'Use for a short euro exchange rate history: daily ECB euro foreign exchange…'
      operationId: eu_fx_history
      parameters:
      - name: ccy
        in: query
        required: false
        description: ISO 4217 currency quoted against EUR, e.g. USD, GBP, JPY
        schema:
          type: string
          default: USD
          pattern: ^[A-Z]{3}$
        example: USD
      - name: days
        in: query
        required: false
        description: calendar days back from the latest ECB publication
        schema:
          type: integer
          minimum: 1
          maximum: 30
          default: 30
        example: 30
      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:
                - base
                - ccy
                - days
                - from
                - to
                - count
                - points
                - min
                - max
                - changePct
                - stale
                - businessDaysOld
                - source
                - sourceUrl
                - note
                properties:
                  base:
                    type: string
                  ccy:
                    type: string
                  days:
                    type: number
                  from:
                    type: string
                  to:
                    type: string
                  count:
                    type: number
                  points:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                        rate:
                          type: number
                  min:
                    type: number
                  max:
                    type: number
                  changePct:
                    type: number
                  stale:
                    type: boolean
                  businessDaysOld:
                    type: number
                  source:
                    type: string
                  sourceUrl:
                    type: string
                  note:
                    type: string
              example:
                base: EUR
                ccy: USD
                days: 3
                from: '2026-09-30'
                to: '2026-10-02'
                count: 3
                points:
                - date: '2026-09-30'
                  rate: 1.1355
                - date: '2026-10-01'
                  rate: 1.1298
                - date: '2026-10-02'
                  rate: 1.1225
                min: 1.1225
                max: 1.1355
                changePct: -1.1449
                stale: false
                businessDaysOld: 1
                source: ECB euro foreign exchange reference rates
                sourceUrl: https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html
                note: Reference rates published by the European Central Bank for information purposes only; not transaction rates. Usually updated around 16:00 CET on TARGET working days.
        '402':
          description: x402 v2 payment required; nothing is charged when the input is refused
      tags:
      - Eu
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'