{"openapi":"3.1.0","info":{"title":"AgenticFi API","version":"1.0.0","description":"DeFi APIs for AI agents. 36 pay-per-call endpoints for token data, pricing, wallet analytics, swap routing, and on-chain workflows. Powered by x402 on Base.","guidance":"DeFi APIs for AI agents. Discovery is canonical via this OpenAPI document. All listed /api routes return a 402 challenge before payment and are invocable after x402 settlement on Base."},"servers":[{"url":"https://defi-api.agenticfi.wtf"}],"paths":{"/api/token/price/{idOrSymbol}":{"get":{"operationId":"get_api_token_price_idOrSymbol","summary":"Real-time token price by CoinGecko ID or symbol - includes 24h change, volume, market cap","description":"Real-time token price by CoinGecko ID or symbol - includes 24h change, volume, market cap","tags":["token-price","real-time","market-data"],"parameters":[{"name":"idOrSymbol","in":"path","required":true,"description":"Required. CoinGecko ID or common symbol.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum\nSymbol examples: BTC, ETH, SOL, LINK, UNI, AAVE, MKR, DOGE, PEPE, ARB","example":"required (example: bitcoin)","schema":{"type":"string","title":"idOrSymbol (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"price":{"type":"number"},"change24h":{"type":"number"},"volume24h":{"type":"number"},"marketCap":{"type":"number"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"idOrSymbol":{"type":"string","title":"idOrSymbol (required)","description":"Required. CoinGecko ID or common symbol.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum\nSymbol examples: BTC, ETH, SOL, LINK, UNI, AAVE, MKR, DOGE, PEPE, ARB","example":"required (example: bitcoin)","x-parameter-location":"path"}},"required":["idOrSymbol"],"additionalProperties":false}}}}}},"/api/token/price-history/{id}":{"get":{"operationId":"get_api_token_price_history_id","summary":"OHLCV candles for a token - supports 1d, 7d, 14d, 30d, 90d, 365d ranges","description":"OHLCV candles for a token - supports 1d, 7d, 14d, 30d, 90d, 365d ranges","tags":["ohlcv","price-history","candles"],"parameters":[{"name":"id","in":"path","required":true,"description":"Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum","example":"required (example: bitcoin)","schema":{"type":"string","title":"id (required)"}},{"name":"days","in":"query","required":false,"description":"Optional. Number of days (1, 7, 14, 30, 90, 365) Examples: 1, 7, 30, 365","example":"optional (example: 30)","schema":{"type":"string","title":"days (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"candles":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"number"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"}}}}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"id":{"type":"string","title":"id (required)","description":"Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum","example":"required (example: bitcoin)","x-parameter-location":"path"},"days":{"type":"string","title":"days (optional)","description":"Optional. Number of days (1, 7, 14, 30, 90, 365) Examples: 1, 7, 30, 365","example":"optional (example: 30)","x-parameter-location":"query"}},"required":["id"],"additionalProperties":false}}}}}},"/api/token/info/{address}":{"get":{"operationId":"get_api_token_info_address","summary":"EVM token info by contract address or native asset - metadata, realtime price, supply fields, logo, and optional historical prices","description":"EVM token info by contract address or native asset - metadata, realtime price, supply fields, logo, and optional historical prices","tags":["token-info","metadata","pricing","historical-prices","sim"],"parameters":[{"name":"address","in":"path","required":true,"description":"Required. ERC-20 contract address or 'native' for the chain-native asset.\nExamples: native, 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913 (Base USDC), 0x4200000000000000000000000000000000000006 (Base WETH), 0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca (Base USDbC)","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"address (required)"}},{"name":"chain_ids","in":"query","required":true,"description":"Required single chain ID, e.g. '8453' Examples: 8453, 1,8453, default","example":"required (example: 1,8453)","schema":{"type":"string","title":"chain_ids (required)"}},{"name":"chain","in":"query","required":false,"description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}},{"name":"historical_prices","in":"query","required":false,"description":"Optional. Comma-separated hour offsets, up to 3 values, e.g. '720,168,24' Examples: 720,168,24","example":"optional (example: 720,168,24)","schema":{"type":"string","title":"historical_prices (optional)"}},{"name":"limit","in":"query","required":false,"description":"Optional. Maximum number of token rows to return, 1-100 Examples: 100, 500","example":"optional (example: 100)","schema":{"type":"string","title":"limit (optional)"}},{"name":"offset","in":"query","required":false,"description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","schema":{"type":"string","title":"offset (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"contract_address":{"type":"string"},"tokens":{"type":"array","items":{"type":"object","properties":{"chain":{"type":"string"},"chain_id":{"type":"number"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"},"price_usd":{"type":"number"},"historical_prices":{"type":"array"},"pool_size":{"type":"number"},"total_supply":{"type":"string"},"fully_diluted_value":{"type":"number"},"market_cap":{"type":"number"},"logo":{"type":"string"}}}},"warnings":{"type":"array"},"next_offset":{"type":"string"},"request_time":{"type":"string"},"response_time":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"address":{"type":"string","title":"address (required)","description":"Required. ERC-20 contract address or 'native' for the chain-native asset.\nExamples: native, 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913 (Base USDC), 0x4200000000000000000000000000000000000006 (Base WETH), 0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca (Base USDbC)","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"path"},"chain_ids":{"type":"string","title":"chain_ids (required)","description":"Required single chain ID, e.g. '8453' Examples: 8453, 1,8453, default","example":"required (example: 1,8453)","x-parameter-location":"query"},"chain":{"type":"string","title":"chain (optional)","description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"},"historical_prices":{"type":"string","title":"historical_prices (optional)","description":"Optional. Comma-separated hour offsets, up to 3 values, e.g. '720,168,24' Examples: 720,168,24","example":"optional (example: 720,168,24)","x-parameter-location":"query"},"limit":{"type":"string","title":"limit (optional)","description":"Optional. Maximum number of token rows to return, 1-100 Examples: 100, 500","example":"optional (example: 100)","x-parameter-location":"query"},"offset":{"type":"string","title":"offset (optional)","description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","x-parameter-location":"query"}},"required":["address","chain_ids"],"additionalProperties":false}}}}}},"/api/token/holders/{chainId}/{address}":{"get":{"operationId":"get_api_token_holders_chainId_address","summary":"ERC-20 token holders by chain - ranked by balance descending with first-acquired and transfer-initiation flags","description":"ERC-20 token holders by chain - ranked by balance descending with first-acquired and transfer-initiation flags","tags":["token-holders","distribution","erc20","holders","sim"],"parameters":[{"name":"address","in":"path","required":true,"description":"Required. ERC-20 token contract address.\nExample: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"address (required)"}},{"name":"chainId","in":"path","required":true,"description":"Required EVM chain ID, e.g. '8453' for Base Examples: 8453, 1, 42161","example":"required (example: 8453)","schema":{"type":"string","title":"chainId (required)"}},{"name":"limit","in":"query","required":false,"description":"Optional. Maximum number of holders to return, 1-500 Examples: 100, 500","example":"optional (example: 100)","schema":{"type":"string","title":"limit (optional)"}},{"name":"offset","in":"query","required":false,"description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","schema":{"type":"string","title":"offset (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"token_address":{"type":"string"},"chain_id":{"type":"number"},"holders":{"type":"array","items":{"type":"object","properties":{"wallet_address":{"type":"string"},"balance":{"type":"string"},"first_acquired":{"type":"string"},"has_initiated_transfer":{"type":"boolean"}}}},"next_offset":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"address":{"type":"string","title":"address (required)","description":"Required. ERC-20 token contract address.\nExample: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"path"},"chainId":{"type":"string","title":"chainId (required)","description":"Required EVM chain ID, e.g. '8453' for Base Examples: 8453, 1, 42161","example":"required (example: 8453)","x-parameter-location":"path"},"limit":{"type":"string","title":"limit (optional)","description":"Optional. Maximum number of holders to return, 1-500 Examples: 100, 500","example":"optional (example: 100)","x-parameter-location":"query"},"offset":{"type":"string","title":"offset (optional)","description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","x-parameter-location":"query"}},"required":["address","chainId"],"additionalProperties":false}}}}}},"/api/token/metadata/{id}":{"get":{"operationId":"get_api_token_metadata_id","summary":"Token metadata - name, symbol, decimals, logo, chains, links","description":"Token metadata - name, symbol, decimals, logo, chains, links","tags":["token-metadata","token-info"],"parameters":[{"name":"id","in":"path","required":true,"description":"Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum","example":"required (example: bitcoin)","schema":{"type":"string","title":"id (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"},"logo":{"type":"string"},"chains":{"type":"array"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"id":{"type":"string","title":"id (required)","description":"Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum","example":"required (example: bitcoin)","x-parameter-location":"path"}},"required":["id"],"additionalProperties":false}}}}}},"/api/token/trending":{"get":{"operationId":"get_api_token_trending","summary":"Top trending tokens by search volume and social activity","description":"Top trending tokens by search volume and social activity","tags":["trending","social","popular"],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"marketCapRank":{"type":"number"}}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/api/token/supply/{id}":{"get":{"operationId":"get_api_token_supply_id","summary":"Circulating, total, max supply + FDV for a token","description":"Circulating, total, max supply + FDV for a token","tags":["supply","tokenomics","fdv"],"parameters":[{"name":"id","in":"path","required":true,"description":"Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum","example":"required (example: bitcoin)","schema":{"type":"string","title":"id (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"circulatingSupply":{"type":"number"},"totalSupply":{"type":"number"},"maxSupply":{"type":"number"},"fdv":{"type":"number"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"id":{"type":"string","title":"id (required)","description":"Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum","example":"required (example: bitcoin)","x-parameter-location":"path"}},"required":["id"],"additionalProperties":false}}}}}},"/api/token/pairs/{id}":{"get":{"operationId":"get_api_token_pairs_id","summary":"All DEX pairs for a token with liquidity data","description":"All DEX pairs for a token with liquidity data","tags":["dex-pairs","liquidity","trading"],"parameters":[{"name":"id","in":"path","required":true,"description":"Required. CoinGecko token ID or EVM contract address.\nTry CoinGecko IDs like: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum\nContract address example: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","example":"required (example: bitcoin)","schema":{"type":"string","title":"id (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"pairs":{"type":"array"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"id":{"type":"string","title":"id (required)","description":"Required. CoinGecko token ID or EVM contract address.\nTry CoinGecko IDs like: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum\nContract address example: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","example":"required (example: bitcoin)","x-parameter-location":"path"}},"required":["id"],"additionalProperties":false}}}}}},"/api/defi/protocol-tvl":{"get":{"operationId":"get_api_defi_protocol_tvl","summary":"TVL by protocol - top 50 or specific protocol with chain breakdown","description":"TVL by protocol - top 50 or specific protocol with chain breakdown","tags":["tvl","protocol","defi"],"parameters":[{"name":"protocol","in":"query","required":false,"description":"Optional. Protocol slug (e.g. 'aave', 'uniswap') Examples: aave, uniswap, curve","example":"optional (example: aave)","schema":{"type":"string","title":"protocol (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"tvl":{"type":"number"},"change24h":{"type":"number"},"chains":{"type":"array"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"protocol":{"type":"string","title":"protocol (optional)","description":"Optional. Protocol slug (e.g. 'aave', 'uniswap') Examples: aave, uniswap, curve","example":"optional (example: aave)","x-parameter-location":"query"}},"additionalProperties":false}}}}}},"/api/defi/yields":{"get":{"operationId":"get_api_defi_yields","summary":"Top yield pools across all protocols and chains - sorted by APY","description":"Top yield pools across all protocols and chains - sorted by APY","tags":["yields","apy","farming"],"parameters":[{"name":"chain","in":"query","required":false,"description":"Optional. Filter by chain name Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}},{"name":"minTvl","in":"query","required":false,"description":"Optional. Minimum TVL in USD","example":"optional (example: value)","schema":{"type":"string","title":"minTvl (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"protocol":{"type":"string"},"chain":{"type":"string"},"apy":{"type":"number"},"tvl":{"type":"number"}}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"chain":{"type":"string","title":"chain (optional)","description":"Optional. Filter by chain name Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"},"minTvl":{"type":"string","title":"minTvl (optional)","description":"Optional. Minimum TVL in USD","example":"optional (example: value)","x-parameter-location":"query"}},"additionalProperties":false}}}}}},"/api/defi/pool-details/{poolId}":{"get":{"operationId":"get_api_defi_pool_details_poolId","summary":"Detailed pool info - APY history, TVL, IL risk, reward tokens","description":"Detailed pool info - APY history, TVL, IL risk, reward tokens","tags":["pool","apy-history","il-risk"],"parameters":[{"name":"poolId","in":"path","required":true,"description":"Required. DeFi Llama pool ID","example":"required (example: value)","schema":{"type":"string","title":"poolId (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"poolId":{"type":"string"},"history":{"type":"array"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"poolId":{"type":"string","title":"poolId (required)","description":"Required. DeFi Llama pool ID","example":"required (example: value)","x-parameter-location":"path"}},"required":["poolId"],"additionalProperties":false}}}}}},"/api/defi/lending-rates":{"get":{"operationId":"get_api_defi_lending_rates","summary":"Supply & borrow rates across Aave, Compound, Morpho, Spark","description":"Supply & borrow rates across Aave, Compound, Morpho, Spark","tags":["lending","borrow-rates","supply-rates"],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"protocol":{"type":"string"},"asset":{"type":"string"},"supplyApy":{"type":"number"},"totalApy":{"type":"number"},"tvl":{"type":"number"}}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/api/defi/stablecoin-stats":{"get":{"operationId":"get_api_defi_stablecoin_stats","summary":"Stablecoin market caps, peg deviations, circulating supply by chain","description":"Stablecoin market caps, peg deviations, circulating supply by chain","tags":["stablecoins","peg","circulating"],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"totalCirculating":{"type":"number"},"pegMechanism":{"type":"string"}}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/api/defi/dex-volume":{"get":{"operationId":"get_api_defi_dex_volume","summary":"24h DEX trading volume by chain and protocol","description":"24h DEX trading volume by chain and protocol","tags":["dex-volume","trading-volume","dex"],"parameters":[{"name":"chain","in":"query","required":false,"description":"Optional. Chain name filter Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalVolume24h":{"type":"number"},"protocols":{"type":"array"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"chain":{"type":"string","title":"chain (optional)","description":"Optional. Chain name filter Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"}},"additionalProperties":false}}}}}},"/api/defi/protocol-fees":{"get":{"operationId":"get_api_defi_protocol_fees","summary":"Revenue and fees by protocol - daily fees and protocol revenue","description":"Revenue and fees by protocol - daily fees and protocol revenue","tags":["fees","revenue","protocol-revenue"],"parameters":[{"name":"protocol","in":"query","required":false,"description":"Optional. Protocol slug Examples: aave, uniswap, curve","example":"optional (example: aave)","schema":{"type":"string","title":"protocol (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"fees24h":{"type":"number"},"revenue24h":{"type":"number"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"protocol":{"type":"string","title":"protocol (optional)","description":"Optional. Protocol slug Examples: aave, uniswap, curve","example":"optional (example: aave)","x-parameter-location":"query"}},"additionalProperties":false}}}}}},"/api/wallet/balances/{address}":{"get":{"operationId":"get_api_wallet_balances_address","summary":"EVM token balances for a wallet - native + ERC-20 with Sim pricing, warnings, pagination, and optional historical prices","description":"EVM token balances for a wallet - native + ERC-20 with Sim pricing, warnings, pagination, and optional historical prices","tags":["wallet","balances","portfolio","sim"],"parameters":[{"name":"address","in":"path","required":true,"description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"address (required)"}},{"name":"asset_class","in":"query","required":false,"description":"Optional. Asset class filter, e.g. 'stablecoin'","example":"optional (example: value)","schema":{"type":"string","title":"asset_class (optional)"}},{"name":"chain","in":"query","required":false,"description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}},{"name":"chain_ids","in":"query","required":false,"description":"Optional. Sim chain IDs and/or tags, e.g. '1,8453' or 'default' Examples: 8453, 1,8453, default","example":"optional (example: 1,8453)","schema":{"type":"string","title":"chain_ids (optional)"}},{"name":"exclude_spam_tokens","in":"query","required":false,"description":"Optional. Set to 'true' to exclude tokens with less than $100 liquidity","example":"optional (example: value)","schema":{"type":"string","title":"exclude_spam_tokens (optional)"}},{"name":"filters","in":"query","required":false,"description":"Optional. Filter balances by asset type: 'erc20' or 'native'","example":"optional (example: value)","schema":{"type":"string","title":"filters (optional)"}},{"name":"historical_prices","in":"query","required":false,"description":"Optional. Comma-separated hour offsets, up to 3 values, e.g. '720,168,24' Examples: 720,168,24","example":"optional (example: 720,168,24)","schema":{"type":"string","title":"historical_prices (optional)"}},{"name":"limit","in":"query","required":false,"description":"Optional. Maximum number of balances to return, 1-1000 Examples: 100, 500","example":"optional (example: 100)","schema":{"type":"string","title":"limit (optional)"}},{"name":"metadata","in":"query","required":false,"description":"Optional. Comma-separated extra metadata fields: 'logo', 'url', 'pools'","example":"optional (example: value)","schema":{"type":"string","title":"metadata (optional)"}},{"name":"offset","in":"query","required":false,"description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","schema":{"type":"string","title":"offset (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"wallet_address":{"type":"string"},"balances":{"type":"array","items":{"type":"object","properties":{"chain":{"type":"string"},"chain_id":{"type":"number"},"address":{"type":"string"},"amount":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"},"price_usd":{"type":"number"},"value_usd":{"type":"number"},"pool_size":{"type":"number"},"low_liquidity":{"type":"boolean"},"historical_prices":{"type":"array"},"token_metadata":{"type":"object"},"pool":{"type":"object"}}}},"warnings":{"type":"array"},"errors":{"type":"object"},"next_offset":{"type":"string"},"request_time":{"type":"string"},"response_time":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"path"},"asset_class":{"type":"string","title":"asset_class (optional)","description":"Optional. Asset class filter, e.g. 'stablecoin'","example":"optional (example: value)","x-parameter-location":"query"},"chain":{"type":"string","title":"chain (optional)","description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"},"chain_ids":{"type":"string","title":"chain_ids (optional)","description":"Optional. Sim chain IDs and/or tags, e.g. '1,8453' or 'default' Examples: 8453, 1,8453, default","example":"optional (example: 1,8453)","x-parameter-location":"query"},"exclude_spam_tokens":{"type":"string","title":"exclude_spam_tokens (optional)","description":"Optional. Set to 'true' to exclude tokens with less than $100 liquidity","example":"optional (example: value)","x-parameter-location":"query"},"filters":{"type":"string","title":"filters (optional)","description":"Optional. Filter balances by asset type: 'erc20' or 'native'","example":"optional (example: value)","x-parameter-location":"query"},"historical_prices":{"type":"string","title":"historical_prices (optional)","description":"Optional. Comma-separated hour offsets, up to 3 values, e.g. '720,168,24' Examples: 720,168,24","example":"optional (example: 720,168,24)","x-parameter-location":"query"},"limit":{"type":"string","title":"limit (optional)","description":"Optional. Maximum number of balances to return, 1-1000 Examples: 100, 500","example":"optional (example: 100)","x-parameter-location":"query"},"metadata":{"type":"string","title":"metadata (optional)","description":"Optional. Comma-separated extra metadata fields: 'logo', 'url', 'pools'","example":"optional (example: value)","x-parameter-location":"query"},"offset":{"type":"string","title":"offset (optional)","description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","x-parameter-location":"query"}},"required":["address"],"additionalProperties":false}}}}}},"/api/wallet/activity/{address}":{"get":{"operationId":"get_api_wallet_activity_address","summary":"EVM wallet activity feed - newest-first transfers, swaps, approvals, NFT movements, and decoded contract calls","description":"EVM wallet activity feed - newest-first transfers, swaps, approvals, NFT movements, and decoded contract calls","tags":["activity","wallet-activity","transfers","swaps","sim"],"parameters":[{"name":"address","in":"path","required":true,"description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"address (required)"}},{"name":"activity_type","in":"query","required":false,"description":"Optional. Comma-separated activity types: send, receive, mint, burn, swap, approve, call","example":"optional (example: value)","schema":{"type":"string","title":"activity_type (optional)"}},{"name":"asset_type","in":"query","required":false,"description":"Optional. Comma-separated asset standards: native, erc20, erc721, erc1155","example":"optional (example: value)","schema":{"type":"string","title":"asset_type (optional)"}},{"name":"chain","in":"query","required":false,"description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}},{"name":"chain_ids","in":"query","required":false,"description":"Optional. Sim chain IDs and/or tags, e.g. '1,8453' or 'default' Examples: 8453, 1,8453, default","example":"optional (example: 1,8453)","schema":{"type":"string","title":"chain_ids (optional)"}},{"name":"limit","in":"query","required":false,"description":"Optional. Maximum number of activity items to return, 1-100 Examples: 100, 500","example":"optional (example: 100)","schema":{"type":"string","title":"limit (optional)"}},{"name":"offset","in":"query","required":false,"description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","schema":{"type":"string","title":"offset (optional)"}},{"name":"token_address","in":"query","required":false,"description":"Optional. Filter by one or more token contract addresses Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"optional (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"token_address (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"activity":{"type":"array","items":{"type":"object","properties":{"chain_id":{"type":"number"},"block_number":{"type":"number"},"block_time":{"type":"string"},"tx_hash":{"type":"string"},"type":{"type":"string"},"asset_type":{"type":"string"},"token_address":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"value":{"type":"string"},"value_usd":{"type":"number"},"id":{"type":"string"},"spender":{"type":"string"},"token_metadata":{"type":"object"},"function":{"type":"object"},"contract_metadata":{"type":"object"},"from_token_address":{"type":"string"},"from_token_value":{"type":"string"},"from_token_metadata":{"type":"object"},"to_token_address":{"type":"string"},"to_token_value":{"type":"string"},"to_token_metadata":{"type":"object"}}}},"warnings":{"type":"array"},"next_offset":{"type":"string"},"request_time":{"type":"string"},"response_time":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"path"},"activity_type":{"type":"string","title":"activity_type (optional)","description":"Optional. Comma-separated activity types: send, receive, mint, burn, swap, approve, call","example":"optional (example: value)","x-parameter-location":"query"},"asset_type":{"type":"string","title":"asset_type (optional)","description":"Optional. Comma-separated asset standards: native, erc20, erc721, erc1155","example":"optional (example: value)","x-parameter-location":"query"},"chain":{"type":"string","title":"chain (optional)","description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"},"chain_ids":{"type":"string","title":"chain_ids (optional)","description":"Optional. Sim chain IDs and/or tags, e.g. '1,8453' or 'default' Examples: 8453, 1,8453, default","example":"optional (example: 1,8453)","x-parameter-location":"query"},"limit":{"type":"string","title":"limit (optional)","description":"Optional. Maximum number of activity items to return, 1-100 Examples: 100, 500","example":"optional (example: 100)","x-parameter-location":"query"},"offset":{"type":"string","title":"offset (optional)","description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","x-parameter-location":"query"},"token_address":{"type":"string","title":"token_address (optional)","description":"Optional. Filter by one or more token contract addresses Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"optional (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"query"}},"required":["address"],"additionalProperties":false}}}}}},"/api/wallet/transactions/{address}":{"get":{"operationId":"get_api_wallet_transactions_address","summary":"EVM transactions for a wallet - raw transaction fields, gas data, pagination, and optional decoded calldata and logs","description":"EVM transactions for a wallet - raw transaction fields, gas data, pagination, and optional decoded calldata and logs","tags":["transactions","wallet-transactions","gas","decoded","sim"],"parameters":[{"name":"address","in":"path","required":true,"description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"address (required)"}},{"name":"chain","in":"query","required":false,"description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}},{"name":"chain_ids","in":"query","required":false,"description":"Optional. Sim chain IDs and/or tags, e.g. '1,8453' or 'default' Examples: 8453, 1,8453, default","example":"optional (example: 1,8453)","schema":{"type":"string","title":"chain_ids (optional)"}},{"name":"decode","in":"query","required":false,"description":"Optional. Set to 'true' to include decoded transaction calldata and logs when available Examples: true, false","example":"optional (example: true)","schema":{"type":"string","title":"decode (optional)"}},{"name":"limit","in":"query","required":false,"description":"Optional. Maximum number of transactions to return, 1-100 Examples: 100, 500","example":"optional (example: 100)","schema":{"type":"string","title":"limit (optional)"}},{"name":"offset","in":"query","required":false,"description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","schema":{"type":"string","title":"offset (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"wallet_address":{"type":"string"},"transactions":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"block_hash":{"type":"string"},"block_number":{"type":"string"},"block_time":{"type":"string"},"block_version":{"type":"number"},"chain":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"data":{"type":"string"},"gas_price":{"type":"string"},"hash":{"type":"string"},"index":{"type":"string"},"max_fee_per_gas":{"type":"string"},"max_priority_fee_per_gas":{"type":"string"},"nonce":{"type":"string"},"transaction_type":{"type":"string"},"value":{"type":"string"},"decoded":{"type":"object"},"logs":{"type":"array"}}}},"errors":{"type":"object"},"warnings":{"type":"array"},"next_offset":{"type":"string"},"request_time":{"type":"string"},"response_time":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"path"},"chain":{"type":"string","title":"chain (optional)","description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"},"chain_ids":{"type":"string","title":"chain_ids (optional)","description":"Optional. Sim chain IDs and/or tags, e.g. '1,8453' or 'default' Examples: 8453, 1,8453, default","example":"optional (example: 1,8453)","x-parameter-location":"query"},"decode":{"type":"string","title":"decode (optional)","description":"Optional. Set to 'true' to include decoded transaction calldata and logs when available Examples: true, false","example":"optional (example: true)","x-parameter-location":"query"},"limit":{"type":"string","title":"limit (optional)","description":"Optional. Maximum number of transactions to return, 1-100 Examples: 100, 500","example":"optional (example: 100)","x-parameter-location":"query"},"offset":{"type":"string","title":"offset (optional)","description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","x-parameter-location":"query"}},"required":["address"],"additionalProperties":false}}}}}},"/api/wallet/history/{address}":{"get":{"operationId":"get_api_wallet_history_address","summary":"Transaction history - decoded actions with method labels","description":"Transaction history - decoded actions with method labels","tags":["tx-history","transactions","decoded"],"parameters":[{"name":"address","in":"path","required":true,"description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"address (required)"}},{"name":"chain","in":"query","required":false,"description":"Optional. Chain key Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"transactions":{"type":"array"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"path"},"chain":{"type":"string","title":"chain (optional)","description":"Optional. Chain key Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"}},"required":["address"],"additionalProperties":false}}}}}},"/api/wallet/collectibles/{address}":{"get":{"operationId":"get_api_wallet_collectibles_address","summary":"EVM collectibles for a wallet - ERC-721 and ERC-1155 holdings with spam filtering, pagination, and optional spam score explanations","description":"EVM collectibles for a wallet - ERC-721 and ERC-1155 holdings with spam filtering, pagination, and optional spam score explanations","tags":["collectibles","nfts","erc721","erc1155","sim"],"parameters":[{"name":"address","in":"path","required":true,"description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"address (required)"}},{"name":"chain","in":"query","required":false,"description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}},{"name":"chain_ids","in":"query","required":false,"description":"Optional. Sim chain IDs and/or tags, e.g. '1,8453' or 'default' Examples: 8453, 1,8453, default","example":"optional (example: 1,8453)","schema":{"type":"string","title":"chain_ids (optional)"}},{"name":"filter_spam","in":"query","required":false,"description":"Optional. Set to 'false' to include collectibles flagged as spam Examples: false","example":"optional (example: false)","schema":{"type":"string","title":"filter_spam (optional)"}},{"name":"limit","in":"query","required":false,"description":"Optional. Maximum number of entries to return, 1-2500 Examples: 100, 500","example":"optional (example: 100)","schema":{"type":"string","title":"limit (optional)"}},{"name":"offset","in":"query","required":false,"description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","schema":{"type":"string","title":"offset (optional)"}},{"name":"show_spam_scores","in":"query","required":false,"description":"Optional. Set to 'true' to include spam_score and explanations fields Examples: true","example":"optional (example: true)","schema":{"type":"string","title":"show_spam_scores (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"entries":{"type":"array","items":{"type":"object","properties":{"contract_address":{"type":"string"},"token_standard":{"type":"string"},"token_id":{"type":"string"},"chain":{"type":"string"},"chain_id":{"type":"number"},"name":{"type":"string"},"symbol":{"type":"string"},"description":{"type":"string"},"image_url":{"type":"string"},"last_sale_price":{"type":"string"},"metadata":{"type":"object"},"balance":{"type":"string"},"last_acquired":{"type":"string"},"is_spam":{"type":"boolean"},"spam_score":{"type":"number"},"explanations":{"type":"array"}}}},"warnings":{"type":"array"},"next_offset":{"type":"string"},"request_time":{"type":"string"},"response_time":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"path"},"chain":{"type":"string","title":"chain (optional)","description":"Optional. Legacy gateway alias for a single chain name, mapped to chain_ids Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"},"chain_ids":{"type":"string","title":"chain_ids (optional)","description":"Optional. Sim chain IDs and/or tags, e.g. '1,8453' or 'default' Examples: 8453, 1,8453, default","example":"optional (example: 1,8453)","x-parameter-location":"query"},"filter_spam":{"type":"string","title":"filter_spam (optional)","description":"Optional. Set to 'false' to include collectibles flagged as spam Examples: false","example":"optional (example: false)","x-parameter-location":"query"},"limit":{"type":"string","title":"limit (optional)","description":"Optional. Maximum number of entries to return, 1-2500 Examples: 100, 500","example":"optional (example: 100)","x-parameter-location":"query"},"offset":{"type":"string","title":"offset (optional)","description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)","example":"optional (example: eyJvZmZzZXQiOjEwMH0=)","x-parameter-location":"query"},"show_spam_scores":{"type":"string","title":"show_spam_scores (optional)","description":"Optional. Set to 'true' to include spam_score and explanations fields Examples: true","example":"optional (example: true)","x-parameter-location":"query"}},"required":["address"],"additionalProperties":false}}}}}},"/api/wallet/nfts/{address}":{"get":{"operationId":"get_api_wallet_nfts_address","summary":"NFTs held by a wallet - collection, floor price, metadata","description":"NFTs held by a wallet - collection, floor price, metadata","tags":["nfts","wallet-nfts","collections"],"parameters":[{"name":"address","in":"path","required":true,"description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"address (required)"}},{"name":"chain","in":"query","required":false,"description":"Optional. Chain key Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number"},"nfts":{"type":"array"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"path"},"chain":{"type":"string","title":"chain (optional)","description":"Optional. Chain key Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"}},"required":["address"],"additionalProperties":false}}}}}},"/api/wallet/defi-positions/{address}":{"get":{"operationId":"get_api_wallet_defi_positions_address","summary":"Active DeFi positions - lending, LP, staking across protocols","description":"Active DeFi positions - lending, LP, staking across protocols","tags":["defi-positions","lending","staking","lp"],"parameters":[{"name":"address","in":"path","required":true,"description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"address (required)"}},{"name":"chain","in":"query","required":false,"description":"Optional. Chain key Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"positions":{"type":"array"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"path"},"chain":{"type":"string","title":"chain (optional)","description":"Optional. Chain key Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"}},"required":["address"],"additionalProperties":false}}}}}},"/api/swap/quote":{"get":{"operationId":"get_api_swap_quote","summary":"Best swap route + price across DEX aggregators via LI.FI","description":"Best swap route + price across DEX aggregators via LI.FI","tags":["swap","dex-aggregator","quote"],"parameters":[{"name":"fromAddress","in":"query","required":true,"description":"Required. Sender wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"fromAddress (required)"}},{"name":"fromAmount","in":"query","required":true,"description":"Required. Amount in smallest unit Examples: 1000000000000000","example":"required (example: 1000)","schema":{"type":"string","title":"fromAmount (required)"}},{"name":"fromChain","in":"query","required":true,"description":"Required. Source chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","schema":{"type":"string","title":"fromChain (required)"}},{"name":"fromToken","in":"query","required":true,"description":"Required. Source token address Examples: 0x4200000000000000000000000000000000000006","example":"required (example: 0x4200000000000000000000000000000000000006)","schema":{"type":"string","title":"fromToken (required)"}},{"name":"toChain","in":"query","required":true,"description":"Required. Destination chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","schema":{"type":"string","title":"toChain (required)"}},{"name":"toToken","in":"query","required":true,"description":"Required. Destination token address Examples: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","example":"required (example: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913)","schema":{"type":"string","title":"toToken (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"fromAmount":{"type":"string"},"toAmount":{"type":"string"},"executionDuration":{"type":"number"},"tool":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"fromAddress":{"type":"string","title":"fromAddress (required)","description":"Required. Sender wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"query"},"fromAmount":{"type":"string","title":"fromAmount (required)","description":"Required. Amount in smallest unit Examples: 1000000000000000","example":"required (example: 1000)","x-parameter-location":"query"},"fromChain":{"type":"string","title":"fromChain (required)","description":"Required. Source chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","x-parameter-location":"query"},"fromToken":{"type":"string","title":"fromToken (required)","description":"Required. Source token address Examples: 0x4200000000000000000000000000000000000006","example":"required (example: 0x4200000000000000000000000000000000000006)","x-parameter-location":"query"},"toChain":{"type":"string","title":"toChain (required)","description":"Required. Destination chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","x-parameter-location":"query"},"toToken":{"type":"string","title":"toToken (required)","description":"Required. Destination token address Examples: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","example":"required (example: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913)","x-parameter-location":"query"}},"required":["fromAddress","fromAmount","fromChain","fromToken","toChain","toToken"],"additionalProperties":false}}}}}},"/api/bridge/quote":{"get":{"operationId":"get_api_bridge_quote","summary":"Cross-chain bridge quote - route, fee, ETA via LI.FI","description":"Cross-chain bridge quote - route, fee, ETA via LI.FI","tags":["bridge","cross-chain","quote"],"parameters":[{"name":"fromAddress","in":"query","required":true,"description":"Required. Sender wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"fromAddress (required)"}},{"name":"fromAmount","in":"query","required":true,"description":"Required. Amount in smallest unit Examples: 1000000000000000","example":"required (example: 1000)","schema":{"type":"string","title":"fromAmount (required)"}},{"name":"fromChain","in":"query","required":true,"description":"Required. Source chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","schema":{"type":"string","title":"fromChain (required)"}},{"name":"fromToken","in":"query","required":true,"description":"Required. Source token address Examples: 0x4200000000000000000000000000000000000006","example":"required (example: 0x4200000000000000000000000000000000000006)","schema":{"type":"string","title":"fromToken (required)"}},{"name":"toChain","in":"query","required":true,"description":"Required. Destination chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","schema":{"type":"string","title":"toChain (required)"}},{"name":"toToken","in":"query","required":true,"description":"Required. Destination token address Examples: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","example":"required (example: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913)","schema":{"type":"string","title":"toToken (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"toAmount":{"type":"string"},"executionDuration":{"type":"number"},"feeCosts":{"type":"array"},"tool":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"fromAddress":{"type":"string","title":"fromAddress (required)","description":"Required. Sender wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"query"},"fromAmount":{"type":"string","title":"fromAmount (required)","description":"Required. Amount in smallest unit Examples: 1000000000000000","example":"required (example: 1000)","x-parameter-location":"query"},"fromChain":{"type":"string","title":"fromChain (required)","description":"Required. Source chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","x-parameter-location":"query"},"fromToken":{"type":"string","title":"fromToken (required)","description":"Required. Source token address Examples: 0x4200000000000000000000000000000000000006","example":"required (example: 0x4200000000000000000000000000000000000006)","x-parameter-location":"query"},"toChain":{"type":"string","title":"toChain (required)","description":"Required. Destination chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","x-parameter-location":"query"},"toToken":{"type":"string","title":"toToken (required)","description":"Required. Destination token address Examples: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","example":"required (example: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913)","x-parameter-location":"query"}},"required":["fromAddress","fromAmount","fromChain","fromToken","toChain","toToken"],"additionalProperties":false}}}}}},"/api/gas/prices":{"get":{"operationId":"get_api_gas_prices","summary":"Gas prices across EVM chains - fast, standard, slow in gwei","description":"Gas prices across EVM chains - fast, standard, slow in gwei","tags":["gas","gas-price","evm"],"parameters":[{"name":"chain","in":"query","required":false,"description":"Optional. Chain name (ethereum, base, arbitrum, etc.) Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"fast":{"type":"string"},"standard":{"type":"string"},"slow":{"type":"string"},"baseFee":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"chain":{"type":"string","title":"chain (optional)","description":"Optional. Chain name (ethereum, base, arbitrum, etc.) Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"}},"additionalProperties":false}}}}}},"/api/gas/estimate":{"get":{"operationId":"get_api_gas_estimate","summary":"Gas estimate for a transaction type - transfer, swap, bridge, mint, etc.","description":"Gas estimate for a transaction type - transfer, swap, bridge, mint, etc.","tags":["gas-estimate","transaction-cost"],"parameters":[{"name":"chain","in":"query","required":true,"description":"Required. Chain name Examples: base, ethereum, arbitrum","example":"required (example: base)","schema":{"type":"string","title":"chain (required)"}},{"name":"txType","in":"query","required":true,"description":"Required. Transaction type (transfer, erc20_transfer, swap_simple, bridge, nft_mint, lending_deposit, etc.) Examples: swap_simple, transfer","example":"required (example: swap_simple)","schema":{"type":"string","title":"txType (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"estimatedGas":{"type":"number"},"gasCostNative":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"chain":{"type":"string","title":"chain (required)","description":"Required. Chain name Examples: base, ethereum, arbitrum","example":"required (example: base)","x-parameter-location":"query"},"txType":{"type":"string","title":"txType (required)","description":"Required. Transaction type (transfer, erc20_transfer, swap_simple, bridge, nft_mint, lending_deposit, etc.) Examples: swap_simple, transfer","example":"required (example: swap_simple)","x-parameter-location":"query"}},"required":["chain","txType"],"additionalProperties":false}}}}}},"/api/swap/slippage-check":{"get":{"operationId":"get_api_swap_slippage_check","summary":"Simulated swap to detect MEV/sandwich risk and actual slippage","description":"Simulated swap to detect MEV/sandwich risk and actual slippage","tags":["slippage","mev","sandwich-attack"],"parameters":[{"name":"amount","in":"query","required":true,"description":"Required. Amount to swap","example":"required (example: 1000)","schema":{"type":"string","title":"amount (required)"}},{"name":"fromToken","in":"query","required":true,"description":"Required. Source token address Examples: 0x4200000000000000000000000000000000000006","example":"required (example: 0x4200000000000000000000000000000000000006)","schema":{"type":"string","title":"fromToken (required)"}},{"name":"toToken","in":"query","required":true,"description":"Required. Destination token address Examples: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","example":"required (example: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913)","schema":{"type":"string","title":"toToken (required)"}},{"name":"chain","in":"query","required":false,"description":"Optional. Chain name Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"estimatedSlippage":{"type":"number"},"mevRisk":{"type":"string"},"recommendation":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"amount":{"type":"string","title":"amount (required)","description":"Required. Amount to swap","example":"required (example: 1000)","x-parameter-location":"query"},"fromToken":{"type":"string","title":"fromToken (required)","description":"Required. Source token address Examples: 0x4200000000000000000000000000000000000006","example":"required (example: 0x4200000000000000000000000000000000000006)","x-parameter-location":"query"},"toToken":{"type":"string","title":"toToken (required)","description":"Required. Destination token address Examples: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","example":"required (example: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913)","x-parameter-location":"query"},"chain":{"type":"string","title":"chain (optional)","description":"Optional. Chain name Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"}},"required":["amount","fromToken","toToken"],"additionalProperties":false}}}}}},"/api/bridge/status":{"get":{"operationId":"get_api_bridge_status","summary":"Track a bridge transaction - pending, confirmed, complete","description":"Track a bridge transaction - pending, confirmed, complete","tags":["bridge-status","tracking","cross-chain"],"parameters":[{"name":"bridge","in":"query","required":true,"description":"Required. Bridge tool name","example":"required (example: value)","schema":{"type":"string","title":"bridge (required)"}},{"name":"fromChain","in":"query","required":true,"description":"Required. Source chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","schema":{"type":"string","title":"fromChain (required)"}},{"name":"toChain","in":"query","required":true,"description":"Required. Destination chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","schema":{"type":"string","title":"toChain (required)"}},{"name":"txHash","in":"query","required":true,"description":"Required. Source chain transaction hash Examples: 0x1111111111111111111111111111111111111111111111111111111111111111, 0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","example":"required (example: 0x1111111111111111111111111111111111111111111111111111111111111111)","schema":{"type":"string","title":"txHash (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"substatus":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"bridge":{"type":"string","title":"bridge (required)","description":"Required. Bridge tool name","example":"required (example: value)","x-parameter-location":"query"},"fromChain":{"type":"string","title":"fromChain (required)","description":"Required. Source chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","x-parameter-location":"query"},"toChain":{"type":"string","title":"toChain (required)","description":"Required. Destination chain ID Examples: 8453, 1, 42161","example":"required (example: 8453)","x-parameter-location":"query"},"txHash":{"type":"string","title":"txHash (required)","description":"Required. Source chain transaction hash Examples: 0x1111111111111111111111111111111111111111111111111111111111111111, 0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","example":"required (example: 0x1111111111111111111111111111111111111111111111111111111111111111)","x-parameter-location":"query"}},"required":["bridge","fromChain","toChain","txHash"],"additionalProperties":false}}}}}},"/api/analytics/chain-stats":{"get":{"operationId":"get_api_analytics_chain_stats","summary":"Chain-level stats - TVL, active chains, token symbols","description":"Chain-level stats - TVL, active chains, token symbols","tags":["chain-stats","network-stats","tps"],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"tvl":{"type":"number"},"tokenSymbol":{"type":"string"}}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/api/chain/supported":{"get":{"operationId":"get_api_chain_supported","summary":"List all supported chains with RPCs, explorers, native tokens","description":"List all supported chains with RPCs, explorers, native tokens","tags":["chains","supported-networks","multichain"],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"key":{"type":"string"},"nativeToken":{"type":"object"}}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"}}},"/api/chain/token-list/{chainId}":{"get":{"operationId":"get_api_chain_token_list_chainId","summary":"Canonical token addresses and metadata per chain","description":"Canonical token addresses and metadata per chain","tags":["token-list","addresses","canonical"],"parameters":[{"name":"chainId","in":"path","required":true,"description":"Required. Chain ID or key Examples: 8453, 1, 42161","example":"required (example: 8453)","schema":{"type":"string","title":"chainId (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"}}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"chainId":{"type":"string","title":"chainId (required)","description":"Required. Chain ID or key Examples: 8453, 1, 42161","example":"required (example: 8453)","x-parameter-location":"path"}},"required":["chainId"],"additionalProperties":false}}}}}},"/api/chain/block-height/{chain}":{"get":{"operationId":"get_api_chain_block_height_chain","summary":"Latest block number for a chain","description":"Latest block number for a chain","tags":["block-height","latest-block","finality"],"parameters":[{"name":"chain","in":"path","required":true,"description":"Required. Chain name (ethereum, base, etc.) Examples: base, ethereum, arbitrum","example":"required (example: base)","schema":{"type":"string","title":"chain (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string"},"blockNumber":{"type":"number"},"timestamp":{"type":"number"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"chain":{"type":"string","title":"chain (required)","description":"Required. Chain name (ethereum, base, etc.) Examples: base, ethereum, arbitrum","example":"required (example: base)","x-parameter-location":"path"}},"required":["chain"],"additionalProperties":false}}}}}},"/api/social/token-mentions/{symbol}":{"get":{"operationId":"get_api_social_token_mentions_symbol","summary":"Social volume - Twitter/Farcaster mention count for a token","description":"Social volume - Twitter/Farcaster mention count for a token","tags":["social-mentions","twitter","farcaster"],"parameters":[{"name":"symbol","in":"path","required":true,"description":"Required. Token symbol.\nTry one of these 10 examples: BTC, ETH, SOL, LINK, UNI, AAVE, MKR, DOGE, PEPE, ARB","example":"required (example: ETH)","schema":{"type":"string","title":"symbol (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"mentions24h":{"type":"number"},"trend":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"symbol":{"type":"string","title":"symbol (required)","description":"Required. Token symbol.\nTry one of these 10 examples: BTC, ETH, SOL, LINK, UNI, AAVE, MKR, DOGE, PEPE, ARB","example":"required (example: ETH)","x-parameter-location":"path"}},"required":["symbol"],"additionalProperties":false}}}}}},"/api/social/sentiment/{symbol}":{"get":{"operationId":"get_api_social_sentiment_symbol","summary":"Bullish/bearish sentiment score per token","description":"Bullish/bearish sentiment score per token","tags":["sentiment","bullish-bearish","social-score"],"parameters":[{"name":"symbol","in":"path","required":true,"description":"Required. Token symbol.\nTry one of these 10 examples: BTC, ETH, SOL, LINK, UNI, AAVE, MKR, DOGE, PEPE, ARB","example":"required (example: ETH)","schema":{"type":"string","title":"symbol (required)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string"},"sentimentScore":{"type":"number"},"sentiment":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"symbol":{"type":"string","title":"symbol (required)","description":"Required. Token symbol.\nTry one of these 10 examples: BTC, ETH, SOL, LINK, UNI, AAVE, MKR, DOGE, PEPE, ARB","example":"required (example: ETH)","x-parameter-location":"path"}},"required":["symbol"],"additionalProperties":false}}}}}},"/api/agent/portfolio-rebalance/{address}":{"get":{"operationId":"get_api_agent_portfolio_rebalance_address","summary":"Suggested portfolio rebalance based on current holdings + yield opportunities","description":"Suggested portfolio rebalance based on current holdings + yield opportunities","tags":["rebalance","portfolio","yield-optimization","agent"],"parameters":[{"name":"address","in":"path","required":true,"description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","schema":{"type":"string","title":"address (required)"}},{"name":"riskTolerance","in":"query","required":false,"description":"Optional. low, medium, high","example":"optional (example: value)","schema":{"type":"string","title":"riskTolerance (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"currentAllocation":{"type":"object"},"suggestedAllocation":{"type":"object"},"actions":{"type":"array"},"expectedApyImprovement":{"type":"number"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"address":{"type":"string","title":"address (required)","description":"Required. Wallet address Examples: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0x1111111111111111111111111111111111111111","example":"required (example: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)","x-parameter-location":"path"},"riskTolerance":{"type":"string","title":"riskTolerance (optional)","description":"Optional. low, medium, high","example":"optional (example: value)","x-parameter-location":"query"}},"required":["address"],"additionalProperties":false}}}}}},"/api/agent/tx-summary/{txHash}":{"get":{"operationId":"get_api_agent_tx_summary_txHash","summary":"Lightweight transaction summary from raw RPC data - action label, counterparties, status, gas, and log count","description":"Lightweight transaction summary from raw RPC data - action label, counterparties, status, gas, and log count","tags":["tx-summary","rpc","selector-label","agent"],"parameters":[{"name":"txHash","in":"path","required":true,"description":"Required. Transaction hash Examples: 0x1111111111111111111111111111111111111111111111111111111111111111, 0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","example":"required (example: 0x1111111111111111111111111111111111111111111111111111111111111111)","schema":{"type":"string","title":"txHash (required)"}},{"name":"chain","in":"query","required":false,"description":"Optional. Chain name Examples: base, ethereum, arbitrum","example":"optional (example: base)","schema":{"type":"string","title":"chain (optional)"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string"},"action":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"value":{"type":"string"},"tokens":{"type":"array"},"gasUsed":{"type":"string"}}}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Discovery input schema. Path parameters are still supplied in the URL and query parameters in the query string at runtime.","properties":{"txHash":{"type":"string","title":"txHash (required)","description":"Required. Transaction hash Examples: 0x1111111111111111111111111111111111111111111111111111111111111111, 0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","example":"required (example: 0x1111111111111111111111111111111111111111111111111111111111111111)","x-parameter-location":"path"},"chain":{"type":"string","title":"chain (optional)","description":"Optional. Chain name Examples: base, ethereum, arbitrum","example":"optional (example: base)","x-parameter-location":"query"}},"required":["txHash"],"additionalProperties":false}}}}}}}}