{"openapi":"3.1.0","info":{"title":"Finality Market Intelligence API","version":"1.0.0","description":"Agent- and user-accessible market intelligence paid with Algorand Mainnet USDC through x402. Swagger can inspect unpaid 402 responses or accept a pre-built PAYMENT-SIGNATURE; use the Finality web app for interactive wallet signing."},"servers":[{"url":"https://finality-x402-backend.onrender.com"}],"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 payment payload generated and signed by an Algorand wallet client."}}},"paths":{"/v1/market/quotes":{"get":{"operationId":"market.quotes","summary":"Bounded crypto spot quotes","description":"Price: $0.15 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["market"],"security":[{"x402Payment":[]}],"parameters":[{"name":"symbols","in":"query","required":true,"schema":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"explode":true}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"market.quotes","requestId":"00000000-0000-4000-8000-000000000000","data":{"quotes":[{"symbol":"BTC","price":50000,"change24h":1.2,"volume24h":1000000}]}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/market/assets":{"get":{"operationId":"market.assets","summary":"Asset search and symbol normalization","description":"Price: $0.15 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["market"],"security":[{"x402Payment":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":40},"example":"BTC"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"market.assets","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"market.assets","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/market/candles":{"post":{"operationId":"market.candles","summary":"Bounded OHLCV history","description":"Price: $0.25 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["market"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"marketType":{"type":"string","enum":["crypto","meme","forex","equity","etf"],"default":"crypto"},"interval":{"type":"string","enum":["1m","5m","15m","1h","4h","1d"],"default":"1h"},"limit":{"type":"integer","minimum":2,"maximum":500,"default":100}},"required":["symbols"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"market.candles","requestId":"00000000-0000-4000-8000-000000000000","data":{"candles":[{"time":1700000000000,"open":100,"high":102,"low":99,"close":101,"volume":1000}]}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/market/trending":{"get":{"operationId":"market.trending","summary":"Ranked crypto assets","description":"Price: $0.20 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["market"],"security":[{"x402Payment":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"market.trending","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"market.trending","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/market/categories":{"get":{"operationId":"market.categories","summary":"Coin categories by 24h market-cap change","description":"Price: $0.15 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["market"],"security":[{"x402Payment":[]}],"parameters":[],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"market.categories","requestId":"00000000-0000-4000-8000-000000000000","data":{"categories":[{"id":"layer-1","name":"Layer 1","marketCapChange24h":1.2}]}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/market/token-prices":{"get":{"operationId":"market.tokenPrices","summary":"ERC-20 / on-chain token USD prices","description":"Price: $0.20 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["market"],"security":[{"x402Payment":[]}],"parameters":[{"name":"network","in":"query","schema":{"type":"string","minLength":2,"maxLength":32,"default":"eth","example":"eth"}},{"name":"addresses","in":"query","required":true,"schema":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"string","minLength":8,"maxLength":128},"example":["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"]},"explode":true}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"market.tokenPrices","requestId":"00000000-0000-4000-8000-000000000000","data":{"tokenPrices":[{"network":"eth","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","priceUsd":1}]}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/market/fear-greed":{"get":{"operationId":"market.fearGreed","summary":"Crypto Fear and Greed index","description":"Price: $0.10 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["market"],"security":[{"x402Payment":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":30,"default":1}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"market.fearGreed","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"market.fearGreed","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/signals":{"post":{"operationId":"intelligence.signals","summary":"Multi-market signals and summary","description":"Price: $1.85 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["intelligence"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"marketType":{"type":"string","enum":["crypto","meme","forex","equity","etf"],"default":"crypto"},"interval":{"type":"string","enum":["1m","5m","15m","1h","4h","1d"],"default":"1h"},"limit":{"type":"integer","minimum":2,"maximum":500,"default":100}},"required":["symbols"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"intelligence.signals","requestId":"00000000-0000-4000-8000-000000000000","data":{"signals":[{"symbol":"BTC","direction":"HOLD","score":50}],"summary":{"direction":"HOLD"}}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/technicals":{"post":{"operationId":"intelligence.technicals","summary":"Technical indicators and regime","description":"Price: $1.85 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["intelligence"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"marketType":{"type":"string","enum":["crypto","meme","forex","equity","etf"],"default":"crypto"},"interval":{"type":"string","enum":["1m","5m","15m","1h","4h","1d"],"default":"1h"},"limit":{"type":"integer","minimum":2,"maximum":500,"default":100}},"required":["symbols"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"intelligence.technicals","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"intelligence.technicals","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/analysis/report":{"post":{"operationId":"intelligence.report","summary":"Combined intelligence report","description":"Price: $3.10 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["intelligence"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"marketType":{"type":"string","enum":["crypto","meme","forex","equity","etf"],"default":"crypto"},"interval":{"type":"string","enum":["1m","5m","15m","1h","4h","1d"],"default":"1h"},"limit":{"type":"integer","minimum":2,"maximum":500,"default":100}},"required":["symbols"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"intelligence.report","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"intelligence.report","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/analysis/volume":{"post":{"operationId":"intelligence.volume","summary":"Volume participation analysis","description":"Price: $1.00 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["intelligence"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"marketType":{"type":"string","enum":["crypto","meme","forex","equity","etf"],"default":"crypto"},"interval":{"type":"string","enum":["1m","5m","15m","1h","4h","1d"],"default":"1h"},"limit":{"type":"integer","minimum":2,"maximum":500,"default":100}},"required":["symbols"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"intelligence.volume","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"intelligence.volume","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/analysis/events":{"post":{"operationId":"intelligence.events","summary":"Market event intelligence","description":"Price: $1.85 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["intelligence"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"marketType":{"type":"string","enum":["crypto","meme","forex","equity","etf"],"default":"crypto"},"interval":{"type":"string","enum":["1m","5m","15m","1h","4h","1d"],"default":"1h"},"limit":{"type":"integer","minimum":2,"maximum":500,"default":100}},"required":["symbols"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"intelligence.events","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"intelligence.events","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/backtest":{"post":{"operationId":"intelligence.backtest","summary":"Bounded strategy backtest","description":"Price: $3.10 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["intelligence"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"marketType":{"type":"string","enum":["crypto","meme","forex","equity","etf"],"default":"crypto"},"interval":{"type":"string","enum":["1m","5m","15m","1h","4h","1d"],"default":"1h"},"limit":{"type":"integer","minimum":2,"maximum":500,"default":100},"strategy":{"type":"object","properties":{"fastPeriod":{"type":"integer","minimum":2,"maximum":100,"default":10},"slowPeriod":{"type":"integer","minimum":3,"maximum":200,"default":30},"initialCapital":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"default":10000}}}},"required":["symbols"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"intelligence.backtest","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"intelligence.backtest","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/agent/decision":{"post":{"operationId":"agent.decision","summary":"Gemini risk-aware decision","description":"Price: $2.40 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["agent"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"marketType":{"type":"string","enum":["crypto","meme","forex","equity","etf"],"default":"crypto"},"interval":{"type":"string","enum":["1m","5m","15m","1h","4h","1d"],"default":"1h"},"limit":{"type":"integer","minimum":2,"maximum":500,"default":100},"risk":{"type":"string","enum":["conservative","balanced","aggressive"],"default":"balanced"}},"required":["symbols"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"agent.decision","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"agent.decision","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/agent/briefing":{"post":{"operationId":"agent.briefing","summary":"Gemini market briefing","description":"Price: $3.10 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["agent"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"marketType":{"type":"string","enum":["crypto","meme","forex","equity","etf"],"default":"crypto"},"interval":{"type":"string","enum":["1m","5m","15m","1h","4h","1d"],"default":"1h"},"limit":{"type":"integer","minimum":2,"maximum":500,"default":100}},"required":["symbols"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"agent.briefing","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"agent.briefing","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/agent/strategy/parse":{"post":{"operationId":"agent.strategyParse","summary":"Natural language strategy parser","description":"Price: $2.40 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["agent"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":5,"maxLength":2000,"example":"Buy when fast 10 crosses above slow 30"}},"required":["prompt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"agent.strategyParse","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"agent.strategyParse","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/ai/chat":{"post":{"operationId":"ai.chat","summary":"Gemini data-grounded analyst response","description":"Price: $4.00 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["ai"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbols":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":20},"example":["BTC"]},"marketType":{"type":"string","enum":["crypto","meme","forex","equity","etf"],"default":"crypto"},"interval":{"type":"string","enum":["1m","5m","15m","1h","4h","1d"],"default":"1h"},"limit":{"type":"integer","minimum":2,"maximum":500,"default":100},"prompt":{"type":"string","minLength":1,"maxLength":4000,"example":"Analyze BTC market conditions"}},"required":["symbols","prompt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"ai.chat","requestId":"00000000-0000-4000-8000-000000000000","data":{"answer":"Bounded market analysis","generatedByModel":true}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algorand/account":{"post":{"operationId":"onchain.algorandAccount","summary":"Algorand account intelligence","description":"Price: $0.25 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^[A-Z2-7]{58}$","example":"WJJ7MTAZTDXAI7656JHB3V432U7XUNTIKSYRTYQD3FAGDMEGLOUFGMN7SI"}},"required":["address"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algorandAccount","requestId":"00000000-0000-4000-8000-000000000000","data":{"address":"ALGORAND_ADDRESS","amount":0,"assets":[]}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algorand/portfolio":{"post":{"operationId":"onchain.algorandPortfolio","summary":"Algorand ASA portfolio","description":"Price: $0.35 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^[A-Z2-7]{58}$","example":"WJJ7MTAZTDXAI7656JHB3V432U7XUNTIKSYRTYQD3FAGDMEGLOUFGMN7SI"}},"required":["address"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algorandPortfolio","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algorandPortfolio","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algorand/asset":{"post":{"operationId":"onchain.algorandAsset","summary":"Algorand asset intelligence","description":"Price: $0.20 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"assetId":{"type":"integer","minimum":1,"example":10458941}},"required":["assetId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algorandAsset","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algorandAsset","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algorand/defi":{"post":{"operationId":"onchain.algorandDefi","summary":"Indexer-backed Algorand DeFi activity","description":"Price: $0.45 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^[A-Z2-7]{58}$","example":"WJJ7MTAZTDXAI7656JHB3V432U7XUNTIKSYRTYQD3FAGDMEGLOUFGMN7SI"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20}},"additionalProperties":false}}}},"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algorandDefi","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algorandDefi","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/status":{"get":{"operationId":"onchain.algodStatus","summary":"Nodely algod node status and last round","description":"Price: $0.10 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodStatus","requestId":"00000000-0000-4000-8000-000000000000","data":{"found":true,"last-round":67421801}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/supply":{"get":{"operationId":"onchain.algodSupply","summary":"Current ledger ALGO supply","description":"Price: $0.10 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodSupply","requestId":"00000000-0000-4000-8000-000000000000","data":{"found":true,"current_round":67421801,"online-money":0,"total-money":0}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/params":{"get":{"operationId":"onchain.algodParams","summary":"Suggested transaction parameters","description":"Price: $0.10 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodParams","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodParams","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/account":{"get":{"operationId":"onchain.algodAccount","summary":"Live algod account information","description":"Price: $0.20 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z2-7]{58}$","example":"WJJ7MTAZTDXAI7656JHB3V432U7XUNTIKSYRTYQD3FAGDMEGLOUFGMN7SI"}},{"name":"exclude","in":"query","schema":{"type":"string","example":"none"}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodAccount","requestId":"00000000-0000-4000-8000-000000000000","data":{"found":true,"address":"ALGORAND_ADDRESS","amount":0,"assets":[]}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/account/assets":{"get":{"operationId":"onchain.algodAccountAssets","summary":"Paginated account ASA holdings","description":"Price: $0.25 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z2-7]{58}$","example":"WJJ7MTAZTDXAI7656JHB3V432U7XUNTIKSYRTYQD3FAGDMEGLOUFGMN7SI"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"next","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodAccountAssets","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodAccountAssets","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/account/asset":{"get":{"operationId":"onchain.algodAccountAsset","summary":"Account holding for one ASA","description":"Price: $0.20 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z2-7]{58}$","example":"WJJ7MTAZTDXAI7656JHB3V432U7XUNTIKSYRTYQD3FAGDMEGLOUFGMN7SI"}},{"name":"assetId","in":"query","required":true,"schema":{"type":"integer","minimum":1,"example":10458941}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodAccountAsset","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodAccountAsset","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/account/applications":{"get":{"operationId":"onchain.algodAccountApps","summary":"Paginated account application local state","description":"Price: $0.25 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z2-7]{58}$","example":"WJJ7MTAZTDXAI7656JHB3V432U7XUNTIKSYRTYQD3FAGDMEGLOUFGMN7SI"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"next","in":"query","schema":{"type":"string"}},{"name":"include","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodAccountApps","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodAccountApps","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/account/application":{"get":{"operationId":"onchain.algodAccountApp","summary":"Account local state for one application","description":"Price: $0.20 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z2-7]{58}$","example":"WJJ7MTAZTDXAI7656JHB3V432U7XUNTIKSYRTYQD3FAGDMEGLOUFGMN7SI"}},{"name":"applicationId","in":"query","required":true,"schema":{"type":"integer","minimum":1,"example":12174882}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodAccountApp","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodAccountApp","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/account/pending":{"get":{"operationId":"onchain.algodPendingByAddress","summary":"Unconfirmed mempool transactions by address","description":"Price: $0.25 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z2-7]{58}$","example":"WJJ7MTAZTDXAI7656JHB3V432U7XUNTIKSYRTYQD3FAGDMEGLOUFGMN7SI"}},{"name":"max","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodPendingByAddress","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodPendingByAddress","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/asset":{"get":{"operationId":"onchain.algodAsset","summary":"Live algod asset parameters","description":"Price: $0.20 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"assetId","in":"query","required":true,"schema":{"type":"integer","minimum":1,"example":10458941}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodAsset","requestId":"00000000-0000-4000-8000-000000000000","data":{"found":true,"index":10458941,"params":{"name":"USDC","unit-name":"USDC","decimals":6}}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/application":{"get":{"operationId":"onchain.algodApplication","summary":"Application programs and global state","description":"Price: $0.25 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"applicationId","in":"query","required":true,"schema":{"type":"integer","minimum":1,"example":12174882}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodApplication","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodApplication","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/application/boxes":{"get":{"operationId":"onchain.algodApplicationBoxes","summary":"Application box names","description":"Price: $0.35 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"applicationId","in":"query","required":true,"schema":{"type":"integer","minimum":1,"example":12174882}},{"name":"max","in":"query","schema":{"type":"integer","minimum":1,"maximum":256,"default":32}},{"name":"next","in":"query","schema":{"type":"string"}},{"name":"prefix","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodApplicationBoxes","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodApplicationBoxes","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/application/box":{"get":{"operationId":"onchain.algodApplicationBox","summary":"Single application box value","description":"Price: $0.20 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"applicationId","in":"query","required":true,"schema":{"type":"integer","minimum":1,"example":12174882}},{"name":"name","in":"query","required":true,"schema":{"type":"string","example":"str:hello"}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodApplicationBox","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodApplicationBox","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/block":{"get":{"operationId":"onchain.algodBlock","summary":"Block header for a round","description":"Price: $0.35 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"round","in":"query","schema":{"type":"integer","minimum":1,"example":67421801}},{"name":"headerOnly","in":"query","schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodBlock","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodBlock","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/block/hash":{"get":{"operationId":"onchain.algodBlockHash","summary":"Block hash for a round","description":"Price: $0.10 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"round","in":"query","schema":{"type":"integer","minimum":1,"example":67421801}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodBlockHash","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodBlockHash","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/block/txids":{"get":{"operationId":"onchain.algodBlockTxids","summary":"Top-level transaction IDs in a block","description":"Price: $0.15 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"round","in":"query","schema":{"type":"integer","minimum":1,"example":67421801}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodBlockTxids","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodBlockTxids","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/block/logs":{"get":{"operationId":"onchain.algodBlockLogs","summary":"App-call logs for a round","description":"Price: $0.35 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"round","in":"query","schema":{"type":"integer","minimum":1,"example":67421801}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodBlockLogs","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodBlockLogs","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}},"/v1/onchain/algod/pending":{"get":{"operationId":"onchain.algodPending","summary":"Global unconfirmed transaction pool","description":"Price: $0.15 USDC on Algorand Mainnet. First call without PAYMENT-SIGNATURE returns the x402 payment requirements.","tags":["onchain"],"security":[{"x402Payment":[]}],"parameters":[{"name":"max","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Paid successful response","headers":{"PAYMENT-RESPONSE":{"description":"Settlement receipt","schema":{"type":"string"}}},"content":{"application/json":{"example":{"success":true,"operationId":"onchain.algodPending","requestId":"00000000-0000-4000-8000-000000000000","data":{"operationId":"onchain.algodPending","result":"See OpenAPI response schema"}}}}},"400":{"description":"Invalid request"},"402":{"description":"x402 payment required; response contains payment requirements"},"503":{"description":"Provider unavailable"}}}}}}