{
  "openapi": "3.1.0",
  "info": {
    "title": "Ariadne Nexus — Machine Payments Protocol (MPP) & Sovereign Quant API",
    "description": "Programmatic quantitative valuation, secondary debt surveillance, and forensic sanctions screening for autonomous AI agents via Stripe Machine Payments Protocol (MPP) and HTTP 402.",
    "version": "1.0.0",
    "contact": {
      "name": "Ariadne Nexus Engineering",
      "email": "core@ariadnenexus.com",
      "url": "https://ariadnenexus.com"
    }
  },
  "servers": [
    {
      "url": "https://ariadnenexus.com",
      "description": "Production Sovereign Edge Gateway"
    }
  ],
  "paths": {
    "/api/v1/mpp/valuation": {
      "post": {
        "summary": "Pay-per-call Quantitative Valuation & Jump-Diffusion Analysis",
        "operationId": "getQuantValuation",
        "description": "Computes fair market value, YTM, modified duration, convexity, and jump-diffusion bounds. Requires an HTTP 402 machine payment or Developer API key.",
        "x-payment-info": {
          "protocol": "mpp/1.0",
          "network_id": "acct_1U0DiGBUlDB0w6hX",
          "recipient": "ariadnenexus",
          "amount_usd": 0.50,
          "accepted_methods": ["spt", "tempo_usdc", "base_usdc", "solana_usdc", "api_key"]
        },
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "cusip": { "type": "string", "example": "912828ZG2" },
                  "asset_type": { "type": "string", "example": "CORPORATE_BOND" },
                  "face_value": { "type": "number", "example": 1000000 },
                  "coupon_rate": { "type": "number", "example": 6.25 },
                  "maturity_years": { "type": "number", "example": 5.0 },
                  "market_price": { "type": "number", "example": 93.50 }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Settled valuation memorandum with cryptographic receipt",
            "headers": {
              "Payment-Receipt": {
                "schema": { "type": "string" },
                "description": "Cryptographic receipt identifier"
              }
            }
          },
          "402": {
            "description": "Payment Required challenge containing accepted tokens and network destination"
          }
        }
      }
    },
    "/api/v1/mpp/ofac-screen": {
      "post": {
        "summary": "Pay-per-call Forensic OFAC & Sanctions Screening",
        "operationId": "screenOfacEntity",
        "description": "Performs sub-second fuzzy matching against OFAC SDN and international sanctions registries. Returns statutory proof hash.",
        "x-payment-info": {
          "protocol": "mpp/1.0",
          "network_id": "acct_1U0DiGBUlDB0w6hX",
          "recipient": "ariadnenexus",
          "amount_usd": 0.50,
          "accepted_methods": ["spt", "tempo_usdc", "base_usdc", "solana_usdc", "api_key"]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["entity_name"],
                "properties": {
                  "entity_name": { "type": "string", "example": "Vnesheconombank" },
                  "country": { "type": "string", "example": "US" },
                  "registration_number": { "type": "string", "example": "LEI-1029384756" },
                  "fuzzy_threshold": { "type": "number", "example": 0.85 }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Sanctions screening verdict with statutory proof hash",
            "headers": {
              "Payment-Receipt": { "schema": { "type": "string" } }
            }
          },
          "402": {
            "description": "Payment Required challenge"
          }
        }
      }
    },
    "/api/v1/mpp/debt-radar": {
      "post": {
        "summary": "Pay-per-call FINRA TRACE Secondary Debt Radar & Collar Intelligence",
        "operationId": "getDebtRadar",
        "description": "Retrieves secondary debt tape surveillance metrics, liquidity scores, and European collar risk structuring.",
        "x-payment-info": {
          "protocol": "mpp/1.0",
          "network_id": "acct_1U0DiGBUlDB0w6hX",
          "recipient": "ariadnenexus",
          "amount_usd": 0.50,
          "accepted_methods": ["spt", "tempo_usdc", "base_usdc", "solana_usdc", "api_key"]
        },
        "responses": {
          "200": {
            "description": "Debt surveillance ticket and collar structuring recommendations"
          },
          "402": {
            "description": "Payment Required challenge"
          }
        }
      }
    }
  }
}