DNS://Money System API

openapi: 3.2.0
info:
  title: DNS://Money System API
  description: 'DNS://Money resolves a human-readable `pay:` name into the payment instructions for the rail it settles on, the way DNS resolves a domain into an IP address.


    - **Free reads:** resolve a name without a key at the anonymous rate limit.

    - **API key:** send `X-API-Key` for a higher rate limit. Get a free key at https://dnsofmoney.com/#request.

    - **x402:** paid routes answer `402` with a challenge. Pay from your own wallet and retry with `X-PAYMENT` or `PAYMENT-SIGNATURE`.


    DNS://Money is not a bank. The payer signs from their own wallet and the resolver never holds funds. Guides: https://dnsofmoney.com/docs/.


    **OAuth 2.0:** an agent registers itself at `POST /oauth/register`, sends the key holder through the authorization code flow with PKCE S256, and calls `/resolve` and `/mcp` with a Bearer token. A token is read-only and short lived. It never reaches a route that moves money.'
  termsOfService: https://dnsofmoney.com/terms.html
  contact:
    name: DNS://Money support
    url: https://dnsofmoney.com/docs/
    email: support@dnsofmoney.com
  version: 0.3.0
servers:
- url: https://api.dnsofmoney.com
  description: Production
tags:
- name: System
  description: Service health.
paths:
  /health:
    get:
      summary: Health Check
      operationId: health_check_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
              example:
                db: true
                redis: true
                status: ok
                xrpl_mode: mainnet
                xrpl_rpc:
                  fallbacks: '2'
                  host: s2.ripple.com
                  provider: public
          headers: {}
      tags:
      - System
      description: Return the service status and the state of Redis and the XRPL node.
      security: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key.
    X402Payment:
      type: apiKey
      in: header
      name: X-PAYMENT
      description: x402 v1 payment payload. Answer the 402 challenge with this header.
    X402PaymentSignature:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: x402 v2 payment payload. Answer the 402 challenge with this header.
    XappBearer:
      type: http
      scheme: bearer
      description: Session JWT from POST /xapp/ott.
    AdminKey:
      type: apiKey
      in: header
      name: x-admin-key
      description: Operator key.
    OAuth2:
      type: oauth2
      description: Read-only delegated access. PKCE S256 is required.
      flows:
        authorizationCode:
          authorizationUrl: https://api.dnsofmoney.com/oauth/authorize
          tokenUrl: https://api.dnsofmoney.com/oauth/token
          scopes:
            resolve:read: 'Resolve pay: names and call the read-only MCP tools.'
x-provenance:
  method: harvested
  publisher: DNS://Money
  source: https://api.dnsofmoney.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)