{
  "openapi": "3.0.0",
  "info": {
    "title": "SOLIDUS",
    "version": "0.3.0",
    "description": "Multi-asset regime, volatility density, structural-break alerts, and agent trading loops \u2014 sold over x402 on Solana USDC. Validation-minded intelligence for autonomous machines (SIBYL/ADIA/PYTHIA lessons). Protocol: x402 v2 USDC on Solana via PayAI facilitator. payTo receive-only. Every paid body is Ed25519-attested.",
    "contact": {
      "url": "https://solidus-x402.fly.dev"
    },
    "x-solidus": {
      "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "facilitator": "https://facilitator.payai.network"
    }
  },
  "servers": [
    {
      "url": "https://solidus-x402.fly.dev"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "operationId": "getHealth",
        "summary": "Free: liveness + Solana network + payTo ready",
        "security": [],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/catalog": {
      "get": {
        "operationId": "getCatalog",
        "summary": "Free: full SKU list (premium-first)",
        "security": [],
        "responses": {
          "200": {
            "description": "Catalog"
          }
        }
      }
    },
    "/why": {
      "get": {
        "operationId": "getWhy",
        "summary": "Free: why agents pick SOLIDUS",
        "security": [],
        "responses": {
          "200": {
            "description": "Selection argument"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsTxt",
        "summary": "Free: agent payment + SKU instructions",
        "security": [],
        "responses": {
          "200": {
            "description": "plain text"
          }
        }
      }
    },
    "/v1/loop": {
      "get": {
        "operationId": "getLoopMap",
        "summary": "Free: agent loop map (sense / judge / pack)",
        "security": [],
        "responses": {
          "200": {
            "description": "Loop index"
          }
        }
      }
    },
    "/v1/loop/trading/preview": {
      "get": {
        "operationId": "getTradingTickPreview",
        "summary": "Free: SOL trading-tick teaser (regime + action)",
        "security": [],
        "responses": {
          "200": {
            "description": "Free loop teaser"
          }
        }
      }
    },
    "/v1/loop/risk/preview": {
      "get": {
        "operationId": "getRiskRitualPreview",
        "summary": "Free: risk-ritual teaser (verdict + break confidence)",
        "security": [],
        "responses": {
          "200": {
            "description": "Free judge teaser"
          }
        }
      }
    },
    "/v1/gate/presign": {
      "get": {
        "operationId": "get_gate_presign",
        "summary": "Pre-sign gate (mint + fee policy) \u2014 $0.35 USDC Solana x402",
        "description": "Before sign/send: mint hygiene + Solana fee weather + optional owner ATA \u2192 PROCEED|CAUTION|BLOCK. Schema solidus.presign.v1. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.35",
        "x-solidus-amount-atomic": "350000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "350000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/decision": {
      "get": {
        "operationId": "get_decision_loop",
        "summary": "Decision loop (policy brain) \u2014 $0.35 USDC Solana x402",
        "description": "Composed machine policy: regime + structural break + Solana fee weather + risk verdict \u2192 action envelope (halt/size_down/hold). Schema solidus.decision.v1. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.35",
        "x-solidus-amount-atomic": "350000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "350000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/loop/risk": {
      "get": {
        "operationId": "get_loop_risk",
        "summary": "Risk ritual (pre-trade judge) \u2014 $0.30 USDC Solana x402",
        "description": "Before buy/send/sign: regime + break confidence + size gate for autonomous agents. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.30",
        "x-solidus-amount-atomic": "300000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "300000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/bundle/breaks": {
      "get": {
        "operationId": "get_bundle_breaks",
        "summary": "Break swarm (multi-asset) \u2014 $0.28 USDC Solana x402",
        "description": "CUSUM structural-break confidence across BTC ETH SOL XRP BNB in one settle. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.28",
        "x-solidus-amount-atomic": "280000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "280000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/bundle/intel": {
      "get": {
        "operationId": "get_bundle_intel",
        "summary": "Intel pack (flagship) \u2014 $0.25 USDC Solana x402",
        "description": "Multi-asset board + SOL/BTC/ETH ticks + structural breaks in one settle. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.25",
        "x-solidus-amount-atomic": "250000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "250000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/loop/fee": {
      "get": {
        "operationId": "get_loop_fee",
        "summary": "Fee weather (Solana priority fees) \u2014 $0.22 USDC Solana x402",
        "description": "Solana congestion regime from public prioritization fees \u2014 p50\u2013p99, suggest_cu_price, defer_noncritical. Re-hit before each send batch. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.22",
        "x-solidus-amount-atomic": "220000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "220000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/loop/trading": {
      "get": {
        "operationId": "get_loop_trading",
        "summary": "Trading tick (sense loop) \u2014 $0.20 USDC Solana x402",
        "description": "One settle per agent cycle: regime, vol, action hint. Default symbol=SOL. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.20",
        "x-solidus-amount-atomic": "200000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "200000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/sol/mint/{mint}": {
      "get": {
        "operationId": "get_mint_hygiene",
        "summary": "Mint hygiene card \u2014 $0.18 USDC Solana x402",
        "description": "Solana mint authorities, freeze, Token-2022 flags, top-10 holder concentration \u2192 hygiene grade A\u2013F + PROCEED|CAUTION|BLOCK. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.18",
        "x-solidus-amount-atomic": "180000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "180000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/sol/focus": {
      "get": {
        "operationId": "get_sol_focus",
        "summary": "SOL focus pack \u2014 $0.15 USDC Solana x402",
        "description": "Solana-native: SOL tick + break + fee weather + BTC/ETH cross board. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.15",
        "x-solidus-amount-atomic": "150000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "150000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/loop/risk/lite": {
      "get": {
        "operationId": "get_risk_lite",
        "summary": "Risk lite (binary router gate) \u2014 $0.12 USDC Solana x402",
        "description": "ALLOW|DENY binary for agents with low price caps. Full essay on $0.30 risk ritual. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.12",
        "x-solidus-amount-atomic": "120000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "120000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/board": {
      "get": {
        "operationId": "get_board",
        "summary": "Multi-asset regime board \u2014 $0.10 USDC Solana x402",
        "description": "BTC ETH SOL XRP BNB regime + cross-market stress fraction. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.10",
        "x-solidus-amount-atomic": "100000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "100000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/break/SOL": {
      "get": {
        "operationId": "get_break_sol",
        "summary": "SOL structural break alert \u2014 $0.10 USDC Solana x402",
        "description": "Streaming CUSUM+var-ratio break confidence (ADIA lesson) on SOL 5m. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.10",
        "x-solidus-amount-atomic": "100000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "100000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/break/BTC": {
      "get": {
        "operationId": "get_break_btc",
        "summary": "BTC structural break alert \u2014 $0.10 USDC Solana x402",
        "description": "Structural break confidence on BTC 5m. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.10",
        "x-solidus-amount-atomic": "100000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "100000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/break/ETH": {
      "get": {
        "operationId": "get_break_eth",
        "summary": "ETH structural break alert \u2014 $0.10 USDC Solana x402",
        "description": "Structural break confidence on ETH 5m. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.10",
        "x-solidus-amount-atomic": "100000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "100000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/density/SOL": {
      "get": {
        "operationId": "get_density_sol",
        "summary": "SOL vol density \u2014 $0.05 USDC Solana x402",
        "description": "EWMA+HAR vol blend + Student-t quantile hint (SIBYL doctrine, mean 0). Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.05",
        "x-solidus-amount-atomic": "50000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "50000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/density/BTC": {
      "get": {
        "operationId": "get_density_btc",
        "summary": "BTC vol density \u2014 $0.05 USDC Solana x402",
        "description": "Vol density + regime for BTC. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.05",
        "x-solidus-amount-atomic": "50000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "50000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/density/ETH": {
      "get": {
        "operationId": "get_density_eth",
        "summary": "ETH vol density \u2014 $0.05 USDC Solana x402",
        "description": "Vol density + regime for ETH. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.05",
        "x-solidus-amount-atomic": "50000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "50000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/spot/SOL": {
      "get": {
        "operationId": "get_spot_sol",
        "summary": "SOL spot (discovery floor) \u2014 $0.01 USDC Solana x402",
        "description": "SOL spot USD \u2014 crawler entry SKU. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.01",
        "x-solidus-amount-atomic": "10000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "10000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/spot/BTC": {
      "get": {
        "operationId": "get_spot_btc",
        "summary": "BTC spot (discovery floor) \u2014 $0.01 USDC Solana x402",
        "description": "BTC spot USD \u2014 crawler entry. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.01",
        "x-solidus-amount-atomic": "10000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "10000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    },
    "/v1/spot/ETH": {
      "get": {
        "operationId": "get_spot_eth",
        "summary": "ETH spot (discovery floor) \u2014 $0.01 USDC Solana x402",
        "description": "ETH spot USD. Ed25519-signed response. PAYMENT-SIGNATURE required.",
        "responses": {
          "200": {
            "description": "Paid resource + attestation"
          },
          "402": {
            "description": "Payment Required (x402 v2)"
          }
        },
        "x-solidus-price-usd": "0.01",
        "x-solidus-amount-atomic": "10000",
        "x-payment": {
          "protocols": [
            {
              "x402": {
                "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
                "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amountAtomic": "10000",
                "payTo": "8mTdwZCZDPeDhso3iAk2znuuzWWXrq7Cni67WJ6Tc167",
                "scheme": "exact"
              }
            }
          ]
        }
      }
    }
  }
}