Raw schema
{
"type": "object",
"properties": {
"op": {
"type": "string",
"enum": [
"oracle_price",
"price_analytics",
"oracle_health",
"search_registry",
"market_quote",
"check_safety",
"prepare_swap",
"prepare_perp_order"
]
},
"provider": {
"description": "Oracle provider, e.g. chainlink, redstone, api3",
"type": "string"
},
"asset": {
"description": "Asset symbol, e.g. BTC, ETH",
"type": "string",
"minLength": 1,
"maxLength": 20
},
"chain": {
"description": "Optional blockchain filter, e.g. base",
"type": "string"
},
"force_refresh": {
"description": "Bypass cache and re-read upstream",
"type": "boolean"
},
"assets": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 20
},
"description": "Assets to analyse; consensus/risk/history use the first asset"
},
"mode": {
"anyOf": [
{
"default": "consensus",
"description": "consensus = cross-provider price, batch = multi-asset, history = time series",
"type": "string",
"enum": [
"consensus",
"batch",
"history"
]
},
{
"default": "pre_trade",
"description": "Generic oracle gate mode when no family-specific guard applies",
"type": "string",
"enum": [
"pre_trade",
"preflight"
]
}
]
},
"metric": {
"anyOf": [
{
"description": "Deep-analysis metric; overrides mode",
"type": "string",
"enum": [
"spreads",
"deviation",
"correlation",
"risk"
]
},
{
"description": "Optional metric selector; defaults to the scope default",
"type": "string",
"enum": [
"health",
"uptime",
"exposure",
"peg",
"latency",
"anomalies",
"coverage",
"counts",
"report"
]
}
]
},
"providers": {
"anyOf": [
{
"description": "Required for metric=risk; otherwise uses the provider default",
"minItems": 2,
"type": "array",
"items": {
"type": "string"
}
},
{
"description": "Oracle providers to gate on",
"type": "array",
"items": {
"type": "string"
}
}
]
},
"method": {
"description": "Consensus aggregation method",
"type": "string",
"enum": [
"median",
"trimmed_mean",
"weighted_median",
"iqr_filtered"
]
},
"base_chain": {
"description": "Base chain name for metric=spreads",
"type": "string"
},
"from": {
"description": "Start date YYYY-MM-DD",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to": {
"description": "End date YYYY-MM-DD",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"interval": {
"description": "Deviation interval, default 24h",
"type": "string",
"enum": [
"1h",
"6h",
"24h"
]
},
"period_hours": {
"description": "Risk/history hours",
"type": "integer",
"minimum": 1,
"maximum": 8760
},
"scope": {
"default": "ecosystem",
"description": "Which health surface to read",
"type": "string",
"enum": [
"ecosystem",
"feeds",
"feed",
"providers",
"provider",
"protocol",
"asset",
"incidents"
]
},
"subject": {
"description": "Feed UUID, provider, protocol, or asset symbol depending on scope",
"type": "string",
"minLength": 1
},
"period": {
"description": "Period in hours or days",
"type": "integer",
"minimum": 1,
"maximum": 8760
},
"days": {
"description": "Lookback days for rankings/trends",
"type": "integer",
"minimum": 1,
"maximum": 365
},
"date": {
"description": "Report date YYYY-MM-DD",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"category": {
"description": "Feed category filter",
"type": "string",
"enum": [
"crypto",
"stablecoin",
"forex",
"commodity",
"wrapped",
"lst"
]
},
"is_active": {
"description": "Feed active-state filter, default true",
"type": "boolean"
},
"min_severity": {
"type": "string",
"enum": [
"low",
"medium",
"high",
"critical"
]
},
"chain_id": {
"anyOf": [
{
"description": "Chain filter",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
{
"type": "string",
"const": "solana"
},
{
"type": "string",
"const": "hyperliquid"
}
]
},
"limit": {
"anyOf": [
{
"description": "Maximum rows",
"type": "integer",
"minimum": 1,
"maximum": 500
},
{
"description": "Maximum rows",
"type": "integer",
"minimum": 1,
"maximum": 200
}
]
},
"offset": {
"description": "Pagination offset",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"kind": {
"type": "string",
"enum": [
"symbols",
"feeds",
"protocols",
"stablecoins",
"protocol_params",
"rwa_instrument",
"rwa_context",
"settlement_evidence",
"setup_recommendation"
],
"description": "Registry/evidence family to search"
},
"query": {
"description": "Search or lookup term (symbol, protocol, slug)",
"type": "string",
"minLength": 1
},
"verify_onchain": {
"description": "For RWA lookups, cross-check on chain",
"type": "boolean"
},
"venue": {
"anyOf": [
{
"type": "string",
"enum": [
"base_uniswap_v3",
"base_aerodrome",
"base_pancakeswap_v3",
"bnb_pancakeswap_v3",
"base_quickswap_v2",
"base_venue_identity",
"monad_uniswap_v3",
"monad_hanji",
"solana_jupiter",
"hyperliquid_perp"
],
"description": "Reviewed venue to quote"
},
{
"type": "string",
"enum": [
"base_aerodrome_slipstream",
"base_pancakeswap_v3",
"bnb_pancakeswap_v3",
"base_agent_swap",
"solana_loopscale_vault",
"solana_jupiter"
],
"description": "Reviewed execution venue"
}
]
},
"profile_id": {
"description": "Reviewed pool/profile id. PancakeSwap V3: base-pancakeswap-v3-usdc-usdt-100, bnb-pancakeswap-v3-usdt-usdc-100, bnb-pancakeswap-v3-usdt-wbnb-100",
"type": "string",
"minLength": 1
},
"market": {
"description": "Hyperliquid perp market",
"type": "string",
"enum": [
"BTC",
"ETH",
"HYPE"
]
},
"venues": {
"description": "Base venue ids to inspect",
"minItems": 1,
"type": "array",
"items": {
"type": "string"
}
},
"action": {
"type": "string",
"enum": [
"swap",
"borrow",
"repay",
"lend",
"open_perp",
"close_perp",
"check_position",
"check_liquidation",
"vault_deposit"
],
"description": "Trade action being considered"
},
"amount_usd": {
"description": "Trade size in USD",
"type": "number",
"exclusiveMinimum": 0
},
"destination_asset": {
"description": "Destination asset for swaps",
"type": "string",
"minLength": 1,
"maxLength": 20
},
"protocol_id": {
"description": "Lending/protocol id",
"type": "string",
"minLength": 1
},
"market_id": {
"description": "Isolated lending market id when required",
"type": "string",
"minLength": 1
},
"side": {
"description": "Perp side",
"type": "string",
"enum": [
"open_long",
"open_short"
]
},
"margin_asset": {
"type": "string",
"minLength": 1,
"maxLength": 20
},
"margin_value_usd": {
"type": "number",
"exclusiveMinimum": 0
},
"loan_symbol": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 20
},
{
"type": "string",
"minLength": 1
}
]
},
"collateral_value_usd": {
"type": "number",
"exclusiveMinimum": 0
},
"debt_value_usd": {
"type": "number",
"minimum": 0
},
"collateral_symbol": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 20
},
{
"type": "string",
"minLength": 1
}
]
},
"collateral_amount": {
"type": "number",
"exclusiveMinimum": 0
},
"borrow_symbol": {
"type": "string",
"minLength": 1,
"maxLength": 20
},
"borrow_amount": {
"type": "number",
"exclusiveMinimum": 0
},
"collaterals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1
},
"amount": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"symbol",
"amount"
]
}
},
"borrows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1
},
"amount": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"symbol",
"amount"
]
}
},
"position": {
"description": "Position payload for action=check_position",
"type": "object",
"properties": {
"protocol_id": {
"type": "string",
"minLength": 1
},
"collaterals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1
},
"amount": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"symbol",
"amount"
]
}
},
"borrows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string",
"minLength": 1
},
"amount": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"symbol",
"amount"
]
}
},
"collateral_symbol": {
"type": "string",
"minLength": 1,
"maxLength": 20
},
"collateral_amount": {
"type": "number",
"exclusiveMinimum": 0
},
"borrow_symbol": {
"type": "string",
"minLength": 1,
"maxLength": 20
},
"borrow_amount": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
"token_address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"decision_input": {
"description": "Caller decision/quote evidence (old camelCase shape)",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"guard": {
"description": "Exact-call guard input for family-specific exact tools",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"transaction": {
"description": "Exact unsigned transaction for exact-call guards"
},
"order": {
"description": "Exact Hyperliquid order envelope"
},
"reputation_opt_in": {
"type": "boolean"
},
"reputation_agent_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"direction": {
"type": "string",
"enum": [
"token0-to-token1",
"token1-to-token0"
]
},
"amount_in": {
"type": "string",
"minLength": 1,
"description": "Exact input amount as a decimal string"
},
"recipient": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"deadline_unix_seconds": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"max_slippage_bps": {
"type": "integer",
"minimum": 0,
"maximum": 9999
},
"source_decision_price_usd": {
"type": "number",
"exclusiveMinimum": 0
},
"destination_decision_price_usd": {
"type": "number",
"exclusiveMinimum": 0
},
"policy": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"wallet": {
"type": "string",
"minLength": 1
},
"vault": {
"type": "string",
"minLength": 1
},
"asset_mint": {
"type": "string",
"minLength": 1
},
"input_mint": {
"description": "Solana base58 mint sold; required for venue=solana_jupiter",
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$"
},
"output_mint": {
"description": "Solana base58 mint bought; required for venue=solana_jupiter",
"type": "string",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$"
},
"principal_amount": {
"type": "string",
"minLength": 1
},
"min_lp_amount": {
"type": "string",
"minLength": 1
}
},
"required": [
"op"
]
}