AsterPay Discovery API

openapi: 3.2.0
info:
  title: Asterpay Io Discovery API
  version: 3.1.0
  contact:
    name: AsterPay
    url: https://asterpay.io
    email: petteri@asterpay.io
  x-guidance: 'AsterPay is an API for AI agents: Know Your Agent trust scoring, crypto market data, AI text tools, and USDC to EUR settlement (SEPA Instant).


    HOW TO PAY: call any endpoint; an unpaid call returns 402 with an `accepts` array. Pay in USDC on any listed chain (Base, Ethereum, Polygon, Arbitrum, Optimism, SKALE) via x402 (resend with a PAYMENT-SIGNATURE header, SDK @x402/fetch) or MPP (Authorization: Payment, SDK mppx). No API key, no signup.

    FIRST CALL FREE: a wallet that has never paid AsterPay gets its first sub-$0.03 paid call for $0. Send a normally signed payment; it is verified but never settled. Your wallet must still hold the price so your client will sign.


    FREE (no payment): GET /v1/agent/discovery (full catalog), GET /v2/x402/market/rates, POST /v1/ai/fact-check (claim vs supplied source text).


    FREE DAILY QUOTA, then $0.0075 (25 unpaid calls per IP per UTC day; response headers X-Free-Quota-Limit / X-Free-Quota-Remaining):

    - GET /v1/agent/trust-score/{address}: agent trust score 0-100 with breakdown

    - GET /v1/agent/verify/{address}: ERC-8004 identity check

    - GET /v1/agent/tier/{address}: trust tier

    - GET /v1/settlement/estimate?amount={usdc} and GET /v2/x402/offramp/estimate?amount={usdc}: EUR settlement quote


    PAID:

    - GET /v1/agent/deep-analysis/{address} $0.015: behavioral analysis of an agent wallet; POST /v1/agent/trust-score/batch $0.03

    - GET /v1/crypto/token-analysis/{address} $0.15, GET /v1/crypto/wallet-score/{address} $0.075, GET /v1/crypto/whale-alerts $0.03

    - GET /v1/market/price/{symbol} $0.0075, GET /v1/market/ohlcv/{symbol} $0.015, GET /v1/market/trending $0.0075, GET /v2/x402/crypto/prices $0.0075

    - POST /v1/ai/summarize $0.006, POST /v1/ai/sentiment $0.006, POST /v1/ai/translate $0.03, POST /v1/ai/code-review $0.075

    - GET /v2/x402/agent-readiness?url={site} $0.03: agent-readiness scan of any website


    - DATA DOORS (GET /v1/data, free catalog): EU merchant verification GET /v1/data/company/verify/{vatId} $0.05 (VIES + register + LEI, one verdict), company profile $0.015 and change signals $0.03, EU tenders GET /v1/data/tenders/eu/{country}/{cpv} $0.02, plus FX, energy, macro, stablecoins, security and risk feeds from $0.0015.

    WATCHLIST LOOP: tenders and company/signals take ?since=YYYY-MM-DD and return next_since. Poll once a day with the previous next_since and you pay only for new notices or events (e.g. 100 country/CPV keys = $2/day). Recipe: https://x402.asterpay.io/llms.txt#watchlist


    WHEN TO CALL: run company/verify before paying an EU merchant and trust-score before paying an unknown agent; use settlement/estimate to price USDC to EUR before an off-ramp; use market and AI endpoints as pay-per-call utilities.

    Full reference: https://x402.asterpay.io/llms.txt'
  description: 'Operations tagged discovery across 2 of this provider''s published API definitions: asterpay_io_openapi.json, asterpay-io-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://x402.asterpay.io
tags:
- name: Discovery
paths:
  /v1/agent/discovery:
    get:
      operationId: getAgentDiscovery
      summary: Agent Discovery — Free
      description: Complete API discovery with dual-protocol payment info.
      tags:
      - Discovery
      responses:
        '200':
          description: Discovery payload
          content:
            application/json:
              schema:
                type: object
                properties:
                  provider:
                    type: string
                  protocols:
                    type: array
                    items:
                      type: string
                  endpoints:
                    type: object
                required:
                - provider
                - protocols
      security: []
    servers:
    - url: https://x402.asterpay.io
components:
  securitySchemes:
    x402:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: 'x402 (Coinbase CDP) payment. NOT an API key — no credential is issued or registered, and there is nothing to sign up for. On the first request the server returns 402 with a Payment-Required challenge; resend with a PAYMENT-SIGNATURE header carrying the signed USDC (Base) payment payload. SDK: npm i @x402/fetch.'
      x-payment:
        apiKeyRequired: false
        credential: per-request wallet signature
        protocol: x402
    mpp:
      type: http
      scheme: Payment
      description: 'MPP (Machine Payments Protocol) payment. NOT an API key — no credential is issued or registered. On 402 the server returns WWW-Authenticate: Payment; resend with Authorization: Payment <proof> carrying the USDC (Base) transaction proof. SDK: npm i mppx.'
      x-payment:
        protocol: mpp
        apiKeyRequired: false
        credential: per-request on-chain payment proof
x-refined-from:
- asterpay_io_openapi.json
- asterpay-io-openapi.json
x-service-info:
  categories:
  - finance
  - ai
  - data
  - crypto
  - compliance
  docs:
    homepage: https://asterpay.io
    apiReference: https://x402.asterpay.io/docs
    llms: https://x402.asterpay.io/llms.txt
x-discovery:
  ownershipProofs:
  - https://x402.asterpay.io/.well-known/mpp-methods.json
x-payment:
  mode: paid
  protocols:
  - x402
  - mpp
  apiKeyRequired: false
  registrationRequired: false
  currency: USDC
  networks:
  - base
  - ethereum
  - polygon
  - arbitrum
  - optimism
  - skale-base
  note: No API key exists, none is issued, and no account is needed — each paid call carries its own wallet signature or on-chain proof. The x402 scheme is typed apiKey only to declare its custom PAYMENT-SIGNATURE header, which is the header the server actually reads; OpenAPI has no payment type.