{"openapi":"3.1.0","info":{"title":"GalaxySwap Backend API","version":"0.1.0","description":"Reader API for the GalaxySwap SQLite projection built from Midnight indexer data."},"components":{"schemas":{}},"paths":{"/health":{"get":{"summary":"Check whether the reader API process is up.","tags":["System"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["ok"]}},"required":["status"]}}}}}}},"/v1/sync-status":{"get":{"summary":"Read the latest persisted sync cursor for the configured contract.","tags":["System"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"cursor":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"lastBlockHeight":{"anyOf":[{"type":"integer"},{"type":"null"}]},"lastBlockHash":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"lastIndexerTxId":{"anyOf":[{"type":"integer"},{"type":"null"}]},"lastTxId":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]+$"},{"type":"null"}]},"lastTxHash":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"lastSeenTimestamp":{"anyOf":[{"type":"integer"},{"type":"null"}]},"status":{"type":"string","enum":["running","idle","error"]},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string","format":"date-time"}},"required":["networkId","contractAddress","lastBlockHeight","lastBlockHash","lastIndexerTxId","lastTxId","lastTxHash","lastSeenTimestamp","status","lastError","updatedAt"]},{"type":"null"}]}},"required":["networkId","contractAddress","cursor"]}}}}}}},"/v1/pools":{"get":{"summary":"List the latest known pool states.","tags":["Pools"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"pools":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["shielded","unshielded","mixed","stableUnshielded"]},"liquidityBalanceSource":{"type":"string","enum":["shielded","unshielded"]},"liquidityManagementMode":{"type":"string","enum":["batched","direct"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"lpToken":{"type":"string","pattern":"^[0-9a-f]{64}$"},"reserveAId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"reserveBId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"feeLevel":{"type":"integer","minimum":0},"feeNumerator":{"type":"string","pattern":"^[0-9]+$"},"ampFactor":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"reserveA":{"type":"string","pattern":"^[0-9]+$"},"reserveB":{"type":"string","pattern":"^[0-9]+$"},"accruedAdminFeeA":{"type":"string","pattern":"^[0-9]+$"},"accruedAdminFeeB":{"type":"string","pattern":"^[0-9]+$"},"lpTokenTotalSupply":{"type":"string","pattern":"^[0-9]+$"},"lastUpdatedBlockHeight":{"type":"integer"},"lastUpdatedBlockHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"lastUpdatedTxId":{"type":"string","pattern":"^[0-9a-f]+$"},"lastUpdatedTxHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"lastUpdatedAt":{"type":"string","format":"date-time"}},"required":["poolId","poolType","liquidityBalanceSource","liquidityManagementMode","tokenA","tokenB","lpToken","reserveAId","reserveBId","feeLevel","feeNumerator","ampFactor","reserveA","reserveB","accruedAdminFeeA","accruedAdminFeeB","lpTokenTotalSupply","lastUpdatedBlockHeight","lastUpdatedBlockHash","lastUpdatedTxId","lastUpdatedTxHash","lastUpdatedAt"]}}},"required":["networkId","contractAddress","pools"]}}}}}}},"/v1/pool-fee-tiers":{"get":{"summary":"List the configured pool fee tiers from the latest projected contract state.","tags":["Pools"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"feeTiers":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"feeLevel":{"type":"integer","minimum":0},"feeNumerator":{"type":"string","pattern":"^[0-9]+$"},"feeBps":{"type":"number","minimum":0}},"required":["feeLevel","feeNumerator","feeBps"]}}},"required":["networkId","contractAddress","feeTiers"]}}}}}}},"/v1/wallet/pool-lp-balances":{"get":{"summary":"List cached wallet LP balances for unshielded and stable pools.","tags":["Pools"],"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"walletPublicKey","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"balances":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"lpBalance":{"type":"string","pattern":"^[0-9]+$"}},"required":["poolId","lpBalance"]}}},"required":["networkId","contractAddress","balances"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}}}}},"/v1/wallet/action-log":{"get":{"summary":"List raw wallet actions for external rewards dashboards.","tags":["Rewards"],"description":"Returns observed wallet actions from the last 10 days by default; reward and XP scoring belongs outside this API. Specific txId filters bypass the time window.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"address","required":true},{"schema":{"anyOf":[{"type":"string","minLength":1},{"type":"array","items":{"type":"string","minLength":1}}]},"in":"query","name":"txId","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"walletAddress":{"type":"string"},"actions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"actionId":{"type":"string","minLength":1},"actionType":{"type":"string","enum":["swap","liquidityDeposit","liquidityWithdraw","liquidityPoolCreation"]},"source":{"type":"string","enum":["directUnshieldedRequestHistory"]},"txId":{"type":"string","minLength":1},"txHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"blockHeight":{"type":"integer"},"timestamp":{"type":"string","format":"date-time"},"requestType":{"type":"string","enum":["swap","liquidity"]},"liquidityAction":{"anyOf":[{"type":"string","enum":["deposit","withdraw","liquidityPoolCreation"]},{"type":"null"}]},"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["unshielded","mixed","stableUnshielded"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"lpToken":{"type":"string","pattern":"^[0-9a-f]{64}$"},"sellToken":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"buyToken":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"amountIn":{"type":"string","pattern":"^[0-9]+$"},"amountInSecondary":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"amountOut":{"type":"string","pattern":"^[0-9]+$"},"amountOutSecondary":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]}},"required":["actionId","actionType","source","txId","txHash","blockHeight","timestamp","requestType","liquidityAction","poolId","poolType","tokenA","tokenB","lpToken","sellToken","buyToken","amountIn","amountInSecondary","amountOut","amountOutSecondary"]}}},"required":["networkId","contractAddress","walletAddress","actions"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}}}}},"/v1/testnet/tasks/leaderboard":{"get":{"summary":"Rank wallet addresses by GalaxySwap testnet task activity.","tags":["Rewards"],"description":"Returns an all-time testnet task score leaderboard, with each task scored up to its daily max per UTC day. This score is separate from rewards XP and excludes social tasks.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"address","required":false},{"schema":{"type":"integer","minimum":1,"maximum":10000},"in":"query","name":"limit","required":false},{"schema":{"type":"integer","minimum":0,"maximum":50},"in":"query","name":"nearbyLimit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"asOf":{"type":"string","format":"date-time"},"walletAddress":{"type":"string"},"taskDefinitions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","enum":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"label":{"type":"string","minLength":1},"actionType":{"type":"string","enum":["swap","liquidityDeposit","liquidityWithdraw","liquidityPoolCreation"]},"dailyMax":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}]},"scorePerCompletion":{"type":"integer","minimum":0}},"required":["id","label","actionType","dailyMax","scorePerCompletion"]}},"participantCount":{"type":"integer","minimum":0},"totalTaskCompletions":{"type":"integer","minimum":0},"wallet":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"rank":{"type":"integer","minimum":1},"address":{"type":"string","minLength":1},"taskScore":{"type":"integer","minimum":0},"totalCompletions":{"type":"integer","minimum":0},"taskCounts":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"type":"integer","minimum":0},"shieldedOrMixedSwap":{"type":"integer","minimum":0},"addLiquidity":{"type":"integer","minimum":0},"removeLiquidity":{"type":"integer","minimum":0},"createPool":{"type":"integer","minimum":0}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"taskDailyCounts":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"type":"integer","minimum":0},"shieldedOrMixedSwap":{"type":"integer","minimum":0},"addLiquidity":{"type":"integer","minimum":0},"removeLiquidity":{"type":"integer","minimum":0},"createPool":{"type":"integer","minimum":0}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"taskLatestActions":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"shieldedOrMixedSwap":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"addLiquidity":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"removeLiquidity":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"createPool":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"latestActionAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["rank","address","taskScore","totalCompletions","taskCounts","taskDailyCounts","taskLatestActions","latestActionAt"]},{"type":"null"}]},"leaders":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"rank":{"type":"integer","minimum":1},"address":{"type":"string","minLength":1},"taskScore":{"type":"integer","minimum":0},"totalCompletions":{"type":"integer","minimum":0},"taskCounts":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"type":"integer","minimum":0},"shieldedOrMixedSwap":{"type":"integer","minimum":0},"addLiquidity":{"type":"integer","minimum":0},"removeLiquidity":{"type":"integer","minimum":0},"createPool":{"type":"integer","minimum":0}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"taskDailyCounts":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"type":"integer","minimum":0},"shieldedOrMixedSwap":{"type":"integer","minimum":0},"addLiquidity":{"type":"integer","minimum":0},"removeLiquidity":{"type":"integer","minimum":0},"createPool":{"type":"integer","minimum":0}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"taskLatestActions":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"shieldedOrMixedSwap":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"addLiquidity":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"removeLiquidity":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"createPool":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"latestActionAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["rank","address","taskScore","totalCompletions","taskCounts","taskDailyCounts","taskLatestActions","latestActionAt"]}},"tradeLeaders":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"rank":{"type":"integer","minimum":1},"address":{"type":"string","minLength":1},"taskScore":{"type":"integer","minimum":0},"totalCompletions":{"type":"integer","minimum":0},"taskCounts":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"type":"integer","minimum":0},"shieldedOrMixedSwap":{"type":"integer","minimum":0},"addLiquidity":{"type":"integer","minimum":0},"removeLiquidity":{"type":"integer","minimum":0},"createPool":{"type":"integer","minimum":0}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"taskDailyCounts":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"type":"integer","minimum":0},"shieldedOrMixedSwap":{"type":"integer","minimum":0},"addLiquidity":{"type":"integer","minimum":0},"removeLiquidity":{"type":"integer","minimum":0},"createPool":{"type":"integer","minimum":0}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"taskLatestActions":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"shieldedOrMixedSwap":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"addLiquidity":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"removeLiquidity":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"createPool":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"latestActionAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["rank","address","taskScore","totalCompletions","taskCounts","taskDailyCounts","taskLatestActions","latestActionAt"]}},"nearby":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"rank":{"type":"integer","minimum":1},"address":{"type":"string","minLength":1},"taskScore":{"type":"integer","minimum":0},"totalCompletions":{"type":"integer","minimum":0},"taskCounts":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"type":"integer","minimum":0},"shieldedOrMixedSwap":{"type":"integer","minimum":0},"addLiquidity":{"type":"integer","minimum":0},"removeLiquidity":{"type":"integer","minimum":0},"createPool":{"type":"integer","minimum":0}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"taskDailyCounts":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"type":"integer","minimum":0},"shieldedOrMixedSwap":{"type":"integer","minimum":0},"addLiquidity":{"type":"integer","minimum":0},"removeLiquidity":{"type":"integer","minimum":0},"createPool":{"type":"integer","minimum":0}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"taskLatestActions":{"type":"object","additionalProperties":false,"properties":{"unshieldedSwap":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"shieldedOrMixedSwap":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"addLiquidity":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"removeLiquidity":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"createPool":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["unshieldedSwap","shieldedOrMixedSwap","addLiquidity","removeLiquidity","createPool"]},"latestActionAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["rank","address","taskScore","totalCompletions","taskCounts","taskDailyCounts","taskLatestActions","latestActionAt"]}}},"required":["networkId","contractAddress","asOf","walletAddress","taskDefinitions","participantCount","totalTaskCompletions","wallet","leaders","tradeLeaders","nearby"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}}}}},"/v1/analytics/pools":{"get":{"summary":"List aggregate pool analytics derived from historical reserve changes.","tags":["Analytics"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"pools":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["shielded","unshielded","mixed","stableUnshielded"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tvl":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"volume24h":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"cumulativeVolume":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"lastTradeAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["poolId","poolType","tokenA","tokenB","tvl","volume24h","cumulativeVolume","lastTradeAt"]}}},"required":["networkId","contractAddress","pools"]}}}}}}},"/v1/analytics/pools/{poolId}":{"get":{"summary":"Read aggregate TVL and volume metrics for a single pool.","tags":["Analytics"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"poolId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"pool":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["shielded","unshielded","mixed","stableUnshielded"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tvl":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"volume24h":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"cumulativeVolume":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"lastTradeAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["poolId","poolType","tokenA","tokenB","tvl","volume24h","cumulativeVolume","lastTradeAt"]}},"required":["networkId","contractAddress","pool"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/analytics/pools/{poolId}/price-chart":{"get":{"summary":"Read bucketed real trade-price history and volume for a single pool.","tags":["Analytics"],"parameters":[{"schema":{"type":"string","enum":["24H","7D","30D"]},"in":"query","name":"timeFrame","required":false},{"schema":{"type":"string"},"in":"path","name":"poolId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"chart":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["shielded","unshielded","mixed","stableUnshielded"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"asOf":{"type":"string","format":"date-time"},"timeFrame":{"type":"string","enum":["24H","7D","30D"]},"points":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"closePriceTokenA":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"closePriceTokenB":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"volumeTokenA":{"type":"string","pattern":"^[0-9]+$"},"volumeTokenB":{"type":"string","pattern":"^[0-9]+$"},"tradeCount":{"type":"integer","minimum":0}},"required":["startTime","endTime","closePriceTokenA","closePriceTokenB","volumeTokenA","volumeTokenB","tradeCount"]}}},"required":["poolId","poolType","tokenA","tokenB","asOf","timeFrame","points"]}},"required":["networkId","contractAddress","chart"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/analytics/pools/{poolId}/overview":{"get":{"summary":"Read bucketed TVL, volume, and fee analytics for a single pool.","tags":["Analytics"],"parameters":[{"schema":{"type":"string","enum":["24H","7D","30D"]},"in":"query","name":"timeFrame","required":false},{"schema":{"type":"string"},"in":"path","name":"poolId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"overview":{"type":"object","additionalProperties":false,"properties":{"pool":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["shielded","unshielded","mixed","stableUnshielded"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tvl":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"volume24h":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"cumulativeVolume":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"lastTradeAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["poolId","poolType","tokenA","tokenB","tvl","volume24h","cumulativeVolume","lastTradeAt"]},"feeBps":{"type":"integer","minimum":0,"maximum":10000},"asOf":{"type":"string","format":"date-time"},"timeFrame":{"type":"string","enum":["24H","7D","30D"]},"buckets":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"tvl":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"volume":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"feesEarned":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"tradeCount":{"type":"integer","minimum":0}},"required":["startTime","endTime","tvl","volume","feesEarned","tradeCount"]}},"limitations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"reason":{"type":"string"}},"required":["title","reason"]}}},"required":["pool","feeBps","asOf","timeFrame","buckets","limitations"]}},"required":["networkId","contractAddress","overview"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/analytics/pools/{poolId}/trades":{"get":{"summary":"List visible or inferred trades against a single pool.","tags":["Analytics"],"parameters":[{"schema":{"anyOf":[{"type":"integer","minimum":1,"maximum":100},{"type":"string","pattern":"^[1-9][0-9]?$|^100$"}]},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"path","name":"poolId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"asOf":{"type":"string","format":"date-time"},"trades":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["shielded","unshielded","mixed","stableUnshielded"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"walletAddress":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"walletAddressVisibility":{"type":"string","enum":["public","unavailable","private"]},"feeBps":{"type":"integer","minimum":0,"maximum":10000},"timestamp":{"type":"string","format":"date-time"},"blockHeight":{"type":"integer","minimum":0},"txId":{"type":"string","minLength":1},"txHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amountTokenA":{"type":"string","pattern":"^[0-9]+$"},"amountTokenB":{"type":"string","pattern":"^[0-9]+$"},"feeTokenA":{"type":"string","pattern":"^[0-9]+$"},"feeTokenB":{"type":"string","pattern":"^[0-9]+$"},"inputToken":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"outputToken":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"visibility":{"type":"string","enum":["public","inferred"]}},"required":["poolId","poolType","tokenA","tokenB","walletAddress","walletAddressVisibility","feeBps","timestamp","blockHeight","txId","txHash","amountTokenA","amountTokenB","feeTokenA","feeTokenB","inputToken","outputToken","visibility"]}}},"required":["networkId","contractAddress","poolId","asOf","trades"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/analytics/trades":{"get":{"summary":"List the latest visible or inferred trades across all pools.","tags":["Analytics"],"parameters":[{"schema":{"anyOf":[{"type":"integer","minimum":1,"maximum":100},{"type":"string","pattern":"^[1-9][0-9]?$|^100$"}]},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"asOf":{"type":"string","format":"date-time"},"trades":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["shielded","unshielded","mixed","stableUnshielded"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"walletAddress":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"walletAddressVisibility":{"type":"string","enum":["public","unavailable","private"]},"feeBps":{"type":"integer","minimum":0,"maximum":10000},"timestamp":{"type":"string","format":"date-time"},"blockHeight":{"type":"integer","minimum":0},"txId":{"type":"string","minLength":1},"txHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amountTokenA":{"type":"string","pattern":"^[0-9]+$"},"amountTokenB":{"type":"string","pattern":"^[0-9]+$"},"feeTokenA":{"type":"string","pattern":"^[0-9]+$"},"feeTokenB":{"type":"string","pattern":"^[0-9]+$"},"inputToken":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"outputToken":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"visibility":{"type":"string","enum":["public","inferred"]}},"required":["poolId","poolType","tokenA","tokenB","walletAddress","walletAddressVisibility","feeBps","timestamp","blockHeight","txId","txHash","amountTokenA","amountTokenB","feeTokenA","feeTokenB","inputToken","outputToken","visibility"]}}},"required":["networkId","contractAddress","asOf","trades"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}}}}},"/v1/analytics/tokens":{"get":{"summary":"List aggregate per-token trade volume derived from pool history.","tags":["Analytics"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokens":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenSource":{"type":"string","enum":["shielded","unshielded"]},"liquidity":{"type":"string","pattern":"^[0-9]+$"},"volume24h":{"type":"string","pattern":"^[0-9]+$"},"cumulativeVolume":{"type":"string","pattern":"^[0-9]+$"},"poolCount":{"type":"integer","minimum":0},"priceChange24hBps":{"anyOf":[{"type":"integer"},{"type":"null"}]},"lastTradeAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["tokenType","tokenSource","liquidity","volume24h","cumulativeVolume","poolCount","priceChange24hBps","lastTradeAt"]}}},"required":["networkId","contractAddress","tokens"]}}}}}}},"/v1/analytics/overview":{"get":{"summary":"Read live protocol analytics for the selected time frame, including TVL token breakdowns and trade counts.","tags":["Analytics"],"parameters":[{"schema":{"type":"string","enum":["24H","7D","30D"]},"in":"query","name":"timeFrame","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"asOf":{"type":"string","format":"date-time"},"timeFrame":{"type":"string","enum":["24H","7D","30D"]},"currentTvl":{"type":"object","additionalProperties":false,"properties":{"byPoolType":{"type":"object","additionalProperties":false,"properties":{"shielded":{"type":"object","additionalProperties":false,"properties":{"poolCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["poolCount","tokenTotals"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"poolCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["poolCount","tokenTotals"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"poolCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["poolCount","tokenTotals"]},"stableUnshielded":{"type":"object","additionalProperties":false,"properties":{"poolCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["poolCount","tokenTotals"]}},"required":["shielded","unshielded","mixed","stableUnshielded"]},"byPoolFamily":{"type":"object","additionalProperties":false,"properties":{"shielded":{"type":"object","additionalProperties":false,"properties":{"poolCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["poolCount","tokenTotals"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"poolCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["poolCount","tokenTotals"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"poolCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["poolCount","tokenTotals"]},"total":{"type":"object","additionalProperties":false,"properties":{"poolCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["poolCount","tokenTotals"]}},"required":["shielded","unshielded","mixed","total"]}},"required":["byPoolType","byPoolFamily"]},"estimatedTvl":{"type":"object","additionalProperties":false,"properties":{"quoteTokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"current":{"type":"object","additionalProperties":false,"properties":{"shielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedPoolCount":{"type":"integer","minimum":0},"totalPoolCount":{"type":"integer","minimum":0}},"required":["amount","pricedPoolCount","totalPoolCount"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedPoolCount":{"type":"integer","minimum":0},"totalPoolCount":{"type":"integer","minimum":0}},"required":["amount","pricedPoolCount","totalPoolCount"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedPoolCount":{"type":"integer","minimum":0},"totalPoolCount":{"type":"integer","minimum":0}},"required":["amount","pricedPoolCount","totalPoolCount"]},"total":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedPoolCount":{"type":"integer","minimum":0},"totalPoolCount":{"type":"integer","minimum":0}},"required":["amount","pricedPoolCount","totalPoolCount"]}},"required":["shielded","unshielded","mixed","total"]},"buckets":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"total":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedPoolCount":{"type":"integer","minimum":0},"totalPoolCount":{"type":"integer","minimum":0}},"required":["amount","pricedPoolCount","totalPoolCount"]},"shielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedPoolCount":{"type":"integer","minimum":0},"totalPoolCount":{"type":"integer","minimum":0}},"required":["amount","pricedPoolCount","totalPoolCount"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedPoolCount":{"type":"integer","minimum":0},"totalPoolCount":{"type":"integer","minimum":0}},"required":["amount","pricedPoolCount","totalPoolCount"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedPoolCount":{"type":"integer","minimum":0},"totalPoolCount":{"type":"integer","minimum":0}},"required":["amount","pricedPoolCount","totalPoolCount"]}},"required":["startTime","endTime","total","shielded","unshielded","mixed"]}}},"required":["quoteTokenType","current","buckets"]},"estimatedVolume":{"type":"object","additionalProperties":false,"properties":{"quoteTokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"selectedTimeFrame":{"type":"object","additionalProperties":false,"properties":{"total":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"shielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]}},"required":["total","shielded","unshielded","mixed"]},"last24h":{"type":"object","additionalProperties":false,"properties":{"total":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"shielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]}},"required":["total","shielded","unshielded","mixed"]},"cumulative":{"type":"object","additionalProperties":false,"properties":{"total":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"shielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]}},"required":["total","shielded","unshielded","mixed"]},"buckets":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"total":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"shielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"string","pattern":"^[0-9]+$"},"pricedTradeCount":{"type":"integer","minimum":0},"totalTradeCount":{"type":"integer","minimum":0}},"required":["amount","pricedTradeCount","totalTradeCount"]}},"required":["startTime","endTime","total","shielded","unshielded","mixed"]}}},"required":["quoteTokenType","selectedTimeFrame","last24h","cumulative","buckets"]},"tradeVolume":{"type":"object","additionalProperties":false,"properties":{"selectedTimeFrame":{"type":"object","additionalProperties":false,"properties":{"total":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]},"shielded":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]}},"required":["total","shielded","unshielded","mixed"]},"last24h":{"type":"object","additionalProperties":false,"properties":{"total":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]},"shielded":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]}},"required":["total","shielded","unshielded","mixed"]},"cumulative":{"type":"object","additionalProperties":false,"properties":{"total":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]},"shielded":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]},"unshielded":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]},"mixed":{"type":"object","additionalProperties":false,"properties":{"tradeCount":{"type":"integer","minimum":0},"tokenTotals":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amount":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenType","amount"]}}},"required":["tradeCount","tokenTotals"]}},"required":["total","shielded","unshielded","mixed"]},"lastTradeAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"buckets":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"tradeCount":{"type":"integer","minimum":0},"shieldedTradeCount":{"type":"integer","minimum":0},"unshieldedTradeCount":{"type":"integer","minimum":0},"mixedTradeCount":{"type":"integer","minimum":0}},"required":["startTime","endTime","tradeCount","shieldedTradeCount","unshieldedTradeCount","mixedTradeCount"]}}},"required":["selectedTimeFrame","last24h","cumulative","lastTradeAt","buckets"]},"limitations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"reason":{"type":"string"}},"required":["title","reason"]}}},"required":["networkId","contractAddress","asOf","timeFrame","currentTvl","estimatedTvl","estimatedVolume","tradeVolume","limitations"]}}}}}}},"/v1/analytics/tokens/{tokenType}":{"get":{"summary":"Read aggregate liquidity, volume, and price-change metrics for a single token.","tags":["Analytics"],"parameters":[{"schema":{"type":"string","enum":["shielded","unshielded"]},"in":"query","name":"source","required":true},{"schema":{"type":"string"},"in":"path","name":"tokenType","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"token":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenSource":{"type":"string","enum":["shielded","unshielded"]},"liquidity":{"type":"string","pattern":"^[0-9]+$"},"volume24h":{"type":"string","pattern":"^[0-9]+$"},"cumulativeVolume":{"type":"string","pattern":"^[0-9]+$"},"poolCount":{"type":"integer","minimum":0},"priceChange24hBps":{"anyOf":[{"type":"integer"},{"type":"null"}]},"lastTradeAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["tokenType","tokenSource","liquidity","volume24h","cumulativeVolume","poolCount","priceChange24hBps","lastTradeAt"]}},"required":["networkId","contractAddress","token"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/analytics/tokens/{tokenType}/overview":{"get":{"summary":"Read bucketed TVL and volume analytics for a single token across all pools.","tags":["Analytics"],"parameters":[{"schema":{"type":"string","enum":["shielded","unshielded"]},"in":"query","name":"source","required":true},{"schema":{"type":"string","enum":["24H","7D","30D"]},"in":"query","name":"timeFrame","required":false},{"schema":{"type":"string"},"in":"path","name":"tokenType","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"overview":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"object","additionalProperties":false,"properties":{"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenSource":{"type":"string","enum":["shielded","unshielded"]},"liquidity":{"type":"string","pattern":"^[0-9]+$"},"volume24h":{"type":"string","pattern":"^[0-9]+$"},"cumulativeVolume":{"type":"string","pattern":"^[0-9]+$"},"poolCount":{"type":"integer","minimum":0},"priceChange24hBps":{"anyOf":[{"type":"integer"},{"type":"null"}]},"lastTradeAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["tokenType","tokenSource","liquidity","volume24h","cumulativeVolume","poolCount","priceChange24hBps","lastTradeAt"]},"asOf":{"type":"string","format":"date-time"},"timeFrame":{"type":"string","enum":["24H","7D","30D"]},"pools":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["shielded","unshielded","mixed","stableUnshielded"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tvl":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"volume24h":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"cumulativeVolume":{"type":"object","additionalProperties":false,"properties":{"tokenA":{"type":"string","pattern":"^[0-9]+$"},"tokenB":{"type":"string","pattern":"^[0-9]+$"}},"required":["tokenA","tokenB"]},"lastTradeAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["poolId","poolType","tokenA","tokenB","tvl","volume24h","cumulativeVolume","lastTradeAt"]}},"buckets":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"tvl":{"type":"string","pattern":"^[0-9]+$"},"volume":{"type":"string","pattern":"^[0-9]+$"},"tradeCount":{"type":"integer","minimum":0},"poolCount":{"type":"integer","minimum":0}},"required":["startTime","endTime","tvl","volume","tradeCount","poolCount"]}},"limitations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"reason":{"type":"string"}},"required":["title","reason"]}}},"required":["token","asOf","timeFrame","pools","buckets","limitations"]}},"required":["networkId","contractAddress","overview"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/analytics/tokens/{tokenType}/trades":{"get":{"summary":"List visible or inferred trades across pools containing a single token.","tags":["Analytics"],"parameters":[{"schema":{"type":"string","enum":["shielded","unshielded"]},"in":"query","name":"source","required":true},{"schema":{"anyOf":[{"type":"integer","minimum":1,"maximum":100},{"type":"string","pattern":"^[1-9][0-9]?$|^100$"}]},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"path","name":"tokenType","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenType":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenSource":{"type":"string","enum":["shielded","unshielded"]},"asOf":{"type":"string","format":"date-time"},"trades":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["shielded","unshielded","mixed","stableUnshielded"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"walletAddress":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"walletAddressVisibility":{"type":"string","enum":["public","unavailable","private"]},"feeBps":{"type":"integer","minimum":0,"maximum":10000},"timestamp":{"type":"string","format":"date-time"},"blockHeight":{"type":"integer","minimum":0},"txId":{"type":"string","minLength":1},"txHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"amountTokenA":{"type":"string","pattern":"^[0-9]+$"},"amountTokenB":{"type":"string","pattern":"^[0-9]+$"},"feeTokenA":{"type":"string","pattern":"^[0-9]+$"},"feeTokenB":{"type":"string","pattern":"^[0-9]+$"},"inputToken":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"outputToken":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"visibility":{"type":"string","enum":["public","inferred"]}},"required":["poolId","poolType","tokenA","tokenB","walletAddress","walletAddressVisibility","feeBps","timestamp","blockHeight","txId","txHash","amountTokenA","amountTokenB","feeTokenA","feeTokenB","inputToken","outputToken","visibility"]}}},"required":["networkId","contractAddress","tokenType","tokenSource","asOf","trades"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/pools/{poolId}":{"get":{"summary":"Read the latest known state for a single pool.","tags":["Pools"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"poolId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"pool":{"type":"object","additionalProperties":false,"properties":{"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["shielded","unshielded","mixed","stableUnshielded"]},"liquidityBalanceSource":{"type":"string","enum":["shielded","unshielded"]},"liquidityManagementMode":{"type":"string","enum":["batched","direct"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"lpToken":{"type":"string","pattern":"^[0-9a-f]{64}$"},"reserveAId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"reserveBId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"feeLevel":{"type":"integer","minimum":0},"feeNumerator":{"type":"string","pattern":"^[0-9]+$"},"ampFactor":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"reserveA":{"type":"string","pattern":"^[0-9]+$"},"reserveB":{"type":"string","pattern":"^[0-9]+$"},"accruedAdminFeeA":{"type":"string","pattern":"^[0-9]+$"},"accruedAdminFeeB":{"type":"string","pattern":"^[0-9]+$"},"lpTokenTotalSupply":{"type":"string","pattern":"^[0-9]+$"},"lastUpdatedBlockHeight":{"type":"integer"},"lastUpdatedBlockHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"lastUpdatedTxId":{"type":"string","pattern":"^[0-9a-f]+$"},"lastUpdatedTxHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"lastUpdatedAt":{"type":"string","format":"date-time"}},"required":["poolId","poolType","liquidityBalanceSource","liquidityManagementMode","tokenA","tokenB","lpToken","reserveAId","reserveBId","feeLevel","feeNumerator","ampFactor","reserveA","reserveB","accruedAdminFeeA","accruedAdminFeeB","lpTokenTotalSupply","lastUpdatedBlockHeight","lastUpdatedBlockHash","lastUpdatedTxId","lastUpdatedTxHash","lastUpdatedAt"]}},"required":["networkId","contractAddress","pool"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/orders/open":{"get":{"summary":"List currently open public orders, optionally filtered by orderId.","tags":["Orders"],"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"orderIds","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"orders":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"orderId":{"type":"string","pattern":"^[0-9]+$"},"batcherCiphertext":{"type":"string"},"transientOrderCommit":{"type":"string","pattern":"^[0-9]+$"},"persistentOrderCommit":{"type":"string","pattern":"^[0-9a-f]{64}$"},"cancellationCommit":{"type":"string","pattern":"^[0-9a-f]{64}$"},"firstCoinColor":{"type":"string","pattern":"^[0-9a-f]{64}$"},"firstCoinValue":{"type":"string","pattern":"^[0-9]+$"},"firstCoinNonce":{"type":"string","pattern":"^[0-9a-f]{64}$"},"firstCoinMerkleIndex":{"type":"string","pattern":"^[0-9]+$"},"secondCoinColor":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"secondCoinValue":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"secondCoinNonce":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"secondCoinMerkleIndex":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"candidatePoolId":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"status":{"type":"string","enum":["open","closed"]},"openedAtBlockHeight":{"type":"integer"},"openedAtBlockHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"openedAtTxId":{"type":"string","pattern":"^[0-9a-f]+$"},"openedAtTxHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"openedAtTimestamp":{"type":"integer"},"closedAtBlockHeight":{"anyOf":[{"type":"integer"},{"type":"null"}]},"closedAtBlockHash":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"closedAtTxId":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]+$"},{"type":"null"}]},"closedAtTxHash":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"closedAtTimestamp":{"anyOf":[{"type":"integer"},{"type":"null"}]},"closeReason":{"anyOf":[{"type":"string","enum":["cancelled","batched","unknown_closed"]},{"type":"null"}]}},"required":["orderId","batcherCiphertext","transientOrderCommit","persistentOrderCommit","cancellationCommit","firstCoinColor","firstCoinValue","firstCoinNonce","firstCoinMerkleIndex","secondCoinColor","secondCoinValue","secondCoinNonce","secondCoinMerkleIndex","candidatePoolId","status","openedAtBlockHeight","openedAtBlockHash","openedAtTxId","openedAtTxHash","openedAtTimestamp","closedAtBlockHeight","closedAtBlockHash","closedAtTxId","closedAtTxHash","closedAtTimestamp","closeReason"]}},"requestedOrderIds":{"type":"array","items":{"type":"string","pattern":"^[0-9]+$"}},"missingOrderIds":{"type":"array","items":{"type":"string","pattern":"^[0-9]+$"}}},"required":["networkId","contractAddress","orders"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string","enum":["bad_request"]},"message":{"type":"string"}},"required":["error","message"]}}}}}}},"/v1/requests/unshielded/history":{"get":{"summary":"List indexed direct-unshielded request history, optionally filtered by address or txId.","tags":["Orders"],"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"address","required":false},{"schema":{"anyOf":[{"type":"string","minLength":1},{"type":"array","items":{"type":"string","minLength":1}}]},"in":"query","name":"txId","required":false},{"schema":{"type":"integer","minimum":0},"in":"query","name":"offset","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"networkId":{"type":"string"},"contractAddress":{"type":"string","pattern":"^[0-9a-f]{64}$"},"history":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"txId":{"type":"string","minLength":1},"txHash":{"type":"string","pattern":"^[0-9a-f]{64}$"},"blockHeight":{"type":"integer"},"timestamp":{"type":"string","format":"date-time"},"requestType":{"type":"string","enum":["swap","liquidity"]},"liquidityAction":{"anyOf":[{"type":"string","enum":["deposit","withdraw","liquidityPoolCreation"]},{"type":"null"}]},"poolId":{"type":"string","pattern":"^[0-9a-f]{64}$"},"poolType":{"type":"string","enum":["unshielded","mixed","stableUnshielded"]},"tokenA":{"type":"string","pattern":"^[0-9a-f]{64}$"},"tokenB":{"type":"string","pattern":"^[0-9a-f]{64}$"},"lpToken":{"type":"string","pattern":"^[0-9a-f]{64}$"},"sellToken":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"buyToken":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"amountIn":{"type":"string","pattern":"^[0-9]+$"},"amountInSecondary":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]},"amountOut":{"type":"string","pattern":"^[0-9]+$"},"amountOutSecondary":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}]}},"required":["txId","txHash","blockHeight","timestamp","requestType","liquidityAction","poolId","poolType","tokenA","tokenB","lpToken","sellToken","buyToken","amountIn","amountInSecondary","amountOut","amountOutSecondary"]}},"pageSize":{"type":"integer"},"offset":{"type":"integer"},"hasMore":{"type":"boolean"}},"required":["networkId","contractAddress","history","pageSize","offset","hasMore"]}}}}}}}},"tags":[{"name":"System","description":"Health and sync-status endpoints."},{"name":"Pools","description":"Current public pool state."},{"name":"Orders","description":"Current public order state."},{"name":"Analytics","description":"Aggregate pool and token analytics derived from pool state history."},{"name":"Rewards","description":"Raw wallet action logs for external rewards dashboards."}]}