{"openapi":"3.1.0","info":{"title":"Liquidation Risk Calculator API","description":"Real-time crypto futures risk assessment using advanced Monte Carlo simulations","version":"1.0.0"},"paths":{"/health":{"get":{"summary":"Health Check","description":"Health check endpoint","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/perp-risk-engine":{"get":{"summary":"Calculate Risk","description":"Calculate liquidation risk probability for leveraged cryptocurrency positions.\n\nUses Monte Carlo simulations with historical price data to assess risk.\nInternal parameters (lookback_hours, simulations, time_steps) are calculated\nautomatically based on the risk_horizon parameter.","operationId":"calculate_risk_api_v1_perp_risk_engine_get","parameters":[{"name":"token_address","in":"query","required":true,"schema":{"type":"string","description":"Solana token address","examples":["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"],"title":"Token Address"},"description":"Solana token address"},{"name":"entry_price","in":"query","required":true,"schema":{"type":"number","exclusiveMinimum":0,"description":"Entry price in USD","examples":[2800],"title":"Entry Price"},"description":"Entry price in USD"},{"name":"leverage","in":"query","required":true,"schema":{"type":"number","maximum":1000,"exclusiveMinimum":0,"description":"Leverage multiplier","examples":[10],"title":"Leverage"},"description":"Leverage multiplier"},{"name":"direction","in":"query","required":true,"schema":{"type":"string","pattern":"^(long|short)$","description":"Position direction","examples":["long"],"title":"Direction"},"description":"Position direction"},{"name":"risk_horizon","in":"query","required":true,"schema":{"type":"string","pattern":"^(1h|1d|1w|1mo)$","description":"Risk time horizon","examples":["1d"],"title":"Risk Horizon"},"description":"Risk time horizon"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskCalculationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/openapi.json":{"get":{"summary":"Get Openapi","description":"Get OpenAPI specification","operationId":"get_openapi_openapi_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"RiskCalculationResponse":{"properties":{"riskProbability":{"type":"number","title":"Riskprobability"},"liquidationPrice":{"type":"number","title":"Liquidationprice"},"entryPrice":{"type":"number","title":"Entryprice"},"volatility":{"type":"number","title":"Volatility"},"drift":{"type":"number","title":"Drift"},"priceChangeNeeded":{"type":"number","title":"Pricechangeneeded"},"sigmasAway":{"type":"number","title":"Sigmasaway"},"simulationDetails":{"$ref":"#/components/schemas/SimulationDetails"},"visualizationData":{"$ref":"#/components/schemas/VisualizationData"}},"type":"object","required":["riskProbability","liquidationPrice","entryPrice","volatility","drift","priceChangeNeeded","sigmasAway","simulationDetails","visualizationData"],"title":"RiskCalculationResponse"},"SimulationDetails":{"properties":{"totalSimulations":{"type":"integer","title":"Totalsimulations"},"liquidatedPaths":{"type":"integer","title":"Liquidatedpaths"},"dataPointsUsed":{"type":"integer","title":"Datapointsused"},"dataInterval":{"type":"string","title":"Datainterval"},"riskHorizon":{"type":"string","title":"Riskhorizon"}},"type":"object","required":["totalSimulations","liquidatedPaths","dataPointsUsed","dataInterval","riskHorizon"],"title":"SimulationDetails"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VisualizationData":{"properties":{"histogram":{"additionalProperties":true,"type":"object","title":"Histogram"},"liquidationThreshold":{"type":"number","title":"Liquidationthreshold"}},"type":"object","required":["histogram","liquidationThreshold"],"title":"VisualizationData"}}}}