{ "openapi": "3.0.3", "info": { "title": "Einstein AI x402 API", "version": "1.0.0", "description": "AI-powered blockchain intelligence API with x402 micropayments. Pay-per-request using USDC on Base. No API keys required.", "contact": { "name": "Einstein AI", "url": "https://emc2ai.io", "email": "ainstein1@outlook.com" }, "license": { "name": "MIT", "url": "https://opensource.org/licenses/MIT" }, "x-logo": { "url": "https://emc2ai.io/og-x402-service.png" }, "x-x402-enabled": true, "x-x402-networks": ["base", "solana"], "x-x402-min-price": "$0.25", "x-x402-max-price": "$1.00", "x-x402-version": "2.0", "x-x402-protocol": "x402", "x-guidance": "Pay-per-call blockchain intelligence via x402 (USDC on Base, eip155:8453). POST a JSON body to any /x402/bitquery/* or /x402/einstein/* endpoint; an unpaid request returns a 402 challenge with payment requirements. Each operation requestBody documents required parameters. Chart-forecast endpoints (tokenchart/ohlcv/candles) add TimesFM+Kronos predictions on the analyzed variant." }, "servers": [ { "url": "https://emc2ai.io", "description": "Production (Base Mainnet USDC payments)", "x-x402-enabled": true, "x-x402-version": "2.0" } ], "tags": [ { "name": "AI Agent", "description": "General-purpose AI agent with autonomous reasoning" }, { "name": "Market Data", "description": "Real-time token prices, charts, and market metrics" }, { "name": "Market Analysis", "description": "Top gainers, volume analysis, and market trends" }, { "name": "Whale Intelligence", "description": "Large wallet tracking and accumulation patterns" }, { "name": "Launchpad", "description": "New token launches on Pump.fun, Zora, and bonding curves" }, { "name": "Security Audit", "description": "Rug pull detection, MEV analysis, and token security" }, { "name": "DeFi", "description": "Cross-chain arbitrage and liquidity analysis" }, { "name": "Whale Intelligence", "description": "Wallet holdings and portfolio analysis" }, { "name": "Risk Analysis", "description": "Token security and holder concentration metrics" }, { "name": "Reports", "description": "Comprehensive multi-chain investment analysis" } ], "paths": { "/x402/einstein/report": { "post": { "operationId": "einsteinReport", "summary": "Query Einstein AI Agent", "description": "Send any prompt to Einstein AI agent for autonomous analysis. Einstein selects appropriate tools, analyzes blockchain data, and provides intelligent insights.", "tags": ["AI Agent"], "x-x402-price": "$0.50", "x-x402-network": "base", "x-x402-asset": "USDC", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["prompt"], "properties": { "prompt": { "type": "string", "description": "The prompt or question to send to Einstein AI agent", "example": "What are the top whale movements on Base in the last 24 hours?" }, "roomId": { "type": "string", "description": "Optional room ID for conversation context" }, "userId": { "type": "string", "description": "Optional user ID for tracking" }, "metadata": { "type": "object", "description": "Optional metadata for the request" } } }, "example": { "prompt": "Analyze the top whale movements on Base chain in the last 24 hours" } } } }, "responses": { "200": { "description": "Successful AI analysis response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EinsteinResponse" } } } }, "402": { "description": "Payment required - include X-PAYMENT header with signed USDC authorization", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentChallenge" } } } } }, "x-x402-price-atomic": "500000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.50", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.50" } } } }, "/x402/bitquery/latest-pairs": { "post": { "operationId": "latestPairs", "summary": "Latest Deployed Tokens", "description": "Query latest deployed tokens on-chain with liquidity pool data. Supported chains: base, ethereum, bsc, arbitrum, polygon, optimism. Default chain: base. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Market Data"], "x-x402-price": "$0.40", "x-x402-network": "base", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "400000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.40", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.40" } } } }, "/x402/bitquery/tokenchart": { "post": { "operationId": "tokenChart", "summary": "Token Price Chart", "description": "Get price and timestamp data for any token with customizable time periods. Supported chains: base, ethereum, bsc, arbitrum, polygon, optimism, zksync. Default chain: base. Required params: tokenAddress.", "tags": ["Market Data"], "x-x402-price": "$0.25", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["tokenAddress"], "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync" ], "default": "base", "description": "Blockchain network" }, "tokenAddress": { "type": "string", "description": "Token contract address", "example": "0x..." }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for chart data" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "250000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.25", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.25" } } } }, "/x402/bitquery/ohlcv": { "post": { "operationId": "tokenOHLCV", "summary": "OHLCV Candlestick Chart", "description": "Get full OHLCV (Open, High, Low, Close, Volume) candlestick data for any token. Returns complete candlestick bars with volume metrics for technical analysis. Supported chains: base, ethereum, bsc, arbitrum, polygon, optimism. Default chain: base. Required params: tokenAddress.", "tags": ["Market Data"], "x-x402-price": "$0.35", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["tokenAddress"], "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync" ], "default": "base", "description": "Blockchain network" }, "tokenAddress": { "type": "string", "description": "Token contract address", "example": "0x..." }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for chart data" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "350000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.35", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.35" } } } }, "/x402/bitquery/top-tokens": { "post": { "operationId": "topTokens", "summary": "Top Tokens", "description": "Find top performing tokens by price change, sorted by percentage gain. Supported chains: base, ethereum, bsc, arbitrum, polygon, optimism, zksync. Default chain: base. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Market Analysis"], "x-x402-price": "$0.55", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "550000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.55", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.55" } } } }, "/x402/bitquery/topvolume": { "post": { "operationId": "topVolume", "summary": "Top Gainers/Losers", "description": "Analyze tokens with highest trading volume in specified time period. Supported chains: base, ethereum, bsc, arbitrum, polygon, optimism, zksync, solana. Default chain: base. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Market Analysis"], "x-x402-price": "$0.55", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "550000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.55", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.55" } } } }, "/x402/bitquery/virtual-pools": { "post": { "operationId": "virtualPools", "summary": "Virtuals Protocol Tokens", "description": "Track tokens paired with virtual token. Supported chains: base. Default chain: base. Optional params: limit (1-500, default 50), timeperiod (1h/4h/12h/24h/7d, default 24h), sortBy (volumeUsd/swaps/priceChange, default volumeUsd), minVolumeUsd (default 100).", "tags": ["Market Analysis"], "x-x402-price": "$0.55", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "description": "Parameters for Virtuals Protocol token pools scanner", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Max pools to return (1-500, default 50)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d"], "default": "24h", "description": "Time period (1h/4h/12h/24h/7d)" }, "sortBy": { "type": "string", "enum": ["volumeUsd", "swaps", "priceChange"], "default": "volumeUsd", "description": "Sort field (volumeUsd/swaps/priceChange)" }, "minVolumeUsd": { "type": "number", "default": 100, "description": "Minimum volume in USD (default 100)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "550000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.55", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.55" } } } }, "/x402/bitquery/wallet-holdings": { "post": { "operationId": "walletHoldings", "summary": "Wallet Holdings", "description": "Analyze complete token holdings and portfolio composition for any wallet. Supported chains: ethereum, base, bsc, arbitrum, polygon. Default chain: ethereum. Required params: walletAddress.", "tags": ["Whale Intelligence"], "x-x402-price": "$0.55", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["walletAddress"], "properties": { "chain": { "type": "string", "enum": ["ethereum", "base", "bsc", "arbitrum", "polygon"], "default": "ethereum", "description": "Blockchain network" }, "walletAddress": { "type": "string", "description": "Wallet address to analyze", "example": "0x..." } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "550000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.55", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.55" } } } }, "/x402/bitquery/holderconcentration": { "post": { "operationId": "holderConcentration", "summary": "Holder Concentration", "description": "Calculate holder concentration metrics and distribution analysis for any token. Supported chains: ethereum, base, bsc, arbitrum, polygon. Default chain: base. Required params: tokenAddress.", "tags": ["Risk Analysis"], "x-x402-price": "$0.55", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["tokenAddress"], "properties": { "chain": { "type": "string", "enum": ["ethereum", "base", "bsc", "arbitrum", "polygon"], "default": "base", "description": "Blockchain network" }, "tokenAddress": { "type": "string", "description": "Token contract address", "example": "0x..." } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "550000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.55", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.55" } } } }, "/x402/bitquery/zora-launches": { "post": { "operationId": "zoraLaunches", "summary": "Zora Launches", "description": "Track new token launches on Zora platform with creation data. Supported chains: base. Default chain: base. Optional params: limit (1-25, default 15), timeperiod (1h/4h/12h/24h/7d/30d, default 24h).", "tags": ["Launchpad"], "x-x402-price": "$0.75", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "description": "Parameters for Zora Launchpad token queries", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 25, "default": 15, "description": "Max results to return (1-25, default 15)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "30d"], "default": "24h", "description": "Time period (1h/4h/12h/24h/7d/30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "750000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.75", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.75" } } } }, "/x402/bitquery/zora-volume": { "post": { "operationId": "zoraVolume", "summary": "Zora Volume", "description": "Analyze trading volume and activity for Zora-launched tokens. Supported chains: base. Default chain: base. Optional params: limit (1-25, default 15), timeperiod (1h/4h/12h/24h/7d/30d, default 24h).", "tags": ["Launchpad"], "x-x402-price": "$0.75", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "description": "Parameters for Zora Launchpad token queries", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 25, "default": 15, "description": "Max results to return (1-25, default 15)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "30d"], "default": "24h", "description": "Time period (1h/4h/12h/24h/7d/30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "750000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.75", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.75" } } } }, "/x402/bitquery/pumpfun-launches": { "post": { "operationId": "pumpfunLaunches", "summary": "Pump.fun Launches", "description": "Monitor new token launches on Pump.fun platform. Supported chains: solana. Default chain: solana. Optional params: limit (1-20, default 10), timeperiod (1h/4h/12h/24h, default 24h), minVolumeUsd (default 10), sortBy (volume/time/progress, default time).", "tags": ["Launchpad"], "x-x402-price": "$0.75", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "description": "Parameters for Pump.fun launch monitoring", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 20, "default": 10, "description": "Max launches to return (1-20, default 10)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h"], "default": "24h", "description": "Time period (1h/4h/12h/24h)" }, "minVolumeUsd": { "type": "number", "default": 10, "description": "Minimum volume in USD (default 10)" }, "sortBy": { "type": "string", "enum": ["volume", "time", "progress"], "default": "time", "description": "Sort order (volume/time/progress)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "750000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.75", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.75" } } } }, "/x402/bitquery/pumpfun-volume": { "post": { "operationId": "pumpfunVolume", "summary": "Pump.fun Volume", "description": "Track trading volume for Pump.fun tokens. Supported chains: solana. Default chain: solana. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Launchpad"], "x-x402-price": "$0.75", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "750000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.75", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.75" } } } }, "/x402/bitquery/pumpfun-graduation": { "post": { "operationId": "pumpfunGraduation", "summary": "Pump.fun Graduation", "description": "Identify tokens graduating from Pump.fun bonding curve to DEX. Supported chains: solana. Default chain: solana. Optional params: limit (1-200, default 30), minProgressPct (0-100, default 50).", "tags": ["Launchpad"], "x-x402-price": "$0.75", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "description": "Parameters for Pump.fun graduation tracking", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 200, "default": 30, "description": "Max tokens to return (1-200, default 30)" }, "minProgressPct": { "type": "number", "minimum": 0, "maximum": 100, "default": 50, "description": "Minimum bonding curve progress percentage (0-100, default 50)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "750000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.75", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.75" } } } }, "/x402/bitquery/liquidityshifts": { "post": { "operationId": "liquidityShifts", "summary": "Liquidity Shifts", "description": "Detect significant liquidity additions or removals across DEX pools. Supported chains: ethereum, base, bsc, arbitrum, polygon, optimism, zksync. Default chain: ethereum. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Market Analysis"], "x-x402-price": "$0.75", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "750000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.75", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.75" } } } }, "/x402/bitquery/whaleintel": { "post": { "operationId": "whaleIntel", "summary": "Whale Accumulation", "description": "Track large wallet movements and accumulation patterns. Supported chains: ethereum, base, bsc, arbitrum, polygon. Default chain: base. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Whale Intelligence"], "x-x402-price": "$1.00", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "1000000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$1.00", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "1.00" } } } }, "/x402/bitquery/smartmoney": { "post": { "operationId": "smartMoney", "summary": "Smart Money Tracking", "description": "Identify wallets with consistent profitable trading patterns. Supported chains: ethereum, base, bsc, arbitrum, polygon. Default chain: base. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Whale Intelligence"], "x-x402-price": "$1.00", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "1000000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$1.00", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "1.00" } } } }, "/x402/bitquery/dexcapital": { "post": { "operationId": "dexCapital", "summary": "DEX Capital Concentration", "description": "Analyze capital concentration across different DEX protocols. Supported chains: bsc, base, ethereum, arbitrum, polygon, optimism, zksync. Default chain: base. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Market Analysis"], "x-x402-price": "$1.00", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "1000000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$1.00", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "1.00" } } } }, "/x402/bitquery/tokensniping": { "post": { "operationId": "tokenSniping", "summary": "Token Sniping", "description": "Detect early token purchase patterns and bot activity. Supported chains: ethereum, base, bsc, arbitrum, polygon. Default chain: base. Required params: tokenAddress.", "tags": ["Security Audit"], "x-x402-price": "$1.00", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["tokenAddress"], "properties": { "chain": { "type": "string", "enum": ["ethereum", "base", "bsc", "arbitrum", "polygon"], "default": "base", "description": "Blockchain network" }, "tokenAddress": { "type": "string", "description": "Token contract address", "example": "0x..." } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "1000000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$1.00", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "1.00" } } } }, "/x402/bitquery/investment-report": { "post": { "operationId": "investmentReport", "summary": "Investment Report", "description": "Generate comprehensive investment analysis report for any token. Supported chains: base, ethereum, bsc, solana, arbitrum, polygon, optimism, zksync. Default chain: base. Required params: chains.", "tags": ["Reports"], "x-x402-price": "$1.15", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["chains"], "properties": { "chains": { "type": "array", "items": { "type": "string", "enum": [ "base", "ethereum", "bsc", "solana", "arbitrum", "polygon", "optimism", "zksync" ] }, "description": "List of chains to include in report" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "1150000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$1.15", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "1.15" } } } }, "/x402/bitquery/mevdetection": { "post": { "operationId": "mevDetection", "summary": "MEV Detection", "description": "Detect MEV (Maximal Extractable Value) attacks and sandwich trades. Supported chains: ethereum, base, bsc, arbitrum, polygon. Default chain: ethereum. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Security Audit"], "x-x402-price": "$1.15", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "1150000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$1.15", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "1.15" } } } }, "/x402/bitquery/arbitragescanner": { "post": { "operationId": "arbitrageScanner", "summary": "Arbitrage Scanner", "description": "Find cross-chain and cross-DEX arbitrage opportunities. Supported chains: ethereum, base, bsc, arbitrum, polygon, optimism. Default chain: ethereum. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["DeFi"], "x-x402-price": "$1.15", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "1150000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$1.15", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "1.15" } } } }, "/x402/bitquery/rug-pull-scanner": { "post": { "operationId": "rugPullScanner", "summary": "Rug Pull Scanner", "description": "Analyze token security risks and detect potential rug pulls. Supported chains: ethereum, base, bsc, arbitrum, polygon. Default chain: base. Required params: tokenAddress.", "tags": ["Security Audit"], "x-x402-price": "$1.15", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["tokenAddress"], "properties": { "chain": { "type": "string", "enum": ["ethereum", "base", "bsc", "arbitrum", "polygon"], "default": "base", "description": "Blockchain network" }, "tokenAddress": { "type": "string", "description": "Token contract address", "example": "0x..." } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "1150000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$1.15", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "1.15" } } } }, "/x402/bitquery/bscalpha": { "post": { "operationId": "BSCAlphaSignals", "summary": "BSC Alpha Signals", "description": "Aggregated alpha signals for early opportunities (BSC only). Supported chains: bsc. Default chain: bsc. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Market Analysis"], "x-x402-price": "$0.75", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "750000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.75", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.75" } } } }, "/x402/bitquery/toptraders": { "post": { "operationId": "TopTraders", "summary": "Top Traders", "description": "Top meme/bonding-curve traders on Four.meme platform (BSC only). Supported chains: bsc. Default chain: bsc. Required params: none (chain/limit/timeperiod are optional and defaulted).", "tags": ["Whale Intelligence"], "x-x402-price": "$1.00", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "1000000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$1.00", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "1.00" } } } }, "/x402/bitquery/candles": { "post": { "operationId": "tokenChartCandles", "summary": "Token OHLCV Candles", "description": "OHLCV candlestick chart data (alias of tokenchart). Raw: data only. Analyzed: + TimesFM/Kronos dual-model forecast. Get price and timestamp data for any token with customizable time periods. Supported chains: base, ethereum, bsc, arbitrum, polygon, optimism, zksync. Default chain: base. Required params: tokenAddress.", "tags": ["Market Data"], "x-x402-price": "$0.25", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["tokenAddress"], "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync" ], "default": "base", "description": "Blockchain network" }, "tokenAddress": { "type": "string", "description": "Token contract address", "example": "0x..." }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for chart data" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/BitquerySuccess" }, "402": { "$ref": "#/components/responses/PaymentRequired" } }, "x-x402-price-atomic": "250000", "x-x402-decimals": 6, "x-x402-asset-address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "x-x402-payment": { "required": true, "scheme": "exact", "price": "$0.25", "network": "eip155:8453", "asset": "USDC", "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "decimals": 6 }, "x-x402-network": "base", "externalDocs": { "description": "Einstein AI x402 Documentation", "url": "https://emc2ai.io/docs" }, "x-payment-info": { "protocols": [ { "x402": {} } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.25" } } } } }, "components": { "schemas": { "EinsteinRequest": { "type": "object", "required": ["prompt"], "properties": { "prompt": { "type": "string", "description": "The prompt or question to send to Einstein AI agent", "example": "What are the top whale movements on Base in the last 24 hours?" }, "roomId": { "type": "string", "description": "Optional room ID for conversation context" }, "userId": { "type": "string", "description": "Optional user ID for tracking" }, "metadata": { "type": "object", "description": "Optional metadata for the request" } } }, "EinsteinResponse": { "type": "object", "properties": { "status": { "type": "string", "enum": ["completed", "error"], "description": "Request status" }, "roomId": { "type": "string", "description": "Room ID for this conversation" }, "prompt": { "type": "string", "description": "The original prompt" }, "userId": { "type": "string", "description": "User ID" }, "payment": { "$ref": "#/components/schemas/PaymentReceipt" }, "agent": { "type": "object", "properties": { "id": { "type": "string", "description": "Agent ID" }, "name": { "type": "string", "description": "Agent name" } } }, "response": { "type": "object", "properties": { "id": { "type": "string", "description": "Response ID" }, "createdAt": { "type": "integer", "description": "Unix timestamp of response creation" }, "content": { "type": "object", "properties": { "text": { "type": "string", "description": "The AI response text" }, "thought": { "type": "string", "description": "Agent's reasoning process" }, "actions": { "type": "array", "items": { "type": "string" }, "description": "Actions taken by the agent" } } } } } } }, "BitqueryChainRequest": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" } } }, "BitqueryTimeRequest": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } }, "BitqueryLimitRequest": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" } } }, "BitqueryLimitTimeRequest": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } }, "VirtualPoolsRequest": { "type": "object", "description": "Parameters for Virtuals Protocol token pools scanner", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Max pools to return (1-500, default 50)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d"], "default": "24h", "description": "Time period (1h/4h/12h/24h/7d)" }, "sortBy": { "type": "string", "enum": ["volumeUsd", "swaps", "priceChange"], "default": "volumeUsd", "description": "Sort field (volumeUsd/swaps/priceChange)" }, "minVolumeUsd": { "type": "number", "default": 100, "description": "Minimum volume in USD (default 100)" } } }, "ZoraRequest": { "type": "object", "description": "Parameters for Zora Launchpad token queries", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 25, "default": 15, "description": "Max results to return (1-25, default 15)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "30d"], "default": "24h", "description": "Time period (1h/4h/12h/24h/7d/30d)" } } }, "PumpfunLaunchesRequest": { "type": "object", "description": "Parameters for Pump.fun launch monitoring", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 20, "default": 10, "description": "Max launches to return (1-20, default 10)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h"], "default": "24h", "description": "Time period (1h/4h/12h/24h)" }, "minVolumeUsd": { "type": "number", "default": 10, "description": "Minimum volume in USD (default 10)" }, "sortBy": { "type": "string", "enum": ["volume", "time", "progress"], "default": "time", "description": "Sort order (volume/time/progress)" } } }, "PumpfunGraduationRequest": { "type": "object", "description": "Parameters for Pump.fun graduation tracking", "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 200, "default": 30, "description": "Max tokens to return (1-200, default 30)" }, "minProgressPct": { "type": "number", "minimum": 0, "maximum": 100, "default": 50, "description": "Minimum bonding curve progress percentage (0-100, default 50)" } } }, "TokenChartRequest": { "type": "object", "required": ["tokenAddress"], "properties": { "chain": { "type": "string", "enum": ["base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync"], "default": "base", "description": "Blockchain network" }, "tokenAddress": { "type": "string", "description": "Token contract address", "example": "0x..." }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for chart data" } } }, "BitqueryChainLimitRequest": { "type": "object", "properties": { "chain": { "type": "string", "enum": [ "base", "ethereum", "bsc", "arbitrum", "polygon", "optimism", "zksync", "solana" ], "default": "base", "description": "Blockchain network to query" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } }, "BitqueryWalletRequest": { "type": "object", "required": ["walletAddress"], "properties": { "chain": { "type": "string", "enum": ["ethereum", "base", "bsc", "arbitrum", "polygon"], "default": "ethereum", "description": "Blockchain network" }, "walletAddress": { "type": "string", "description": "Wallet address to analyze", "example": "0x..." } } }, "BitqueryHolderRequest": { "type": "object", "required": ["tokenAddress"], "properties": { "chain": { "type": "string", "enum": ["ethereum", "base", "bsc", "arbitrum", "polygon"], "default": "base", "description": "Blockchain network" }, "tokenAddress": { "type": "string", "description": "Token contract address", "example": "0x..." } } }, "BitqueryChainsRequest": { "type": "object", "required": ["chains"], "properties": { "chains": { "type": "array", "items": { "type": "string", "enum": [ "base", "ethereum", "bsc", "solana", "arbitrum", "polygon", "optimism", "zksync" ] }, "description": "List of chains to include in report" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 50, "description": "Number of results to return (max 500)" }, "timeperiod": { "type": "string", "enum": ["1h", "4h", "12h", "24h", "7d", "14d", "30d"], "default": "24h", "description": "Time period for analysis (max 30d)" } } }, "PaymentChallenge": { "type": "object", "properties": { "x402Version": { "type": "integer", "example": 1 }, "error": { "type": "string", "example": "X-PAYMENT header is required" }, "accepts": { "type": "array", "items": { "$ref": "#/components/schemas/PaymentRequirement" } } } }, "PaymentRequirement": { "type": "object", "properties": { "scheme": { "type": "string", "example": "exact" }, "network": { "type": "string", "example": "base" }, "maxAmountRequired": { "type": "string", "example": "500000", "description": "Amount in atomic units (6 decimals for USDC)" }, "asset": { "type": "string", "example": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "description": "USDC contract address on Base" }, "payTo": { "type": "string", "description": "Merchant wallet address" }, "description": { "type": "string" } } }, "PaymentReceipt": { "type": "object", "properties": { "x402Version": { "type": "integer" }, "scheme": { "type": "string" }, "network": { "type": "string" }, "asset": { "type": "string" }, "amount": { "type": "string" }, "txHash": { "type": "string", "description": "On-chain transaction hash" }, "timestamp": { "type": "string", "format": "date-time" } } }, "BitqueryResponse": { "type": "object", "properties": { "status": { "type": "string", "enum": ["completed", "error"] }, "data": { "type": "object", "description": "Query results" }, "analysis": { "type": "string", "description": "AI-generated analysis (included with non-raw endpoints)" }, "payment": { "$ref": "#/components/schemas/PaymentReceipt" }, "metadata": { "type": "object", "properties": { "chain": { "type": "string" }, "timeperiod": { "type": "string" }, "executionTime": { "type": "number" } } } } } }, "responses": { "BitquerySuccess": { "description": "Successful query response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BitqueryResponse" } } } }, "PaymentRequired": { "description": "Payment required - include X-PAYMENT header with signed USDC authorization", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentChallenge" } } } } }, "securitySchemes": { "x402Payment": { "type": "apiKey", "in": "header", "name": "X-PAYMENT", "description": "Base64-encoded signed USDC TransferWithAuthorization payload for x402 payment" } } }, "security": [ { "x402Payment": [] } ] }