{ "openapi": "3.1.0", "info": { "title": "RMI Backend", "description": "Rug Munch Intelligence - institutional-grade crypto intelligence API. 13+ chains, 96 data providers, 8 MCP tools, x402 paid tier, sovereign-first FOSS.", "version": "2026.06.21" }, "paths": { "/live": { "get": { "tags": [ "health" ], "summary": "Liveness", "description": "Kubernetes-style liveness probe. Returns 200 if the process is alive. No dependency checks.", "operationId": "liveness_live_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LivenessResponse" } } } } } } }, "/ready": { "get": { "tags": [ "health" ], "summary": "Readiness", "description": "Kubernetes-style readiness probe. Checks critical dependencies (Redis, PostgreSQL). Returns 200 only when all critical stores are reachable.", "operationId": "readiness_ready_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadinessResponse" } } } } } } }, "/health": { "get": { "tags": [ "health" ], "summary": "Full Health Check", "description": "Comprehensive system health check. Probes Redis, PostgreSQL, Neo4j, Qdrant, ClickHouse, MinIO, and Ethereum RPC. Returns aggregated status with per-store health, latency, and config validation.", "operationId": "health_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__core__health_route__HealthResponse" } } } } } } }, "/": { "get": { "tags": [ "homepage" ], "summary": "Home", "description": "Landing page - returns service metadata.", "operationId": "home__get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HomeResponse" } } } } } } }, "/version": { "get": { "tags": [ "homepage" ], "summary": "Version", "description": "Detailed version info for ops.", "operationId": "version_version_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VersionResponse" } } } } } } }, "/api/v1/auth/jwks": { "get": { "tags": [ "auth" ], "summary": "Get JWKS public key", "description": "JWKS endpoint \u2014 returns the RSA public key for JWT validation.\n\nUsed by walletpress, pryscraper, and degenfeed to validate\ntokens issued by rmi-backend.", "operationId": "jwks_v1_api_v1_auth_jwks_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/v1/auth/google/url": { "get": { "tags": [ "auth" ], "summary": "Google Auth Url", "description": "Get Google OAuth URL.", "operationId": "google_auth_url_api_v1_auth_google_url_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Google Auth Url Api V1 Auth Google Url Get" } } } } } } }, "/api/v1/auth/google/callback": { "get": { "tags": [ "auth" ], "summary": "Google Callback", "description": "Handle Google OAuth redirect.", "operationId": "google_callback_api_v1_auth_google_callback_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Google Callback Api V1 Auth Google Callback Get" } } } } } }, "post": { "tags": [ "auth" ], "summary": "Google Callback Post", "description": "Legacy POST endpoint for manual code exchange.", "operationId": "google_callback_post_api_v1_auth_google_callback_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/v1/auth/github/url": { "get": { "tags": [ "auth" ], "summary": "Github Auth Url", "description": "Get GitHub OAuth URL.", "operationId": "github_auth_url_api_v1_auth_github_url_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Github Auth Url Api V1 Auth Github Url Get" } } } } } } }, "/api/v1/auth/github/callback": { "get": { "tags": [ "auth" ], "summary": "Github Callback", "description": "Handle GitHub OAuth redirect.", "operationId": "github_callback_api_v1_auth_github_callback_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Github Callback Api V1 Auth Github Callback Get" } } } } } } }, "/api/v1/auth/x/url": { "get": { "tags": [ "auth" ], "summary": "X Auth Url", "description": "Get X/Twitter OAuth URL.", "operationId": "x_auth_url_api_v1_auth_x_url_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response X Auth Url Api V1 Auth X Url Get" } } } } } } }, "/api/v1/auth/x/callback": { "get": { "tags": [ "auth" ], "summary": "X Callback", "description": "Handle X/Twitter OAuth redirect.", "operationId": "x_callback_api_v1_auth_x_callback_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X Callback Api V1 Auth X Callback Get" } } } } } } }, "/api/v1/auth/register": { "post": { "tags": [ "auth" ], "summary": "Register Email", "description": "Register a new user with email/password.", "operationId": "register_email_api_v1_auth_register_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailRegisterRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/auth/login": { "post": { "tags": [ "auth" ], "summary": "Login Email", "description": "Login with email/password.", "operationId": "login_email_api_v1_auth_login_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmailLoginRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/auth/user/me": { "get": { "tags": [ "auth" ], "summary": "User Profile Me", "description": "Get current authenticated user profile.", "operationId": "user_profile_me_api_v1_auth_user_me_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserResponse" } } } } } } }, "/api/v1/auth/cookie-token": { "get": { "tags": [ "auth" ], "summary": "Cookie Token", "description": "Return user info from HttpOnly cookie. Used by frontend OAuth callback.", "operationId": "cookie_token_api_v1_auth_cookie_token_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/v1/auth/logout": { "post": { "tags": [ "auth" ], "summary": "Logout", "description": "Clear auth cookies (logout).", "operationId": "logout_api_v1_auth_logout_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/v1/auth/telegram": { "post": { "tags": [ "auth" ], "summary": "Telegram Auth", "description": "Authenticate via Telegram Web App data.", "operationId": "telegram_auth_api_v1_auth_telegram_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TelegramAuthRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/auth/2fa/setup": { "post": { "tags": [ "auth" ], "summary": "Twofa Setup", "operationId": "twofa_setup_api_v1_auth_2fa_setup_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Twofa Setup Api V1 Auth 2Fa Setup Post" } } } } } } }, "/api/v1/auth/2fa/enable": { "post": { "tags": [ "auth" ], "summary": "Twofa Enable", "operationId": "twofa_enable_api_v1_auth_2fa_enable_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TwoFAEnableRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Twofa Enable Api V1 Auth 2Fa Enable Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/auth/2fa/disable": { "post": { "tags": [ "auth" ], "summary": "Twofa Disable", "operationId": "twofa_disable_api_v1_auth_2fa_disable_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Twofa Disable Api V1 Auth 2Fa Disable Post" } } } } } } }, "/api/v1/auth/2fa/status": { "get": { "tags": [ "auth" ], "summary": "Twofa Status", "operationId": "twofa_status_api_v1_auth_2fa_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TwoFAStatusResponse" } } } } } } }, "/api/v1/auth/2fa/verify": { "post": { "tags": [ "auth" ], "summary": "Twofa Verify", "description": "Verify a TOTP code to complete a pending 2FA login.\n\nThis is the 2FA-completion endpoint: it accepts the pending-2FA\n(pre_auth) token issued by ``POST /login`` for accounts with 2FA\nenabled. After a successful code check the caller receives the full\nauth token from ``POST /2fa/login`` (or re-runs login).", "operationId": "twofa_verify_api_v1_auth_2fa_verify_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TwoFAVerifyRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Twofa Verify Api V1 Auth 2Fa Verify Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/auth/2fa/login": { "post": { "tags": [ "auth" ], "summary": "Twofa Login", "operationId": "twofa_login_api_v1_auth_2fa_login_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TwoFALoginRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/auth/me": { "get": { "tags": [ "auth-compat" ], "summary": "Auth Me", "description": "Alias for GET /user/me \u2014 frontend calls /api/v1/auth/me.", "operationId": "auth_me_api_v1_auth_me_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Auth Me Api V1 Auth Me Get" } } } } } } }, "/api/v1/auth/profile": { "get": { "tags": [ "auth-compat" ], "summary": "Auth Profile", "description": "Alias for GET /user/me \u2014 frontend calls /api/v1/auth/profile.", "operationId": "auth_profile_api_v1_auth_profile_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Auth Profile Api V1 Auth Profile Get" } } } } } } }, "/api/v1/auth/wallet": { "post": { "tags": [ "auth-compat" ], "summary": "Auth Wallet", "description": "Wallet auth \u2014 verify signature and return tokens.\n\nBody: {\"address\": \"...\", \"signature\": \"...\", \"message\": \"...\", \"chain\": \"base\"}", "operationId": "auth_wallet_api_v1_auth_wallet_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Auth Wallet Api V1 Auth Wallet Post" } } } } } } }, "/api/v1/auth/change-password": { "post": { "tags": [ "auth-compat" ], "summary": "Auth Change Password", "description": "Change password for the authenticated user.\n\nBody: {\"current_password\": \"...\", \"new_password\": \"...\"}", "operationId": "auth_change_password_api_v1_auth_change_password_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Auth Change Password Api V1 Auth Change Password Post" } } } } } } }, "/api/v1/auth/delete-account": { "post": { "tags": [ "auth-compat" ], "summary": "Auth Delete Account", "description": "Delete the authenticated user's account.", "operationId": "auth_delete_account_api_v1_auth_delete_account_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Auth Delete Account Api V1 Auth Delete Account Post" } } } } } } }, "/api/v1/auth/privacy-settings": { "get": { "tags": [ "auth-compat" ], "summary": "Auth Privacy Settings", "description": "Get privacy settings for the authenticated user.", "operationId": "auth_privacy_settings_api_v1_auth_privacy_settings_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Auth Privacy Settings Api V1 Auth Privacy Settings Get" } } } } } }, "put": { "tags": [ "auth-compat" ], "summary": "Auth Privacy Settings Update", "description": "Update privacy settings for the authenticated user.", "operationId": "auth_privacy_settings_update_api_v1_auth_privacy_settings_put", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Auth Privacy Settings Update Api V1 Auth Privacy Settings Put" } } } } } } }, "/api": { "get": { "tags": [ "api-index" ], "summary": "Api Index", "description": "List all available API versions.", "operationId": "api_index_api_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Api Index Api Get" } } } } } } }, "/api/v1/health/live": { "get": { "tags": [ "v1", "health-v1" ], "summary": "Liveness Check", "description": "Kubernetes-style liveness probe (redirect to /live). Returns 307 redirect. Use root /live for the actual check.", "operationId": "live_v1_api_v1_health_live_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Live V1 Api V1 Health Live Get" } } } } } } }, "/api/v1/health/ready": { "get": { "tags": [ "v1", "health-v1" ], "summary": "Readiness Check", "description": "Kubernetes-style readiness probe (redirect to /ready). Returns 307 redirect. Use root /ready for the actual check.", "operationId": "ready_v1_api_v1_health_ready_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Ready V1 Api V1 Health Ready Get" } } } } } } }, "/api/v1/health": { "get": { "tags": [ "v1", "health-v1" ], "summary": "Full Health Check", "description": "Full health check (redirect to root /health). Returns 307 redirect. Use root /health for the comprehensive probe.", "operationId": "health_v1_api_v1_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Health V1 Api V1 Health Get" } } } } } } }, "/api/v1/health/unified": { "get": { "tags": [ "v1", "health-v1" ], "summary": "Unified Health Dashboard", "description": "Aggregated health dashboard combining service health (Redis, PostgreSQL, Neo4j, Qdrant, ClickHouse, MinIO), provider status (30+ connector circuit breakers), degradation registry, and config validation. Cached for 15 seconds.", "operationId": "health_unified_api_v1_health_unified_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Health Unified Api V1 Health Unified Get" } } } } } } }, "/api/v1/version": { "get": { "tags": [ "v1", "version-v1" ], "summary": "Version V1", "description": "Version info (redirect to root /version).", "operationId": "version_v1_api_v1_version_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Version V1 Api V1 Version Get" } } } } } } }, "/api/v1/analyze/{address}": { "get": { "tags": [ "v1", "analyze-v1" ], "summary": "Analyze Address", "description": "Analyze a contract or token address.\n\nDEPRECATED \u2014 always returns 503. The canonical implementation lives at\n/api/v1/contract-analyzer/analyze/{address} (app.routers.contract_analyzer).\nThis stub is retained so the legacy path keeps returning a structured\nerror instead of 404; remove once all callers migrate.", "operationId": "analyze_address_api_v1_analyze__address__get", "deprecated": true, "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain to query", "default": "ethereum", "title": "Chain" }, "description": "Blockchain to query" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/tokens/{address}": { "get": { "tags": [ "v1", "tokens-v1" ], "summary": "Get Token Info", "description": "Fetch basic token metadata including name, symbol, decimals, total supply, and contract verification status by address and chain.", "operationId": "get_token_info_api_v1_tokens__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__v1__tokens__TokenSummary" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/tokens/{address}/risk": { "get": { "tags": [ "v1", "tokens-v1" ], "summary": "Get Token Risk", "description": "Get token risk assessment with security analysis, rugpull indicators, liquidity health, and community reports. Supports all EVM chains and Solana.", "operationId": "get_token_risk_api_v1_tokens__address__risk_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/deployer/{address}": { "get": { "tags": [ "v1", "deployer-v1" ], "summary": "Get Deployer", "description": "Get deployer profile by address. Returns deployed contracts, rugpull history, associated wallets, and risk score.", "operationId": "get_deployer_info_api_v1_deployer__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain to query", "default": "ethereum", "title": "Chain" }, "description": "Blockchain to query" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/deployer/{address}/contracts": { "get": { "tags": [ "v1", "deployer-v1" ], "summary": "List Deployer Contracts", "description": "List all contracts deployed by a given address. Returns verification status, risk flags, and deployment timeline.", "operationId": "get_deployer_contracts_api_v1_deployer__address__contracts_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain to query", "default": "ethereum", "title": "Chain" }, "description": "Blockchain to query" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/contract/{address}": { "get": { "tags": [ "v1", "contract-v1" ], "summary": "Get Contract", "description": "Get contract details by address. Includes bytecode hash, compiler version, verification status, and known vulnerability matches.", "operationId": "get_contract_info_api_v1_contract__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain to query", "default": "ethereum", "title": "Chain" }, "description": "Blockchain to query" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/contract/{address}/verify": { "get": { "tags": [ "v1", "contract-v1" ], "summary": "Verify Contract", "description": "Verify a contract's source code against its on-chain bytecode. Supports multiple compiler versions and optimization settings.", "operationId": "verify_contract_api_v1_contract__address__verify_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/entities/resolve": { "post": { "tags": [ "v1", "entities-v1" ], "summary": "Resolve Entity", "description": "Resolve wallet addresses to entities (clusters of related wallets).\n\nUses entity clustering from app.entity_clustering.", "operationId": "resolve_entity_api_v1_entities_resolve_post", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" }, "title": "Addresses" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/entities/{entity_id}": { "get": { "tags": [ "v1", "entities-v1" ], "summary": "Get Entity", "description": "Get entity details and member wallets.", "operationId": "get_entity_api_v1_entities__entity_id__get", "parameters": [ { "name": "entity_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Entity Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/entities/search": { "get": { "tags": [ "v1", "entities-v1" ], "summary": "Search Entities", "description": "Search for entities by name or associated address.", "operationId": "search_entities_api_v1_entities_search_get", "parameters": [ { "name": "query", "in": "query", "required": true, "schema": { "type": "string", "description": "Search term for entity name or address", "title": "Query" }, "description": "Search term for entity name or address" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/cross-chain/{address}": { "get": { "tags": [ "v1", "cross-chain-v1" ], "summary": "Cross Chain Profile", "description": "Get cross-chain profile for a wallet address.\n\nResolves the wallet across all known chains using:\n- Same-deployer matching (chain-indexer ClickHouse)\n- EVM address portability\n- Bridge mappings\n- Known entity labels\n\nReturns linked addresses on other chains with confidence scores.", "operationId": "cross_chain_profile_api_v1_cross_chain__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Chain to resolve from", "default": "ethereum", "title": "Chain" }, "description": "Chain to resolve from" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Cross Chain Profile Api V1 Cross Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/cross-chain/deployers/discover": { "post": { "tags": [ "v1", "cross-chain-v1" ], "summary": "Discover Multi Chain Deployers", "description": "Discover deployers active on multiple chains.\n\nQueries chain-indexer ClickHouse to find wallets that deployed tokens\non 2+ chains \u2014 strong evidence they're the same entity.\n\nReturns multi-chain deployers with chain activity summaries.", "operationId": "discover_multi_chain_deployers_api_v1_cross_chain_deployers_discover_post", "parameters": [ { "name": "min_chains", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 10, "minimum": 2, "default": 2, "title": "Min Chains" } }, { "name": "chain_filter", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated chain names", "default": "", "title": "Chain Filter" }, "description": "Comma-separated chain names" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 10000, "minimum": 1, "default": 500, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Discover Multi Chain Deployers Api V1 Cross Chain Deployers Discover Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/cross-chain/persist": { "post": { "tags": [ "v1", "cross-chain-v1" ], "summary": "Persist Cross Chain Entities", "description": "Run batch cross-chain entity persistence.\n\nFinds multi-chain deployers and creates:\n- Neo4j Entity nodes\n- Neo4j SAME_AS edges linking same-entity wallets across chains\n- ClickHouse wallet_entity links\n\nUse dry_run=True to preview without writing.", "operationId": "persist_cross_chain_entities_api_v1_cross_chain_persist_post", "parameters": [ { "name": "min_chains", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 10, "minimum": 2, "default": 2, "title": "Min Chains" } }, { "name": "chain_filter", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated chain names", "default": "", "title": "Chain Filter" }, "description": "Comma-separated chain names" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 5000, "minimum": 1, "default": 200, "title": "Limit" } }, { "name": "dry_run", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Dry Run" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Persist Cross Chain Entities Api V1 Cross Chain Persist Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/cross-chain/trace": { "post": { "tags": [ "v1", "cross-chain-v1" ], "summary": "Cross Chain Trace", "description": "Trace fund flows across multiple blockchains. Follows transactions through bridges, mixers, and CEX deposits.", "operationId": "cross_chain_trace_api_v1_cross_chain_trace_post", "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Addresses" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Cross Chain Trace Api V1 Cross Chain Trace Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/providers/status": { "get": { "tags": [ "v1", "providers" ], "summary": "Providers Status", "description": "Get per-provider health status for all external API providers.\n\nReturns a list of all registered providers with:\n - name / tier / description\n - status (healthy | degraded | unhealthy | unknown)\n - circuit_breaker state (closed | open | half_open | none | unknown)\n - last_error timestamp\n - circuit_breaker details (if available)\n\nResults are cached for 15 seconds.", "operationId": "providers_status_api_v1_providers_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Providers Status Api V1 Providers Status Get" } } } } } } }, "/api/v1/entity/{address}/cross-chain": { "get": { "tags": [ "v1", "entity-v1" ], "summary": "Entity Cross Chain", "description": "Consolidated cross-chain entity profile.\n\nAggregates wallet profiles, entity resolution, labels, risk scores,\nand related addresses across all supported chains.\n\nGraceful degradation:\n - If a single chain fails, it is omitted from profiles (not 500)\n - If entity resolution fails, entity is returned as null\n - If label resolution fails, tags are returned as empty\n - Never returns HTTP 500", "operationId": "entity_cross_chain_api_v1_entity__address__cross_chain_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Entity Cross Chain Api V1 Entity Address Cross Chain Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/reports/custom": { "post": { "tags": [ "v1", "reports-v1" ], "summary": "Generate Report", "description": "Generate a custom report with user-selected sections.\n\nEach section is fetched independently. If a section's data source\nis unavailable, it returns {\"error\": \"unavailable\"} rather than\nfailing the entire report.\n\nSupports \"json\" (default) and \"markdown\" output formats.", "operationId": "generate_report_api_v1_reports_custom_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Generate Report Api V1 Reports Custom Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/alerts/bulk": { "post": { "tags": [ "v1", "alerts-v1" ], "summary": "Create Bulk Alerts", "description": "Create alerts for multiple tokens in a single call.\n\nAccepts 1-50 tokens and 1+ alert types. Validates each token's\nformat and existence before creating alert configs. Returns the\nlist of created alert IDs.\n\nRate limited: 1 bulk call per 60 seconds per client IP.", "operationId": "create_bulk_alerts_api_v1_alerts_bulk_post", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "base", "title": "Chain" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkAlertRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Create Bulk Alerts Api V1 Alerts Bulk Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scam-school/courses": { "get": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "List Courses", "description": "List all available courses with metadata.", "operationId": "list_courses_api_v1_scam_school_courses_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Courses Api V1 Scam School Courses Get" } } } } } } }, "/api/v1/scam-school/courses/{course_id}": { "get": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "Get Course", "description": "Get full course content including all lesson slides.", "operationId": "get_course_api_v1_scam_school_courses__course_id__get", "parameters": [ { "name": "course_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Course Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Course Api V1 Scam School Courses Course Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scam-school/courses/{course_id}/modules/{module_id}": { "get": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "Get Module", "description": "Get a specific module's content.", "operationId": "get_module_api_v1_scam_school_courses__course_id__modules__module_id__get", "parameters": [ { "name": "course_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Course Id" } }, { "name": "module_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Module Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Module Api V1 Scam School Courses Course Id Modules Module Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scam-school/badges": { "get": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "List Badges", "description": "List all available badges.", "operationId": "list_badges_api_v1_scam_school_badges_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Badges Api V1 Scam School Badges Get" } } } } } } }, "/api/v1/scam-school/achievements": { "get": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "List Achievements", "description": "List all achievements.", "operationId": "list_achievements_api_v1_scam_school_achievements_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Achievements Api V1 Scam School Achievements Get" } } } } } } }, "/api/v1/scam-school/levels": { "get": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "List Levels", "description": "List level progression.", "operationId": "list_levels_api_v1_scam_school_levels_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Levels Api V1 Scam School Levels Get" } } } } } } }, "/api/v1/scam-school/verify-cert/{cert_id}": { "get": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "Verify Certificate", "description": "Verify a certificate's authenticity.", "operationId": "verify_certificate_api_v1_scam_school_verify_cert__cert_id__get", "parameters": [ { "name": "cert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cert Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Verify Certificate Api V1 Scam School Verify Cert Cert Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scam-school/progress": { "get": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "Get Progress", "description": "Get current user's full progress.", "operationId": "get_progress_api_v1_scam_school_progress_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Progress Api V1 Scam School Progress Get" } } } } } } }, "/api/v1/scam-school/lessons/{course_id}/{lesson_id}/complete": { "post": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "Complete Lesson", "description": "Mark a lesson as complete and award XP.", "operationId": "complete_lesson_api_v1_scam_school_lessons__course_id___lesson_id__complete_post", "parameters": [ { "name": "course_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Course Id" } }, { "name": "lesson_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Lesson Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LessonComplete" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Complete Lesson Api V1 Scam School Lessons Course Id Lesson Id Complete Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scam-school/exams/{course_id}/{exam_id}": { "post": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "Submit Exam", "description": "Submit an exam and get results.", "operationId": "submit_exam_api_v1_scam_school_exams__course_id___exam_id__post", "parameters": [ { "name": "course_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Course Id" } }, { "name": "exam_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Exam Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamSubmit" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Submit Exam Api V1 Scam School Exams Course Id Exam Id Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scam-school/leaderboard": { "get": { "tags": [ "v1", "scam-school", "scam-school" ], "summary": "Get Leaderboard", "description": "Get global leaderboard by XP.", "operationId": "get_leaderboard_api_v1_scam_school_leaderboard_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Leaderboard Api V1 Scam School Leaderboard Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/stream/alerts": { "get": { "tags": [ "v1" ], "summary": "Sse Alert Stream", "description": "Server-Sent Events stream for real-time security alerts.\n\nConnect with: EventSource('/api/v1/x402-tools/stream/alerts?events=rug_pull,whale_move')", "operationId": "sse_alert_stream_api_v1_x402_stream_alerts_get", "parameters": [ { "name": "events", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated event types", "default": "rug_pull,whale_move,price_crash", "title": "Events" }, "description": "Comma-separated event types" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "all", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Sse Alert Stream Api V1 X402 Stream Alerts Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/rug_probability": { "post": { "tags": [ "v1" ], "summary": "Rug Probability", "description": "Predictive rug pull probability: 0-100 score.", "operationId": "rug_probability_api_v1_x402_rug_probability_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_advanced_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Rug Probability Api V1 X402 Rug Probability Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/history": { "post": { "tags": [ "v1" ], "summary": "Token History", "description": "Historical risk/liquidity/holder data for any token.\n\nReturns time-series data from the RMI scanner (runs every 10 min).\nShows how risk profile, liquidity, volume, and holder metrics change over time.", "operationId": "token_history_api_v1_x402_history_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HistoryRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Token History Api V1 X402 History Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/narrative": { "post": { "tags": [ "v1" ], "summary": "Narrative Engine", "description": "What's the market saying about this token RIGHT NOW?.", "operationId": "narrative_engine_api_v1_x402_narrative_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NarrativeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ {}, { "additionalProperties": { "type": "string" }, "type": "object" } ], "title": "Response Narrative Engine Api V1 X402 Narrative Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/cache/clear": { "post": { "tags": [ "v1" ], "summary": "Clear Cache", "description": "Clear response cache for a specific tool or all tools.", "operationId": "clear_cache_api_v1_x402_cache_clear_post", "parameters": [ { "name": "tool", "in": "query", "required": false, "schema": { "type": "string", "title": "Tool" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Clear Cache Api V1 X402 Cache Clear Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/cache/stats": { "get": { "tags": [ "v1" ], "summary": "Cache Stats", "description": "Get cache hit/miss statistics.", "operationId": "cache_stats_api_v1_x402_cache_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Cache Stats Api V1 X402 Cache Stats Get" } } } } } } }, "/api/v1/x402/reputation_score": { "post": { "tags": [ "v1" ], "summary": "Reputation Score", "description": "Compute a comprehensive 0-100 trust score for any blockchain address.\n\nCombines: wallet labels, scam database hits, deployer history,\nRAG similarity matching, transaction patterns, and exchange associations.\n\nScore interpretation:\n 90-100: Trusted (verified exchange, known entity)\n 70-89: Low risk (established wallet, clean history)\n 50-69: Moderate risk (some flags, requires attention)\n 30-49: High risk (multiple red flags, suspected scam)\n 0-29: Critical risk (confirmed scam, sanctioned, known rugger)", "operationId": "reputation_score_api_v1_x402_reputation_score_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_premium_tools__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Reputation Score Api V1 X402 Reputation Score Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/webhook_register": { "post": { "tags": [ "v1" ], "summary": "Webhook Register", "description": "Register a webhook URL for real-time monitoring alerts.\n\nAvailable events: rug_pull, whale_move, price_crash, new_launch,\n liquidity_removed, ownership_renounced, scam_detected.\n\nWebhooks fire within 30 seconds of detection. Max 3 webhooks per address.\nData delivered as JSON POST to your URL.", "operationId": "webhook_register_api_v1_x402_webhook_register_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookRegisterRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Webhook Register Api V1 X402 Webhook Register Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/webhook_list": { "get": { "tags": [ "v1" ], "summary": "Webhook List", "description": "List registered webhooks for an address or globally.", "operationId": "webhook_list_api_v1_x402_webhook_list_get", "parameters": [ { "name": "address", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Webhook List Api V1 X402 Webhook List Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/investigation_report": { "post": { "tags": [ "v1" ], "summary": "Investigation Report", "description": "Generate a comprehensive AI-powered investigation report.\n\nCombines: reputation scoring, wallet labeling, scam detection,\non-chain forensics, social signal analysis, and market data\ninto a single human-readable report with risk assessment.\n\nReport sections: Executive Summary, Risk Score, Wallet Profile,\nTransaction Analysis, Known Associations, Scam Indicators,\nMarket Context, Recommendation.", "operationId": "investigation_report_api_v1_x402_investigation_report_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvestigationRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Investigation Report Api V1 X402 Investigation Report Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/api": { "get": { "tags": [ "v1", "api-index" ], "summary": "Api Index", "description": "List all available API versions.", "operationId": "api_index_api_v1_api_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Api Index Api V1 Api Get" } } } } } } }, "/api/v1/data/scan-history": { "get": { "tags": [ "v1", "data" ], "summary": "Scan History", "description": "Recent token scan results for the frontend dashboard.\n\nReturns ``{\"scans\": [...], \"count\": N}`` matching the frontend\n``ScanRecord`` contract. Scans are newest-first.", "operationId": "scan_history_api_v1_data_scan_history_get", "parameters": [ { "name": "address", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter by token contract address", "title": "Address" }, "description": "Filter by token contract address" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Scan History Api V1 Data Scan History Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scanner/recent": { "get": { "tags": [ "v1", "scanner" ], "summary": "Recent Scans", "description": "Recent scan results (newest first) as a plain JSON array.\n\nConsumed by the news fetcher: each item exposes ``token_name``,\n``contract_address`` / ``token_address``, ``chain``, ``risk_score``,\n``is_honeypot``, ``is_rug_pull``, ``liquidity_locked``,\n``has_mint_authority`` and ``scanned_at``.", "operationId": "recent_scans_api_v1_scanner_recent_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Recent Scans Api V1 Scanner Recent Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/launches/recent": { "get": { "tags": [ "v1", "launches-v1" ], "summary": "Recent Token Launches", "description": "Newly launched tokens across all supported chains. Own ClickHouse deployer_events first, then DexScreener new pairs, then GMGN launch data. Optional pump.fun bonding-curve filter (chain=SOLANA, program_id detection). Includes bundle risk flag when holder data is available.", "operationId": "recent_launches_api_v1_launches_recent_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Chain filter (solana, ethereum, base...). Empty = all chains.", "default": "", "title": "Chain" }, "description": "Chain filter (solana, ethereum, base...). Empty = all chains." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Max launches to return", "default": 20, "title": "Limit" }, "description": "Max launches to return" }, { "name": "pump_only", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Only pump.fun bonding-curve tokens (Solana)", "default": false, "title": "Pump Only" }, "description": "Only pump.fun bonding-curve tokens (Solana)" }, { "name": "enrich_bundle", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Best-effort bundle risk enrichment via our BundleDetector", "default": true, "title": "Enrich Bundle" }, "description": "Best-effort bundle risk enrichment via our BundleDetector" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Recent Launches Api V1 Launches Recent Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/fetch": { "post": { "tags": [ "databus", "databus" ], "summary": "Databus Fetch", "description": "Universal data fetch endpoint.\nEvery response is packaged based on who's asking.\nNo raw data leaks - consumers only get what they're authorized for.\n\nBody: {\n \"data_type\": \"token_price\", # required\n \"admin_key\": \"\", # for admin data\n \"force_fresh\": false, # skip cache\n \"rag_index\": false, # index in RAG\n \"consumer_type\": \"\", # public_web/authenticated/premium/admin/mcp_tool/x402_paid\n \"tool_id\": \"\", # MCP tool ID for scoping\n \"x402_tier\": \"\", # x402 pricing tier: free/basic/premium/enterprise\n \"mint\": \"So111...\", # type-specific params\n \"address\": \"0x...\", # type-specific params\n ...\n}", "operationId": "databus_fetch_api_v1_databus_fetch_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Databus Fetch Api V1 Databus Fetch Post" } } } } } } }, "/api/v1/databus/fetch/{data_type}": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus Fetch Get", "description": "GET convenience for simple queries. Params passed as query args.", "operationId": "databus_fetch_get_api_v1_databus_fetch__data_type__get", "parameters": [ { "name": "data_type", "in": "path", "required": true, "schema": { "type": "string", "title": "Data Type" } }, { "name": "admin_key", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Admin Key" } }, { "name": "force_fresh", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Force Fresh" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Databus Fetch Get Api V1 Databus Fetch Data Type Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/health": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus Health", "description": "Full system health: cache, vault, chains, stats.", "operationId": "databus_health_api_v1_databus_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Databus Health Api V1 Databus Health Get" } } } } } } }, "/api/v1/databus/capacity": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus Capacity", "description": "Credit report and recommendations for free tier expansion.", "operationId": "databus_capacity_api_v1_databus_capacity_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Databus Capacity Api V1 Databus Capacity Get" } } } } } } }, "/api/v1/databus/chains": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus Chains", "description": "List all available data types and their provider fallback chains.", "operationId": "databus_chains_api_v1_databus_chains_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Databus Chains Api V1 Databus Chains Get" } } } } } } }, "/api/v1/databus/access-matrix": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus Access Matrix", "description": "View the full access control matrix. Admin key required.", "operationId": "databus_access_matrix_api_v1_databus_access_matrix_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ {}, { "additionalProperties": { "type": "string" }, "type": "object" } ], "title": "Response Databus Access Matrix Api V1 Databus Access Matrix Get" } } } } } } }, "/api/v1/databus/mcp-scope/{tool_id}": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus Mcp Scope", "description": "Get the data types an MCP tool is authorized to access.", "operationId": "databus_mcp_scope_api_v1_databus_mcp_scope__tool_id__get", "parameters": [ { "name": "tool_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Tool Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Databus Mcp Scope Api V1 Databus Mcp Scope Tool Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/x402-scope/{tier}": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus X402 Scope", "description": "Get the data types an x402 pricing tier can access.", "operationId": "databus_x402_scope_api_v1_databus_x402_scope__tier__get", "parameters": [ { "name": "tier", "in": "path", "required": true, "schema": { "type": "string", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Databus X402 Scope Api V1 Databus X402 Scope Tier Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/invalidate": { "post": { "tags": [ "databus", "databus" ], "summary": "Databus Invalidate", "description": "Clear cache. Admin key required.", "operationId": "databus_invalidate_api_v1_databus_invalidate_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Databus Invalidate Api V1 Databus Invalidate Post" } } } } } } }, "/api/v1/databus/vault/status": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus Vault Status", "description": "Key pool status. NEVER exposes key values. Admin key required.", "operationId": "databus_vault_status_api_v1_databus_vault_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Databus Vault Status Api V1 Databus Vault Status Get" } } } } } } }, "/api/v1/databus/vault/capacity": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus Vault Capacity", "description": "Detailed capacity report with free tier recommendations. Admin key required.", "operationId": "databus_vault_capacity_api_v1_databus_vault_capacity_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Databus Vault Capacity Api V1 Databus Vault Capacity Get" } } } } } } }, "/api/v1/databus/vault/reload": { "post": { "tags": [ "databus", "databus" ], "summary": "Databus Vault Reload", "description": "Reload keys from vault without restart. Admin key required.", "operationId": "databus_vault_reload_api_v1_databus_vault_reload_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Databus Vault Reload Api V1 Databus Vault Reload Post" } } } } } } }, "/api/v1/databus/vault/add-key": { "post": { "tags": [ "databus", "databus" ], "summary": "Databus Vault Add Key", "description": "Hot-add an API key to a provider pool. Admin key required.", "operationId": "databus_vault_add_key_api_v1_databus_vault_add_key_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Databus Vault Add Key Api V1 Databus Vault Add Key Post" } } } } } } }, "/api/v1/databus/vault/reset-monthly": { "post": { "tags": [ "databus", "databus" ], "summary": "Databus Vault Reset Monthly", "description": "Reset monthly call counters. Admin key required.", "operationId": "databus_vault_reset_monthly_api_v1_databus_vault_reset_monthly_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Databus Vault Reset Monthly Api V1 Databus Vault Reset Monthly Post" } } } } } } }, "/api/v1/databus/warm/start": { "post": { "tags": [ "databus", "databus" ], "summary": "Databus Warm Start", "description": "Start cache warm background task. Admin key required.", "operationId": "databus_warm_start_api_v1_databus_warm_start_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Databus Warm Start Api V1 Databus Warm Start Post" } } } } } } }, "/api/v1/databus/warm/stop": { "post": { "tags": [ "databus", "databus" ], "summary": "Databus Warm Stop", "description": "Stop cache warm background task. Admin key required.", "operationId": "databus_warm_stop_api_v1_databus_warm_stop_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Databus Warm Stop Api V1 Databus Warm Stop Post" } } } } } } }, "/api/v1/databus/arkham/entity/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Arkham Entity", "description": "Resolve a wallet address to an Arkham entity. Admin key required.", "operationId": "arkham_entity_api_v1_databus_arkham_entity__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Arkham Entity Api V1 Databus Arkham Entity Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/arkham/labels": { "get": { "tags": [ "databus", "databus" ], "summary": "Arkham Labels", "description": "Look up labels for addresses. Admin key required for Arkham, public for local.", "operationId": "arkham_labels_api_v1_databus_arkham_labels_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Arkham Labels Api V1 Databus Arkham Labels Get" } } } } } } }, "/api/v1/databus/arkham/portfolio/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Arkham Portfolio", "description": "Get portfolio for an entity. Admin key required.", "operationId": "arkham_portfolio_api_v1_databus_arkham_portfolio__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Arkham Portfolio Api V1 Databus Arkham Portfolio Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/token/{mint}": { "get": { "tags": [ "databus", "databus" ], "summary": "Token Detail", "description": "Rich token detail (metadata + price + security).", "operationId": "token_detail_api_v1_databus_token__mint__get", "parameters": [ { "name": "mint", "in": "path", "required": true, "schema": { "type": "string", "title": "Mint" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Token Detail Api V1 Databus Token Mint Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/wallet/{address}/tokens": { "get": { "tags": [ "databus", "databus" ], "summary": "Wallet Tokens", "description": "Wallet token holdings.", "operationId": "wallet_tokens_api_v1_databus_wallet__address__tokens_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Wallet Tokens Api V1 Databus Wallet Address Tokens Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/wallet/{address}/pnl": { "get": { "tags": [ "databus", "databus" ], "summary": "Wallet Pnl", "description": "Wallet profit/loss.", "operationId": "wallet_pnl_api_v1_databus_wallet__address__pnl_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Wallet Pnl Api V1 Databus Wallet Address Pnl Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/rugmap/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Rugmap", "description": "Interactive holder RugMap.", "operationId": "rugmap_api_v1_databus_rugmap__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "depth", "in": "query", "required": false, "schema": { "type": "integer", "default": 2, "title": "Depth" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Rugmap Api V1 Databus Rugmap Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/rugmaps/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Rugmaps Analysis", "description": "RugMaps AI analysis + similar scam search.", "operationId": "rugmaps_analysis_api_v1_databus_rugmaps__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Rugmaps Analysis Api V1 Databus Rugmaps Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/threat/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Threat Check", "description": "Threat intelligence check (CryptoScamDB + GoPlus + Januus).", "operationId": "threat_check_api_v1_databus_threat__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain_id", "in": "query", "required": false, "schema": { "type": "string", "default": "1", "title": "Chain Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Threat Check Api V1 Databus Threat Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/contract-scan/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Contract Scan", "description": "Smart contract deep scan (Slither + Mythril).", "operationId": "contract_scan_api_v1_databus_contract_scan__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "base", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Contract Scan Api V1 Databus Contract Scan Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/sentinel-deep/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Sentinel Deep", "description": "Deep SENTINEL scan + threat feeds + contract analysis.", "operationId": "sentinel_deep_api_v1_databus_sentinel_deep__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Sentinel Deep Api V1 Databus Sentinel Deep Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/prediction-markets": { "get": { "tags": [ "databus", "databus" ], "summary": "Prediction Markets", "description": "Prediction market intel (Polymarket + Kalshi).", "operationId": "prediction_markets_api_v1_databus_prediction_markets_get", "parameters": [ { "name": "query", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Query" } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Category" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Prediction Markets Api V1 Databus Prediction Markets Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/prediction-signals": { "get": { "tags": [ "databus", "databus" ], "summary": "Prediction Signals", "description": "Auto-detected trading signals from prediction markets.", "operationId": "prediction_signals_api_v1_databus_prediction_signals_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Prediction Signals Api V1 Databus Prediction Signals Get" } } } } } } }, "/api/v1/databus/market/prediction-markets": { "get": { "tags": [ "databus", "databus" ], "summary": "Market Prediction Markets", "description": "Prediction markets from Polymarket. Free, no key needed.", "operationId": "market_prediction_markets_api_v1_databus_market_prediction_markets_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Market Prediction Markets Api V1 Databus Market Prediction Markets Get" } } } } } } }, "/api/v1/databus/batch": { "post": { "tags": [ "databus", "databus" ], "summary": "Databus Batch", "description": "#7 Batch DataBus - fetch multiple data types in one call.\n\nBody: {\n \"requests\": [\n {\"data_type\": \"token_price\", \"mint\": \"So111...\"},\n {\"data_type\": \"wallet_labels\", \"address\": \"0x...\"},\n ...\n ],\n \"admin_key\": \"\", # optional, applies to all\n \"consumer_type\": \"\", # optional, applies to all\n}\nReturns: array of results in same order as requests.", "operationId": "databus_batch_api_v1_databus_batch_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Databus Batch Api V1 Databus Batch Post" } } } } } } }, "/api/v1/databus/providers/health": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus Providers Health", "description": "#5 Provider Health Dashboard - per-provider success/failure/latency/circuit status.", "operationId": "databus_providers_health_api_v1_databus_providers_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Databus Providers Health Api V1 Databus Providers Health Get" } } } } } } }, "/api/v1/databus/cache/stats": { "get": { "tags": [ "databus", "databus" ], "summary": "Databus Cache Stats", "description": "#10 Per-type cache stats with TTL tuning suggestions.", "operationId": "databus_cache_stats_api_v1_databus_cache_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Databus Cache Stats Api V1 Databus Cache Stats Get" } } } } } } }, "/api/v1/databus/schema/validate": { "post": { "tags": [ "databus", "databus" ], "summary": "Databus Schema Validate", "description": "#15 Validate a DataBus response against expected schema.\n\nBody: {\"data_type\": \"token_price\", \"data\": {\"price_usd\": 1.23, ...}}\nReturns: {valid: bool, missing_fields: [...]}", "operationId": "databus_schema_validate_api_v1_databus_schema_validate_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Databus Schema Validate Api V1 Databus Schema Validate Post" } } } } } } }, "/api/v1/databus/social/x/profile/{username}": { "get": { "tags": [ "databus", "databus" ], "summary": "Social X Profile", "description": "Get X/Twitter user profile - cached 24h.", "operationId": "social_x_profile_api_v1_databus_social_x_profile__username__get", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string", "title": "Username" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social X Profile Api V1 Databus Social X Profile Username Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/x/tweets/{username}": { "get": { "tags": [ "databus", "databus" ], "summary": "Social X Tweets", "description": "Get recent tweets from user - cached 15min.", "operationId": "social_x_tweets_api_v1_databus_social_x_tweets__username__get", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string", "title": "Username" } }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Count" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social X Tweets Api V1 Databus Social X Tweets Username Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/x/mentions": { "get": { "tags": [ "databus", "databus" ], "summary": "Social X Mentions", "description": "Get mentions of @CryptoRugMunch - cached 15min.", "operationId": "social_x_mentions_api_v1_databus_social_x_mentions_get", "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Count" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social X Mentions Api V1 Databus Social X Mentions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/x/engagement": { "get": { "tags": [ "databus", "databus" ], "summary": "Social X Engagement", "description": "Get engagement metrics for tweets - cached 1h.", "operationId": "social_x_engagement_api_v1_databus_social_x_engagement_get", "parameters": [ { "name": "tweet_ids", "in": "query", "required": true, "schema": { "type": "string", "description": "Comma-separated tweet IDs", "title": "Tweet Ids" }, "description": "Comma-separated tweet IDs" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social X Engagement Api V1 Databus Social X Engagement Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/x/search": { "get": { "tags": [ "databus", "databus" ], "summary": "Social X Search", "description": "Search X/Twitter - VERY expensive, cached 24h. Use sparingly.", "operationId": "social_x_search_api_v1_databus_social_x_search_get", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "description": "Search query", "title": "Q" }, "description": "Search query" }, { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 10, "title": "Count" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social X Search Api V1 Databus Social X Search Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/kol/{username}": { "get": { "tags": [ "databus", "databus" ], "summary": "Social Kol Reputation", "description": "KOL reputation score - cached 24h.", "operationId": "social_kol_reputation_api_v1_databus_social_kol__username__get", "parameters": [ { "name": "username", "in": "path", "required": true, "schema": { "type": "string", "title": "Username" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Social Kol Reputation Api V1 Databus Social Kol Username Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/sentiment": { "get": { "tags": [ "databus", "databus" ], "summary": "Social Sentiment", "description": "Brand sentiment analysis - cached 1h.", "operationId": "social_sentiment_api_v1_databus_social_sentiment_get", "parameters": [ { "name": "username", "in": "query", "required": false, "schema": { "type": "string", "default": "CryptoRugMunch", "title": "Username" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Social Sentiment Api V1 Databus Social Sentiment Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/sentiment/token/{token}": { "get": { "tags": [ "databus", "databus" ], "summary": "Social Sentiment Token", "description": "Per-token social sentiment metrics (LunarCrush-style engine).\n\nWindows: 1h | 24h | 7d. Computed from ingested posts (X/nitter +\nFarcaster + Reddit); cached 12h in Redis, RAG-embedded nightly.", "operationId": "social_sentiment_token_api_v1_databus_social_sentiment_token__token__get", "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string", "title": "Token" } }, { "name": "window", "in": "query", "required": false, "schema": { "type": "string", "default": "24h", "title": "Window" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social Sentiment Token Api V1 Databus Social Sentiment Token Token Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/sentiment/trending": { "get": { "tags": [ "databus", "databus" ], "summary": "Social Sentiment Trending", "description": "Trending tokens by mention velocity x sentiment x influence.", "operationId": "social_sentiment_trending_api_v1_databus_social_sentiment_trending_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social Sentiment Trending Api V1 Databus Social Sentiment Trending Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/sentiment/account/{account}": { "get": { "tags": [ "databus", "databus" ], "summary": "Social Sentiment Account", "description": "Per-account social metrics: influence/tier, sentiment, token focus.", "operationId": "social_sentiment_account_api_v1_databus_social_sentiment_account__account__get", "parameters": [ { "name": "account", "in": "path", "required": true, "schema": { "type": "string", "title": "Account" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social Sentiment Account Api V1 Databus Social Sentiment Account Account Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/sentiment/index-rag": { "post": { "tags": [ "databus", "databus" ], "summary": "Social Sentiment Index Rag", "description": "Recompute + embed token sentiment metrics into the RAG ``social_sentiment`` collection.", "operationId": "social_sentiment_index_rag_api_v1_databus_social_sentiment_index_rag_post", "parameters": [ { "name": "limit_tokens", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit Tokens" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social Sentiment Index Rag Api V1 Databus Social Sentiment Index Rag Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/x/budget": { "get": { "tags": [ "databus", "databus" ], "summary": "Social X Budget", "description": "Current X API read budget status.", "operationId": "social_x_budget_api_v1_databus_social_x_budget_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Social X Budget Api V1 Databus Social X Budget Get" } } } } } } }, "/api/v1/databus/social/x/discover": { "get": { "tags": [ "databus", "databus" ], "summary": "Social X Discover", "description": "Discover tweets via web search - no API needed, works for free.", "operationId": "social_x_discover_api_v1_databus_social_x_discover_get", "parameters": [ { "name": "handle", "in": "query", "required": false, "schema": { "type": "string", "default": "CryptoRugMunch", "title": "Handle" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social X Discover Api V1 Databus Social X Discover Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/x/engagement-report": { "get": { "tags": [ "databus", "databus" ], "summary": "Social X Engagement Report", "description": "Get engagement report for a handle - avg likes, best tweets, posting frequency.", "operationId": "social_x_engagement_report_api_v1_databus_social_x_engagement_report_get", "parameters": [ { "name": "handle", "in": "query", "required": false, "schema": { "type": "string", "default": "CryptoRugMunch", "title": "Handle" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Social X Engagement Report Api V1 Databus Social X Engagement Report Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/x/mentions-discover": { "get": { "tags": [ "databus", "databus" ], "summary": "Social X Mentions Discover", "description": "Find tweets mentioning a handle - via web search.", "operationId": "social_x_mentions_discover_api_v1_databus_social_x_mentions_discover_get", "parameters": [ { "name": "handle", "in": "query", "required": false, "schema": { "type": "string", "default": "CryptoRugMunch", "title": "Handle" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Social X Mentions Discover Api V1 Databus Social X Mentions Discover Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/x/trending": { "get": { "tags": [ "databus", "databus" ], "summary": "Social X Trending", "description": "Get current crypto trending topics from web search.", "operationId": "social_x_trending_api_v1_databus_social_x_trending_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Social X Trending Api V1 Databus Social X Trending Get" } } } } } } }, "/api/v1/databus/bitquery/health": { "get": { "tags": [ "databus", "databus" ], "summary": "Bitquery Health", "description": "Check Bitquery provider health and billing status.", "operationId": "bitquery_health_api_v1_databus_bitquery_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Bitquery Health Api V1 Databus Bitquery Health Get" } } } } } } }, "/api/v1/databus/bitquery/token-price/{network}/{token_address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Bitquery Token Price", "description": "Get DEX token price from Bitquery.", "operationId": "bitquery_token_price_api_v1_databus_bitquery_token_price__network___token_address__get", "parameters": [ { "name": "network", "in": "path", "required": true, "schema": { "type": "string", "title": "Network" } }, { "name": "token_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Token Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Bitquery Token Price Api V1 Databus Bitquery Token Price Network Token Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/bitquery/holders/{network}/{token_address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Bitquery Holders", "description": "Get token holder distribution from Bitquery.", "operationId": "bitquery_holders_api_v1_databus_bitquery_holders__network___token_address__get", "parameters": [ { "name": "network", "in": "path", "required": true, "schema": { "type": "string", "title": "Network" } }, { "name": "token_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Token Address" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Bitquery Holders Api V1 Databus Bitquery Holders Network Token Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/bitquery/tx-trace/{network}/{tx_hash}": { "get": { "tags": [ "databus", "databus" ], "summary": "Bitquery Tx Trace", "description": "Get full transaction trace from Bitquery.", "operationId": "bitquery_tx_trace_api_v1_databus_bitquery_tx_trace__network___tx_hash__get", "parameters": [ { "name": "network", "in": "path", "required": true, "schema": { "type": "string", "title": "Network" } }, { "name": "tx_hash", "in": "path", "required": true, "schema": { "type": "string", "title": "Tx Hash" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Bitquery Tx Trace Api V1 Databus Bitquery Tx Trace Network Tx Hash Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/bitquery/dex-volume/{network}": { "get": { "tags": [ "databus", "databus" ], "summary": "Bitquery Dex Volume", "description": "Get DEX trading volume from Bitquery.", "operationId": "bitquery_dex_volume_api_v1_databus_bitquery_dex_volume__network__get", "parameters": [ { "name": "network", "in": "path", "required": true, "schema": { "type": "string", "title": "Network" } }, { "name": "pool", "in": "query", "required": false, "schema": { "type": "string", "title": "Pool" } }, { "name": "timeframe", "in": "query", "required": false, "schema": { "type": "string", "default": "24h", "title": "Timeframe" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Bitquery Dex Volume Api V1 Databus Bitquery Dex Volume Network Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/bitquery/balance/{network}/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Bitquery Balance", "description": "Get address token balances from Bitquery.", "operationId": "bitquery_balance_api_v1_databus_bitquery_balance__network___address__get", "parameters": [ { "name": "network", "in": "path", "required": true, "schema": { "type": "string", "title": "Network" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Bitquery Balance Api V1 Databus Bitquery Balance Network Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/bitquery/cross-chain/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Bitquery Cross Chain", "description": "Track token transfers across chains from Bitquery.", "operationId": "bitquery_cross_chain_api_v1_databus_bitquery_cross_chain__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "networks", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum,bsc,solana", "title": "Networks" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Bitquery Cross Chain Api V1 Databus Bitquery Cross Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/bitquery/contract-events/{network}/{contract}": { "get": { "tags": [ "databus", "databus" ], "summary": "Bitquery Contract Events", "description": "Get smart contract events from Bitquery.", "operationId": "bitquery_contract_events_api_v1_databus_bitquery_contract_events__network___contract__get", "parameters": [ { "name": "network", "in": "path", "required": true, "schema": { "type": "string", "title": "Network" } }, { "name": "contract", "in": "path", "required": true, "schema": { "type": "string", "title": "Contract" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string", "title": "Event" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Bitquery Contract Events Api V1 Databus Bitquery Contract Events Network Contract Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/webhooks/{service}": { "post": { "tags": [ "databus", "databus" ], "summary": "Receive Webhook", "description": "Universal webhook receiver. Routes to correct handler based on service.\n\nSupported: arkham, helius, moralis, alchemy, custom\n\nAuto-validates signatures, deduplicates, caches in DataBus,\nindexes in RAG, triggers premium scanner, pushes alerts.", "operationId": "receive_webhook_api_v1_databus_webhooks__service__post", "parameters": [ { "name": "service", "in": "path", "required": true, "schema": { "type": "string", "title": "Service" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Receive Webhook Api V1 Databus Webhooks Service Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/webhooks": { "get": { "tags": [ "databus", "databus" ], "summary": "List Webhooks Endpoint", "description": "List all recent webhook events.", "operationId": "list_webhooks_endpoint_api_v1_databus_webhooks_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response List Webhooks Endpoint Api V1 Databus Webhooks Get" } } } } } } }, "/api/v1/databus/webhooks/setup/{service}": { "post": { "tags": [ "databus", "databus" ], "summary": "Setup Webhook Endpoint", "description": "Programmatically register a webhook with a service.\n\nAuth: X-API-Key / Bearer must match RMI_AUTH_TOKEN (or RMI_INTERNAL_KEY).\nSSRF guard: webhook_url must resolve to a public IP.\n\nBody: {\n \"webhook_url\": \"https://rugmunch.io/api/v1/databus/webhooks/helius\",\n \"events\": [\"transaction\", \"token_transfer\"],\n \"addresses\": [\"0x...\"],\n \"api_key\": \"optional-override\"\n}", "operationId": "setup_webhook_endpoint_api_v1_databus_webhooks_setup__service__post", "parameters": [ { "name": "service", "in": "path", "required": true, "schema": { "type": "string", "title": "Service" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Setup Webhook Endpoint Api V1 Databus Webhooks Setup Service Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/bundles/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Bundle Detect", "description": "Bundle detection (RugMaps cluster analysis). Premium tier.", "operationId": "premium_bundle_detect_api_v1_databus_premium_bundles__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Bundle Detect Api V1 Databus Premium Bundles Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/clusters/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Cluster Map", "description": "Full wallet cluster mapping with graph-ready nodes/edges. Premium tier.", "operationId": "premium_cluster_map_api_v1_databus_premium_clusters__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "depth", "in": "query", "required": false, "schema": { "type": "integer", "default": 3, "title": "Depth" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Cluster Map Api V1 Databus Premium Clusters Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/dev-finder/{token}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Dev Finder", "description": "Find developer/creator wallets behind a token. Premium tier.", "operationId": "premium_dev_finder_api_v1_databus_premium_dev_finder__token__get", "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string", "title": "Token" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Dev Finder Api V1 Databus Premium Dev Finder Token Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/snipers/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Sniper Detect", "description": "Detect snipers - first-block buyers with fast dumps. Premium tier.", "operationId": "premium_sniper_detect_api_v1_databus_premium_snipers__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Sniper Detect Api V1 Databus Premium Snipers Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/bot-farms/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Bot Farms", "description": "Detect bot farms - identical behavior patterns. Premium tier.", "operationId": "premium_bot_farms_api_v1_databus_premium_bot_farms__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Bot Farms Api V1 Databus Premium Bot Farms Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/copy-trading/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Copy Trading", "description": "Detect copy trading patterns. Premium tier.", "operationId": "premium_copy_trading_api_v1_databus_premium_copy_trading__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Copy Trading Api V1 Databus Premium Copy Trading Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/insider-signals/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Insider", "description": "Detect insider trading signals. Premium tier.", "operationId": "premium_insider_api_v1_databus_premium_insider_signals__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Insider Api V1 Databus Premium Insider Signals Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/wash-trading/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Wash Trading", "description": "Detect wash trading patterns. Premium tier.", "operationId": "premium_wash_trading_api_v1_databus_premium_wash_trading__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Wash Trading Api V1 Databus Premium Wash Trading Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/mev/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Mev", "description": "Detect MEV sandwich attacks. Premium tier.", "operationId": "premium_mev_api_v1_databus_premium_mev__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Mev Api V1 Databus Premium Mev Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/fresh-wallets/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Fresh Wallets", "description": "Analyze fresh wallet concentration - high new-wallet % = rug risk. Premium tier.", "operationId": "premium_fresh_wallets_api_v1_databus_premium_fresh_wallets__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Fresh Wallets Api V1 Databus Premium Fresh Wallets Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/volume-authenticity/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Volume Auth", "description": "Fake volume % with bootstrap CI. The RugCharts moat - no one else does this.", "operationId": "premium_volume_auth_api_v1_databus_premium_volume_authenticity__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Volume Auth Api V1 Databus Premium Volume Authenticity Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/ohlcv/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Ohlcv Candles", "description": "OHLCV candlestick data with authenticity scoring baked in.", "operationId": "ohlcv_candles_api_v1_databus_ohlcv__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "timeframe", "in": "query", "required": false, "schema": { "type": "string", "default": "1h", "title": "Timeframe" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Ohlcv Candles Api V1 Databus Ohlcv Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/security-scan/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Premium Security Scan", "description": "37+ security checks - GoPlus, honeypot, contract, liquidity, holders, rug pull indicators.", "operationId": "premium_security_scan_api_v1_databus_premium_security_scan__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Premium Security Scan Api V1 Databus Premium Security Scan Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/security-checks": { "get": { "tags": [ "databus", "databus" ], "summary": "Security Check Matrix", "description": "Full list of all 37+ security checks with weights and descriptions.", "operationId": "security_check_matrix_api_v1_databus_security_checks_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Security Check Matrix Api V1 Databus Security Checks Get" } } } } } } }, "/api/v1/databus/premium/smart-money": { "get": { "tags": [ "databus", "databus" ], "summary": "Smart Money Endpoint", "description": "What profitable wallets are buying right now - with entity labels.", "operationId": "smart_money_endpoint_api_v1_databus_premium_smart_money_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Smart Money Endpoint Api V1 Databus Premium Smart Money Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/whale-alerts/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Whale Alerts Endpoint", "description": "Real-time large transaction detection for a token or wallet.", "operationId": "whale_alerts_endpoint_api_v1_databus_premium_whale_alerts__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "min_value", "in": "query", "required": false, "schema": { "type": "number", "default": 100000, "title": "Min Value" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Whale Alerts Endpoint Api V1 Databus Premium Whale Alerts Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/token-launches": { "get": { "tags": [ "databus", "databus" ], "summary": "Token Launches Endpoint", "description": "Newly launched tokens with instant risk scoring by age.", "operationId": "token_launches_endpoint_api_v1_databus_premium_token_launches_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Token Launches Endpoint Api V1 Databus Premium Token Launches Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/insider-detection/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Insider Detection Endpoint", "description": "Detect pre-pump accumulation - volume spikes before major price moves.", "operationId": "insider_detection_endpoint_api_v1_databus_premium_insider_detection__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Insider Detection Endpoint Api V1 Databus Premium Insider Detection Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/liquidity-risk/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Liquidity Risk Endpoint", "description": "LP health: concentration risk, lock status, holder entities via Arkham.", "operationId": "liquidity_risk_endpoint_api_v1_databus_premium_liquidity_risk__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Liquidity Risk Endpoint Api V1 Databus Premium Liquidity Risk Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/holder-health/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Holder Health Endpoint", "description": "Holder distribution: Gini coefficient, top concentration, decentralization score.", "operationId": "holder_health_endpoint_api_v1_databus_premium_holder_health__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Holder Health Endpoint Api V1 Databus Premium Holder Health Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/cross-chain/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Cross Chain Endpoint", "description": "Trace entity across all chains via Arkham. Discover all related addresses.", "operationId": "cross_chain_endpoint_api_v1_databus_premium_cross_chain__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Cross Chain Endpoint Api V1 Databus Premium Cross Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/rug-patterns/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Rug Patterns Endpoint", "description": "Match token against 10 known rug pull patterns. Similarity scoring.", "operationId": "rug_patterns_endpoint_api_v1_databus_premium_rug_patterns__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Rug Patterns Endpoint Api V1 Databus Premium Rug Patterns Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/dev-reputation/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Dev Reputation Endpoint", "description": "Deployer wallet history: token count, lifespan, entity resolution.", "operationId": "dev_reputation_endpoint_api_v1_databus_premium_dev_reputation__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Dev Reputation Endpoint Api V1 Databus Premium Dev Reputation Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/premium/token-report/{address}": { "get": { "tags": [ "databus", "databus" ], "summary": "Token Report Endpoint", "description": "ONE-CALL enhanced token report. Smart verdicts, entity enrichment,\ntrust adjustments, tier-aware. THE endpoint powering RugCharts.", "operationId": "token_report_endpoint_api_v1_databus_premium_token_report__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Token Report Endpoint Api V1 Databus Premium Token Report Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/tiers": { "get": { "tags": [ "databus", "databus" ], "summary": "Tier Comparison Endpoint", "description": "Competitive tier comparison: RugCharts vs DexScreener vs Nansen vs GMGN.", "operationId": "tier_comparison_endpoint_api_v1_databus_tiers_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Tier Comparison Endpoint Api V1 Databus Tiers Get" } } } } } } }, "/api/v1/databus/market/prices": { "get": { "tags": [ "databus", "databus" ], "summary": "Market Prices", "description": "Live prices from CoinGecko. Free, no key needed.", "operationId": "market_prices_api_v1_databus_market_prices_get", "parameters": [ { "name": "coins", "in": "query", "required": false, "schema": { "type": "string", "default": "bitcoin,ethereum,solana", "title": "Coins" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Market Prices Api V1 Databus Market Prices Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/market/fear-greed": { "get": { "tags": [ "databus", "databus" ], "summary": "Fear Greed", "description": "Crypto Fear & Greed Index. Free, no key needed.", "operationId": "fear_greed_api_v1_databus_market_fear_greed_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Fear Greed Api V1 Databus Market Fear Greed Get" } } } } } } }, "/api/v1/databus/market/trending": { "get": { "tags": [ "databus", "databus" ], "summary": "Market Trending", "description": "Trending coins from CoinGecko.", "operationId": "market_trending_api_v1_databus_market_trending_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Market Trending Api V1 Databus Market Trending Get" } } } } } } }, "/api/v1/databus/market/brief": { "get": { "tags": [ "databus", "databus" ], "summary": "Market Brief", "description": "One-call market overview: prices + fear/greed + trending + predictions.", "operationId": "market_brief_api_v1_databus_market_brief_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Market Brief Api V1 Databus Market Brief Get" } } } } } } }, "/api/v1/databus/news/full": { "get": { "tags": [ "databus", "databus" ], "summary": "Full News", "description": "Complete news feed: headlines + market data + fear/greed + polymarket.", "operationId": "full_news_api_v1_databus_news_full_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 15, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Full News Api V1 Databus News Full Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/news/intel": { "get": { "tags": [ "databus", "databus" ], "summary": "News Intel", "description": "Complete news intelligence - 10+ sources, quality-scored, deduped, sentiment-tagged.", "operationId": "news_intel_api_v1_databus_news_intel_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 30, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response News Intel Api V1 Databus News Intel Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/news/weekly-best": { "get": { "tags": [ "databus", "databus" ], "summary": "Weekly Best", "description": "Curated weekly best - highest quality crypto journalism.", "operationId": "weekly_best_api_v1_databus_news_weekly_best_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Weekly Best Api V1 Databus News Weekly Best Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/news/academic": { "get": { "tags": [ "databus", "databus" ], "summary": "Academic Papers", "description": "Academic crypto/blockchain research papers from arXiv.", "operationId": "academic_papers_api_v1_databus_news_academic_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Academic Papers Api V1 Databus News Academic Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/news/social": { "get": { "tags": [ "databus", "databus" ], "summary": "Social Feed", "description": "Crypto social feed - X/Twitter + CryptoPanic sentiment.", "operationId": "social_feed_api_v1_databus_news_social_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 30, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Social Feed Api V1 Databus News Social Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/news/react/{content_hash}": { "post": { "tags": [ "databus", "databus" ], "summary": "React Article", "description": "React to article: \ud83d\udd25\ud83d\udc02\ud83d\udc3b\ud83d\udc8e\ud83e\udde0\ud83e\udd21\ud83d\ude80\ud83d\udc80", "operationId": "react_article_api_v1_databus_news_react__content_hash__post", "parameters": [ { "name": "content_hash", "in": "path", "required": true, "schema": { "type": "string", "title": "Content Hash" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response React Article Api V1 Databus News React Content Hash Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/news/reactions/{content_hash}": { "get": { "tags": [ "databus", "databus" ], "summary": "Get Article Reactions", "description": "Get reactions and comments for an article.", "operationId": "get_article_reactions_api_v1_databus_news_reactions__content_hash__get", "parameters": [ { "name": "content_hash", "in": "path", "required": true, "schema": { "type": "string", "title": "Content Hash" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Article Reactions Api V1 Databus News Reactions Content Hash Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/news/comment/{content_hash}": { "post": { "tags": [ "databus", "databus" ], "summary": "Comment Article", "description": "Comment on an article.", "operationId": "comment_article_api_v1_databus_news_comment__content_hash__post", "parameters": [ { "name": "content_hash", "in": "path", "required": true, "schema": { "type": "string", "title": "Content Hash" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Comment Article Api V1 Databus News Comment Content Hash Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/news/bb-post/{content_hash}": { "post": { "tags": [ "databus", "databus" ], "summary": "Create Bb From Article", "description": "Turn article into Bulletin Board post.", "operationId": "create_bb_from_article_api_v1_databus_news_bb_post__content_hash__post", "parameters": [ { "name": "content_hash", "in": "path", "required": true, "schema": { "type": "string", "title": "Content Hash" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Create Bb From Article Api V1 Databus News Bb Post Content Hash Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/news/ct-rundown": { "get": { "tags": [ "databus", "databus" ], "summary": "Ct Rundown", "description": "CT Rundown - top 20 Crypto Twitter stories, AI-summarized, category-diverse.", "operationId": "ct_rundown_api_v1_databus_news_ct_rundown_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Ct Rundown Api V1 Databus News Ct Rundown Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/news/ct-accounts": { "get": { "tags": [ "databus", "databus" ], "summary": "Ct Accounts", "description": "Curated CT account list - 150+ top accounts across 6 tiers.", "operationId": "ct_accounts_api_v1_databus_news_ct_accounts_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Ct Accounts Api V1 Databus News Ct Accounts Get" } } } } } } }, "/api/v1/databus/social/kol/{handle}": { "get": { "tags": [ "databus", "databus" ], "summary": "Kol Profile", "description": "KOL performance profile - trust score, call history, win rate.", "operationId": "kol_profile_api_v1_databus_social_kol__handle__get", "parameters": [ { "name": "handle", "in": "path", "required": true, "schema": { "type": "string", "title": "Handle" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Kol Profile Api V1 Databus Social Kol Handle Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/kol-leaderboard": { "get": { "tags": [ "databus", "databus" ], "summary": "Kol Leaderboard", "description": "KOL leaderboard - ranked by trust score and accuracy.", "operationId": "kol_leaderboard_api_v1_databus_social_kol_leaderboard_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Kol Leaderboard Api V1 Databus Social Kol Leaderboard Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/databus/social/shill-alerts": { "get": { "tags": [ "databus", "databus" ], "summary": "Shill Alerts", "description": "Active shill campaigns - coordinated promotion, pump-and-dump patterns.", "operationId": "shill_alerts_api_v1_databus_social_shill_alerts_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Shill Alerts Api V1 Databus Social Shill Alerts Get" } } } } } } }, "/api/v1/databus/social/scam-monitor": { "get": { "tags": [ "databus", "databus" ], "summary": "Scam Monitor", "description": "Scam channel monitoring - Telegram/Discord scam pattern detection.", "operationId": "scam_monitor_api_v1_databus_social_scam_monitor_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Scam Monitor Api V1 Databus Social Scam Monitor Get" } } } } } } }, "/api/v1/databus/social/metrics": { "get": { "tags": [ "databus", "databus" ], "summary": "Social Metrics", "description": "Social metrics - trending topics, sentiment, KOL activity.", "operationId": "social_metrics_api_v1_databus_social_metrics_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Social Metrics Api V1 Databus Social Metrics Get" } } } } } } }, "/api/v1/databus/intel/daily": { "get": { "tags": [ "databus", "databus" ], "summary": "Daily Intel", "description": "Daily Intelligence Report - Groq AI-powered market briefing with all data sources.", "operationId": "daily_intel_api_v1_databus_intel_daily_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Daily Intel Api V1 Databus Intel Daily Get" } } } } } } }, "/api/v1/databus/ingest": { "post": { "tags": [ "databus", "databus-ingest" ], "summary": "Ingest Intel", "description": "Receive intelligence from internal services.\n\nFire-and-forget: returns 202 once persisted. Downstream processing\n(RAG embedding, risk scoring feedback loops) runs asynchronously.", "operationId": "ingest_intel_api_v1_databus_ingest_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceIngestRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/alerts": { "get": { "tags": [ "alerts" ], "summary": "List Alerts", "description": "List all configured alert rules for the authenticated user.\n\nTODO: wire up to Postgres once auth context is established.\nReturns empty list as a stub so the factory can mount successfully.", "operationId": "list_alerts_alerts_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertList" } } } } } }, "post": { "tags": [ "alerts" ], "summary": "Create Alert", "description": "Create a new alert rule.\n\nReturns 501 until alert persistence is wired up. Stub so the\nfactory mounts this route without crashing.", "operationId": "create_alert_alerts_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertRule" } } }, "required": true }, "responses": { "501": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Create Alert Alerts Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/alerts/{rule_id}": { "delete": { "tags": [ "alerts" ], "summary": "Delete Alert", "description": "Delete an alert rule by ID.", "operationId": "delete_alert_alerts__rule_id__delete", "parameters": [ { "name": "rule_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Rule Id" } } ], "responses": { "501": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Delete Alert Alerts Rule Id Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/wallet/verify-signature": { "post": { "tags": [ "wallet" ], "summary": "Verify Wallet Signature", "description": "Verify a wallet signature for cross-app authentication.\n\nUsed by degenfeed and other RugMunch apps to cryptographically\nprove wallet ownership. Supports Solana (ed25519) and EVM (EIP-191).\nFalls back to delegated verification if crypto libs aren't installed.", "operationId": "verify_wallet_signature_wallet_verify_signature_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerifySignatureRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Verify Wallet Signature Wallet Verify Signature Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/wallet/{address}": { "get": { "tags": [ "wallet" ], "summary": "Resolve Wallet", "description": "Resolve a wallet address to its labels + summary.\n\nReturns 501 stub until label resolution is wired up.", "operationId": "resolve_wallet_wallet__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain (ethereum, solana, base, etc.)", "default": "ethereum", "title": "Chain" }, "description": "Blockchain (ethereum, solana, base, etc.)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletResolveResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/wallet/{address}/labels": { "get": { "tags": [ "wallet" ], "summary": "Get Wallet Labels", "description": "Return labels for a wallet from all federated sources.", "operationId": "get_wallet_labels_wallet__address__labels_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Get Wallet Labels Wallet Address Labels Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/wallet/{address}/history": { "get": { "tags": [ "wallet" ], "summary": "Get Wallet History", "description": "Return transaction history summary for a wallet.", "operationId": "get_wallet_history_wallet__address__history_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Wallet History Wallet Address History Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/token/{address}": { "get": { "tags": [ "token" ], "summary": "Get Token", "description": "Fetch basic token metadata.", "operationId": "get_token_token__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__api__v1__public__token__TokenSummary" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/token/{address}/risk": { "get": { "tags": [ "token" ], "summary": "Get Token Risk", "description": "Compute the risk score for a token (uses Bayesian reputation + on-chain checks).", "operationId": "get_token_risk_token__address__risk_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenRisk" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/token/{address}/holders": { "get": { "tags": [ "token" ], "summary": "Get Token Holders", "description": "Return top holders distribution for a token.", "operationId": "get_token_holders_token__address__holders_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "top", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Top" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Token Holders Token Address Holders Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rag/v2/search": { "post": { "tags": [ "rag" ], "summary": "Search", "description": "RAG search via rugbrain HTTP API.", "operationId": "search_api_v1_rag_v2_search_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rag/v2/ingest": { "post": { "tags": [ "rag" ], "summary": "Ingest", "description": "Ingest a document via rugbrain HTTP API.", "operationId": "ingest_api_v1_rag_v2_ingest_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestResult" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rag/v2/feedback": { "post": { "tags": [ "rag" ], "summary": "Feedback", "description": "Record scanner feedback \u2014 ingest known scam data into rugbrain.", "operationId": "feedback_api_v1_rag_v2_feedback_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedbackRecord" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestResult" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rag/v2/stats": { "get": { "tags": [ "rag" ], "summary": "Stats", "description": "Collection stats from Qdrant v2.", "operationId": "stats_api_v1_rag_v2_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Stats Api V1 Rag V2 Stats Get" } } } } } } }, "/api/v1/rag/v2/bulk-ingest": { "post": { "tags": [ "rag" ], "summary": "Bulk", "description": "Ingest many items into a collection via rugbrain. Sequential (max 500).", "operationId": "bulk_api_v1_rag_v2_bulk_ingest_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkIngestRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Bulk Api V1 Rag V2 Bulk Ingest Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rag/v2/ask": { "post": { "tags": [ "rag" ], "summary": "Ask Crypto Question", "description": "Run the agentic research graph over a crypto question.", "operationId": "ask_crypto_question_api_v1_rag_v2_ask_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AskRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AskResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rag/v2/evaluate": { "post": { "tags": [ "rag" ], "summary": "Evaluate Rag", "description": "Run Ragas evaluation on the RAG pipeline.\n\nLazy-imports ``app.rag.evaluation`` so the router stays importable even\nwhen ragas is not installed (evaluation falls back to heuristics).", "operationId": "evaluate_rag_api_v1_rag_v2_evaluate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluateRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Evaluate Rag Api V1 Rag V2 Evaluate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/alerts/webhook": { "post": { "tags": [ "admin" ], "summary": "Receive Alert Webhook", "description": "Receive an alert webhook from external monitoring.", "operationId": "receive_alert_webhook_alerts_webhook_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertWebhookPayload" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Receive Alert Webhook Alerts Webhook Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/_test/glitchtip": { "post": { "tags": [ "test" ], "summary": "Test Glitchtip", "description": "Trigger a test event. Tests the secret-scrubbing before_send hook.", "operationId": "test_glitchtip_api_v1__test_glitchtip_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GlitchtipTestRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Test Glitchtip Api V1 Test Glitchtip Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/catalog/stats": { "get": { "tags": [ "catalog" ], "summary": "Stats", "description": "Catalog stats: which stores are reachable + entity counts.", "operationId": "stats_api_v1_catalog_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Stats Api V1 Catalog Stats Get" } } } } } } }, "/api/v1/catalog/probe": { "get": { "tags": [ "catalog" ], "summary": "Probe", "description": "Probe which stores are reachable from this container.", "operationId": "probe_api_v1_catalog_probe_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Probe Api V1 Catalog Probe Get" } } } } } } }, "/api/v1/catalog/tokens/{chain}/{address}": { "get": { "tags": [ "catalog" ], "summary": "Get Token", "description": "Get a token by chain+address. Returns full Token model + provenance.", "operationId": "get_token_api_v1_catalog_tokens__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Token Api V1 Catalog Tokens Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/catalog/tokens/{chain}/{address}/risk": { "get": { "tags": [ "catalog" ], "summary": "Get Token Risk", "description": "Recipe 3 - Real-time risk score. Composes Redis + Postgres + Neo4j.", "operationId": "get_token_risk_api_v1_catalog_tokens__chain___address__risk_get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Token Risk Api V1 Catalog Tokens Chain Address Risk Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/catalog/tokens/risky-by-deployer": { "post": { "tags": [ "catalog" ], "summary": "Risky Tokens", "description": "Recipe 1 - Find tokens deployed by wallets with rug history.", "operationId": "risky_tokens_api_v1_catalog_tokens_risky_by_deployer_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FindRiskyTokensRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Risky Tokens Api V1 Catalog Tokens Risky By Deployer Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/catalog/wallets/{chain}/{address}": { "get": { "tags": [ "catalog" ], "summary": "Get Wallet", "description": "Look up a wallet by chain and address. Returns full wallet model with provenance, entity labels, and transaction history from the catalog store. Supports all 13+ tracked chains.", "operationId": "get_wallet_api_v1_catalog_wallets__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Wallet Api V1 Catalog Wallets Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/catalog/entities/resolve": { "post": { "tags": [ "catalog" ], "summary": "Resolve Entity", "description": "Cross-chain entity resolution via Neo4j Cypher.", "operationId": "resolve_entity_api_v1_catalog_entities_resolve_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveEntityRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Resolve Entity Api V1 Catalog Entities Resolve Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/catalog/rag/search": { "post": { "tags": [ "catalog" ], "summary": "Rag Search", "description": "Search the RAG system. Returns ranked hits with RRF scores.", "operationId": "rag_search_api_v1_catalog_rag_search_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RagSearchRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Rag Search Api V1 Catalog Rag Search Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/catalog/rag/ingest": { "post": { "tags": [ "catalog" ], "summary": "Rag Ingest", "description": "Ingest content into RAG. Returns qdrant_point_id for cross-store linking.", "operationId": "rag_ingest_api_v1_catalog_rag_ingest_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RagIngestRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Rag Ingest Api V1 Catalog Rag Ingest Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/catalog/tokens/{chain}/{address}/attach-rag": { "post": { "tags": [ "catalog" ], "summary": "Attach Rag", "description": "Link an existing RAG embedding (Qdrant point) to a Token row.", "operationId": "attach_rag_api_v1_catalog_tokens__chain___address__attach_rag_post", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachRagRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Attach Rag Api V1 Catalog Tokens Chain Address Attach Rag Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/agent/analyze": { "post": { "tags": [ "agent" ], "summary": "Analyze", "description": "Route a query to the appropriate specialist agent and return typed output.\n\nArgs:\n req: Query plus optional forced specialist and chain hint.\n\nReturns:\n AgentResponse wrapping the typed specialist result (TokenRiskResult,\n KnowledgeResult, or MarketResult) plus routing metadata.", "operationId": "analyze_api_v1_agent_analyze_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentQuery" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/ai/chart-analysis": { "post": { "tags": [ "ai-chart" ], "summary": "Chart Analysis", "description": "Run AI-powered technical analysis on OHLCV chart data.\n\nComputes technical indicators (RSI, MACD, Bollinger Bands, EMAs,\nsupport/resistance, pattern detection), then calls Qwen (via Ollama\nor OpenRouter) for human-readable analysis with trade signals.\n\nArgs:\n req: Chart data including OHLCV candles, current price, volume, etc.\n\nReturns:\n ChartAnalysisResponse with trend, signals, risk, and detailed AI analysis.", "operationId": "chart_analysis_api_v1_ai_chart_analysis_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartAnalysisRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChartAnalysisResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/local": { "post": { "tags": [ "local-chat" ], "summary": "Local Chat", "description": "Chat with free remote models. Quick mode uses snappy, deep mode uses long.", "operationId": "local_chat_api_v1_chat_local_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocalChatRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocalChatResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp": { "post": { "tags": [ "mcp" ], "summary": "Jsonrpc Handler", "description": "JSON-RPC 2.0 endpoint for MCP clients.\n\nMethods:\n - initialize \u2192 returns server info\n - tools/list \u2192 returns tool catalog\n - tools/call \u2192 dispatches to backend\n - resources/list \u2192 empty\n - prompts/list \u2192 empty", "operationId": "jsonrpc_handler_mcp_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonRpcRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Jsonrpc Handler Mcp Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp/tools": { "get": { "tags": [ "mcp" ], "summary": "List Tools", "description": "Plain JSON endpoint (for direct integration, no JSON-RPC).", "operationId": "list_tools_mcp_tools_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Tools Mcp Tools Get" } } } } } } }, "/mcp/info": { "get": { "tags": [ "mcp" ], "summary": "Server Info", "description": "Server metadata: version, protocol, tool count, capabilities.\n\nUse this to discover the MCP server's capabilities without listing all tools.\nEquivalent to MCP initialize handshake.", "operationId": "server_info_mcp_info_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Server Info Mcp Info Get" } } } } } } }, "/mcp/call/{tool_id}": { "post": { "tags": [ "mcp" ], "summary": "Direct Call", "description": "Direct tool execution (no JSON-RPC). For curl/scripts.", "operationId": "direct_call_mcp_call__tool_id__post", "parameters": [ { "name": "tool_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Tool Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Direct Call Mcp Call Tool Id Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news": { "post": { "tags": [ "news", "news" ], "summary": "List News", "description": "List news items with filters. Reads from both news_items (new) and crypto_news (legacy).", "operationId": "list_news_api_v1_news_post", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Chain" } }, { "name": "token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Token" } }, { "name": "category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" } }, { "name": "since_hours", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 720, "minimum": 1, "default": 24, "title": "Since Hours" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 20, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^(recency|relevance|sentiment)$", "default": "recency", "title": "Sort" } }, { "name": "clustered", "in": "query", "required": false, "schema": { "type": "boolean", "description": "T03: dedupe via MinHash+DBSCAN into stories", "default": false, "title": "Clustered" }, "description": "T03: dedupe via MinHash+DBSCAN into stories" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsListResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/trending": { "get": { "tags": [ "news", "news" ], "summary": "Trending News", "description": "Time-decay trending. Reads from news_items (new) primary, falls back to crypto_news (legacy).", "operationId": "trending_news_api_v1_news_trending_get", "parameters": [ { "name": "window_hours", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 720, "minimum": 1, "default": 168, "title": "Window Hours" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsListResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/stories/{cluster_id}/sources": { "get": { "tags": [ "news", "news" ], "summary": "Get Story Sources", "description": "Per-story source distribution for the bias-spectrum panel.\n\nGiven a story ``cluster_id`` (persisted by the T03 clustering job),\nreturn the distinct sources, per-source URLs, bias distribution and\nsentiment average so the panel can render who covers a story and from\nwhich bias angles. 404 when the cluster is unknown.", "operationId": "get_story_sources_api_v1_news_stories__cluster_id__sources_get", "parameters": [ { "name": "cluster_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cluster Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StorySourcesResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/articles/{news_id}": { "get": { "tags": [ "news", "news" ], "summary": "Get News", "description": "Single news item. Searches both news_items and crypto_news.", "operationId": "get_news_api_v1_articles__news_id__get", "parameters": [ { "name": "news_id", "in": "path", "required": true, "schema": { "type": "string", "title": "News Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsItemOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/articles/{news_id}/analyze": { "post": { "tags": [ "news", "news" ], "summary": "Analyze News", "description": "Generate LLM analysis via LiteLLM. Falls back to None if LLM unreachable.", "operationId": "analyze_news_api_v1_articles__news_id__analyze_post", "parameters": [ { "name": "news_id", "in": "path", "required": true, "schema": { "type": "string", "title": "News Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsAnalysisResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/{news_id}/react": { "post": { "tags": [ "news", "news" ], "summary": "React To News", "description": "Upsert a like/dislike vote. Sending the same reaction again toggles it off.", "operationId": "react_to_news_api_v1_news__news_id__react_post", "parameters": [ { "name": "news_id", "in": "path", "required": true, "schema": { "type": "string", "title": "News Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReactionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReactionsSummary" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/{news_id}/reactions": { "get": { "tags": [ "news", "news" ], "summary": "Get News Reactions", "description": "Reaction counts + the caller's vote (null when anonymous or no vote).", "operationId": "get_news_reactions_api_v1_news__news_id__reactions_get", "parameters": [ { "name": "news_id", "in": "path", "required": true, "schema": { "type": "string", "title": "News Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReactionsSummary" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/{news_id}/comments": { "get": { "tags": [ "news", "news" ], "summary": "List Comments", "description": "List comments for an article. Flat list; threads assemble client-side\nvia parent_id. Deleted comments return as tombstones (body=None, deleted=True).", "operationId": "list_comments_api_v1_news__news_id__comments_get", "parameters": [ { "name": "news_id", "in": "path", "required": true, "schema": { "type": "string", "title": "News Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommentListResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "news", "news" ], "summary": "Create Comment", "description": "Create a comment (optionally threaded via parent_id). Auth required.", "operationId": "create_comment_api_v1_news__news_id__comments_post", "parameters": [ { "name": "news_id", "in": "path", "required": true, "schema": { "type": "string", "title": "News Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommentCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommentOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/comment/{comment_id}": { "delete": { "tags": [ "news", "news" ], "summary": "Delete Comment", "description": "Soft-delete a comment (tombstone). Author, admin, or moderator only.", "operationId": "delete_comment_api_v1_news_comment__comment_id__delete", "parameters": [ { "name": "comment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Comment Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "boolean" }, "title": "Response Delete Comment Api V1 News Comment Comment Id Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/comment/{comment_id}/react": { "post": { "tags": [ "news", "news" ], "summary": "React To Comment", "description": "Upsert a like/dislike on a comment; same reaction again toggles it off.", "operationId": "react_to_comment_api_v1_news_comment__comment_id__react_post", "parameters": [ { "name": "comment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Comment Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReactionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommentReactionResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/_admin/ingest": { "post": { "tags": [ "news-admin" ], "summary": "Trigger Ingest", "description": "Trigger RSS ingest now (synchronous). Returns counts.", "operationId": "trigger_ingest_api_v1_news__admin_ingest_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Trigger Ingest Api V1 News Admin Ingest Post" } } } } } } }, "/api/v1/reports/generate": { "post": { "tags": [ "reports" ], "summary": "Generate Report", "description": "Generate a research report for a token or wallet.\n\nComposes 7 sections in parallel via LiteLLM. Falls back to templated\ncontent if LLM is unreachable. Saves to Postgres on success.", "operationId": "generate_report_api_v1_reports_generate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/reports/{report_id}": { "get": { "tags": [ "reports" ], "summary": "Get Report", "description": "Retrieve a previously generated report from Postgres.", "operationId": "get_report_api_v1_reports__report_id__get", "parameters": [ { "name": "report_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Report Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Report Api V1 Reports Report Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/pricing": { "get": { "tags": [ "x402" ], "summary": "Pricing", "description": "Return tier pricing summary \u2014 what each tier costs and what you get.", "operationId": "pricing_api_v1_x402_pricing_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PricingResponse" } } } } } } }, "/api/v1/x402/payment": { "post": { "tags": [ "x402" ], "summary": "Payment Init", "description": "Initiate a payment for a paid tool. Creates a signed invoice.\n\nRequest body:\n tool (required): tool name from /api/v1/x402/catalog\n agent_id (optional): your agent identifier", "operationId": "payment_init_api_v1_x402_payment_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentInitResponse" } } } } } } }, "/api/v1/x402/catalog": { "get": { "tags": [ "x402" ], "summary": "Catalog", "description": "List all paid tools with pricing tiers.", "operationId": "catalog_api_v1_x402_catalog_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CatalogResponse" } } } } } } }, "/api/v1/x402/usage": { "get": { "tags": [ "x402" ], "summary": "Usage", "description": "Per-agent usage stats: calls made, $ spent, top tools.", "operationId": "usage_api_v1_x402_usage_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UsageResponse" } } } } } } }, "/api/v1/x402/receipts/{tx_hash}": { "get": { "tags": [ "x402" ], "summary": "Receipt", "description": "Payment receipt for a specific on-chain tx.", "operationId": "receipt_api_v1_x402_receipts__tx_hash__get", "parameters": [ { "name": "tx_hash", "in": "path", "required": true, "schema": { "type": "string", "title": "Tx Hash" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReceiptResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/verify": { "post": { "tags": [ "x402" ], "summary": "Verify Payment", "description": "Verify an X-Payment header for a given tool.", "operationId": "verify_payment_api_v1_x402_verify_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Verify Payment Api V1 X402 Verify Post" } } } } } } }, "/mcp/x402": { "post": { "tags": [ "x402-MCP" ], "summary": "Mcp X402 Handler", "description": "MCP protocol handler for x402 payment tools.\n\nAccepts MCP-standard requests: {\"method\": \"tools/list\"} or\n{\"method\": \"tools/call\", \"params\": {\"name\": \"...\", \"arguments\": {...}}}", "operationId": "mcp_x402_handler_mcp_x402_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "additionalProperties": { "additionalProperties": true, "type": "object" }, "type": "object" }, { "additionalProperties": true, "type": "object" } ], "title": "Response Mcp X402 Handler Mcp X402 Post" } } } } } } }, "/.well-known/x402": { "get": { "tags": [ "x402-MCP" ], "summary": "Well Known X402", "description": "x402 service discovery document (RFC-like).\n\nStandard endpoint that x402-compatible clients check to discover\npayment capabilities, supported chains, pricing, and facilitator info.", "operationId": "well_known_x402__well_known_x402_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Well Known X402 Well Known X402 Get" } } } } } } }, "/x402/docs": { "get": { "tags": [ "x402-Docs" ], "summary": "X402 Docs Page", "description": "HTML documentation for the x402 payment system.", "operationId": "x402_docs_page_x402_docs_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Docs Page X402 Docs Get" } } } } } } }, "/x402/sandbox/create-invoice": { "post": { "tags": [ "x402-Docs" ], "summary": "Sandbox Create Invoice", "description": "Sandbox mode - create a test invoice without real payment.\n\nUse ?mode=test to get a fake invoice for integration testing.\nThe invoice includes a mock payment that self-verifies.", "operationId": "sandbox_create_invoice_x402_sandbox_create_invoice_post", "parameters": [ { "name": "tool", "in": "query", "required": true, "schema": { "type": "string", "title": "Tool" } }, { "name": "mode", "in": "query", "required": false, "schema": { "type": "string", "default": "test", "title": "Mode" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Sandbox Create Invoice X402 Sandbox Create Invoice Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/x402/sandbox/verify": { "post": { "tags": [ "x402-Docs" ], "summary": "Sandbox Verify Payment", "description": "Sandbox mode - verify a test payment.\n\nAccepts any tx_hash starting with '0xSANDBOX_' as valid.\nReturns mock verification result for integration testing.", "operationId": "sandbox_verify_payment_x402_sandbox_verify_post", "parameters": [ { "name": "tx_hash", "in": "query", "required": true, "schema": { "type": "string", "title": "Tx Hash" } }, { "name": "tool", "in": "query", "required": true, "schema": { "type": "string", "title": "Tool" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Sandbox Verify Payment X402 Sandbox Verify Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/webhooks/register": { "post": { "tags": [ "x402-Growth" ], "summary": "Register Webhook", "description": "Register a webhook URL for payment notifications.\n\nEvents: payment.confirmed (when payment is verified), payment.failed,\npayment.refunded, trial.exhausted\n\nWebhook payload:\n{\n \"event\": \"payment.confirmed\",\n \"tx_hash\": \"0x...\",\n \"tool\": \"token_scan\",\n \"amount_usd\": 0.02,\n \"chain\": \"base\",\n \"timestamp\": 1234567890\n}", "operationId": "register_webhook_api_v1_x402_webhooks_register_post", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "title": "Url" } }, { "name": "events", "in": "query", "required": false, "schema": { "type": "string", "default": "payment.confirmed", "title": "Events" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Register Webhook Api V1 X402 Webhooks Register Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/webhooks": { "get": { "tags": [ "x402-Growth" ], "summary": "List Webhooks", "description": "List registered webhooks.", "operationId": "list_webhooks_api_v1_x402_webhooks_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Webhooks Api V1 X402 Webhooks Get" } } } } } } }, "/api/v1/x402/webhooks/{hook_id}": { "delete": { "tags": [ "x402-Growth" ], "summary": "Delete Webhook", "description": "Delete a webhook.", "operationId": "delete_webhook_api_v1_x402_webhooks__hook_id__delete", "parameters": [ { "name": "hook_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Hook Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "boolean" }, "title": "Response Delete Webhook Api V1 X402 Webhooks Hook Id Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/webhooks/events": { "get": { "tags": [ "x402-Growth" ], "summary": "Webhook Events", "description": "View recent webhook delivery events.", "operationId": "webhook_events_api_v1_x402_webhooks_events_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Webhook Events Api V1 X402 Webhooks Events Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/pay/{invoice_id}": { "get": { "tags": [ "x402-Growth" ], "summary": "Payment Page", "description": "Hosted payment page for x402 invoices.\n\nUsers connect their wallet and pay USDC with one click.\nOn confirmation, they're redirected to the tool result.", "operationId": "payment_page_api_v1_x402_pay__invoice_id__get", "parameters": [ { "name": "invoice_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Invoice Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Payment Page Api V1 X402 Pay Invoice Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/invoice/{invoice_id}": { "get": { "tags": [ "x402-Growth" ], "summary": "Get Invoice", "description": "Get invoice details (for hosted payment page).", "operationId": "get_invoice_api_v1_x402_invoice__invoice_id__get", "parameters": [ { "name": "invoice_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Invoice Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Invoice Api V1 X402 Invoice Invoice Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/chains/add": { "post": { "tags": [ "x402-Growth" ], "summary": "Add Chains", "description": "Register Polygon, Arbitrum, Optimism, Avalanche into CHAIN_USDC.\n\nThis extends payment coverage from 7 to 11 chains.\nThe new chains use self-verification (same EVM wallet works across all).", "operationId": "add_chains_api_v1_x402_chains_add_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Add Chains Api V1 X402 Chains Add Post" } } } } } } }, "/api/v1/x402/chains": { "get": { "tags": [ "x402-Growth" ], "summary": "List Chains", "description": "List all payment chains with USDC addresses.", "operationId": "list_chains_api_v1_x402_chains_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Chains Api V1 X402 Chains Get" } } } } } } }, "/api/v1/x402/affiliates/register": { "post": { "tags": [ "x402-Growth" ], "summary": "Register Affiliate", "description": "Register an affiliate account.\n\nAffiliates earn 10% of all x402 fees paid by users they refer.\nPayouts in USDC monthly.", "operationId": "register_affiliate_api_v1_x402_affiliates_register_post", "parameters": [ { "name": "name", "in": "query", "required": true, "schema": { "type": "string", "title": "Name" } }, { "name": "email", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Email" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Register Affiliate Api V1 X402 Affiliates Register Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/affiliates/{code}": { "get": { "tags": [ "x402-Growth" ], "summary": "Affiliate Stats", "description": "Get affiliate stats - earnings, referrals, payouts.", "operationId": "affiliate_stats_api_v1_x402_affiliates__code__get", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "title": "Code" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Affiliate Stats Api V1 X402 Affiliates Code Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/affiliates": { "get": { "tags": [ "x402-Growth" ], "summary": "List Affiliates", "description": "List all affiliates.", "operationId": "list_affiliates_api_v1_x402_affiliates_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Affiliates Api V1 X402 Affiliates Get" } } } } } } }, "/docs/v2/landing": { "get": { "tags": [ "API-Docs" ], "summary": "Landing Page", "description": "Landing page - the product is token intelligence, not x402.", "operationId": "landing_page_docs_v2_landing_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Landing Page Docs V2 Landing Get" } } } } } } }, "/docs": { "get": { "tags": [ "API-Docs" ], "summary": "Docs Landing", "description": "Landing page for the x402 API documentation portal.", "operationId": "landing_page_docs_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Landing Page Docs Get" } } } } } } }, "/docs/v2/quickstart": { "get": { "tags": [ "API-Docs" ], "summary": "Quickstart", "description": "Quickstart guide for the x402 API. Shows how to get started with token scanning, wallet analysis, and x402 payments.", "operationId": "quickstart_docs_v2_quickstart_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Quickstart Docs V2 Quickstart Get" } } } } } } }, "/docs/v2/api-reference": { "get": { "tags": [ "API-Docs" ], "summary": "Api Reference", "description": "Full API reference documentation for all x402 endpoints, including request/response schemas and authentication.", "operationId": "api_reference_docs_v2_api_reference_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Api Reference Docs V2 Api Reference Get" } } } } } } }, "/old-docs": { "get": { "tags": [ "API-Docs" ], "summary": "Redirect Old Docs", "description": "Redirect old x402 docs to the new developer-friendly docs.", "operationId": "redirect_old_docs_old_docs_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Redirect Old Docs Old Docs Get" } } } } } } }, "/api/v1/stripe/checkout": { "post": { "tags": [ "Stripe" ], "summary": "Create Checkout", "description": "Create a Stripe checkout session for credit purchase.", "operationId": "create_checkout_api_v1_stripe_checkout_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ {}, { "additionalProperties": true, "type": "object" } ], "title": "Response Create Checkout Api V1 Stripe Checkout Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/stripe/webhook": { "post": { "tags": [ "Stripe" ], "summary": "Stripe Webhook", "description": "Stripe webhook - called when payment succeeds.", "operationId": "stripe_webhook_api_v1_stripe_webhook_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "additionalProperties": { "type": "boolean" }, "type": "object" }, {} ], "title": "Response Stripe Webhook Api V1 Stripe Webhook Post" } } } } } } }, "/api/v1/stripe/packages": { "get": { "tags": [ "Stripe" ], "summary": "List Packages", "description": "List available credit packages and subscription tiers.", "operationId": "list_packages_api_v1_stripe_packages_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Packages Api V1 Stripe Packages Get" } } } } } } }, "/api/v1/credits/balance": { "get": { "tags": [ "Stripe" ], "summary": "Check Balance", "description": "Check remaining credit balance for an API key.", "operationId": "check_balance_api_v1_credits_balance_get", "parameters": [ { "name": "api_key", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Api Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": { "anyOf": [ { "type": "integer" }, { "type": "number" } ] } }, { "type": "object", "additionalProperties": { "type": "string" } } ], "title": "Response Check Balance Api V1 Credits Balance Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/credits/buy": { "post": { "tags": [ "Stripe" ], "summary": "Buy Credits", "description": "Buy credits directly via API (wraps Stripe checkout).\n\nIn production, this creates a Stripe checkout session.\nFor testing, credits are added directly when STRIPE_ENABLED is False.", "operationId": "buy_credits_api_v1_credits_buy_post", "parameters": [ { "name": "api_key", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Api Key" } }, { "name": "amount_usd", "in": "query", "required": false, "schema": { "type": "integer", "default": 1000, "title": "Amount Usd" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Buy Credits Api V1 Credits Buy Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/stripe/portal": { "get": { "tags": [ "Stripe" ], "summary": "Customer Portal", "description": "Stripe customer portal for managing subscriptions.", "operationId": "customer_portal_api_v1_stripe_portal_get", "parameters": [ { "name": "customer_id", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Customer Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": true }, {} ], "title": "Response Customer Portal Api V1 Stripe Portal Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/pricing": { "get": { "tags": [ "Stripe" ], "summary": "Get Pricing", "description": "Pricing page data \u2014 frontend-compatible format.\n\nUsed by: rmi-frontend/src/pages/PricingPage.tsx\nExpected format: { tiers: { ... }, discounts: { ... }, crypto_chains: [...], enterprise_contact: \"...\" }", "operationId": "get_pricing_api_v1_pricing_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Pricing Api V1 Pricing Get" } } } } } } }, "/api/v1/subscription/create": { "post": { "tags": [ "Stripe" ], "summary": "Create Subscription", "description": "Create a subscription/checkout session \u2014 frontend-compatible.\n\nUsed by: rmi-frontend/src/pages/PricingPage.tsx", "operationId": "create_subscription_api_v1_subscription_create_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscriptionCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Subscription Api V1 Subscription Create Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/posts": { "get": { "tags": [ "bulletin-board" ], "summary": "Admin List Posts", "description": "List all posts (admin view with full data).", "operationId": "admin_list_posts_api_v1_bulletin_board_admin_bulletin_posts_get", "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Category" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Status" } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Search" } }, { "name": "pinned", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Pinned" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "default": "created_at", "title": "Sort By" } }, { "name": "sort_order", "in": "query", "required": false, "schema": { "type": "string", "default": "desc", "title": "Sort Order" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Admin List Posts Api V1 Bulletin Board Admin Bulletin Posts Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "bulletin-board" ], "summary": "Admin Create Post", "description": "Create a new bulletin board post. Supports Markdown content, categories, tags, meta description, scheduled publishing, and pinning.", "operationId": "admin_create_post_api_v1_bulletin_board_admin_bulletin_posts_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__bulletin_board__models__CreatePostRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Admin Create Post Api V1 Bulletin Board Admin Bulletin Posts Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/posts/{post_id}": { "get": { "tags": [ "bulletin-board" ], "summary": "Admin Get Post", "description": "Get full post details (admin).", "operationId": "admin_get_post_api_v1_bulletin_board_admin_bulletin_posts__post_id__get", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": true }, "title": "Response Admin Get Post Api V1 Bulletin Board Admin Bulletin Posts Post Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "bulletin-board" ], "summary": "Admin Update Post", "description": "Update an existing post. Supports partial updates: title, content, category, tags, meta description, and scheduled publish date.", "operationId": "admin_update_post_api_v1_bulletin_board_admin_bulletin_posts__post_id__put", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdatePostRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Admin Update Post Api V1 Bulletin Board Admin Bulletin Posts Post Id Put" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "bulletin-board" ], "summary": "Admin Delete Post", "description": "Soft-delete (archive) a post. Archived posts are hidden from public views but retained in the database for recovery.", "operationId": "admin_delete_post_api_v1_bulletin_board_admin_bulletin_posts__post_id__delete", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Admin Delete Post Api V1 Bulletin Board Admin Bulletin Posts Post Id Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/posts/{post_id}/publish": { "post": { "tags": [ "bulletin-board" ], "summary": "Admin Publish Post", "description": "Immediately publish a draft or scheduled post. Sets the published_at timestamp and makes it visible to the public.", "operationId": "admin_publish_post_api_v1_bulletin_board_admin_bulletin_posts__post_id__publish_post", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Admin Publish Post Api V1 Bulletin Board Admin Bulletin Posts Post Id Publish Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/posts/{post_id}/unpublish": { "post": { "tags": [ "bulletin-board" ], "summary": "Admin Unpublish Post", "description": "Unpublish a post and return it to draft status. The post becomes hidden from public views.", "operationId": "admin_unpublish_post_api_v1_bulletin_board_admin_bulletin_posts__post_id__unpublish_post", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "boolean" }, "title": "Response Admin Unpublish Post Api V1 Bulletin Board Admin Bulletin Posts Post Id Unpublish Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/posts/{post_id}/pin": { "post": { "tags": [ "bulletin-board" ], "summary": "Admin Pin Post", "description": "Toggle the pinned status of a post. Pinned posts appear at the top of bulletin listings.", "operationId": "admin_pin_post_api_v1_bulletin_board_admin_bulletin_posts__post_id__pin_post", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "boolean" }, "title": "Response Admin Pin Post Api V1 Bulletin Board Admin Bulletin Posts Post Id Pin Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/stats": { "get": { "tags": [ "bulletin-board" ], "summary": "Admin Bulletin Stats", "description": "Get bulletin board statistics.", "operationId": "admin_bulletin_stats_api_v1_bulletin_board_admin_bulletin_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Admin Bulletin Stats Api V1 Bulletin Board Admin Bulletin Stats Get" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/scheduled": { "get": { "tags": [ "bulletin-board" ], "summary": "Admin Scheduled Posts", "description": "List scheduled posts waiting to be published.", "operationId": "admin_scheduled_posts_api_v1_bulletin_board_admin_bulletin_scheduled_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Admin Scheduled Posts Api V1 Bulletin Board Admin Bulletin Scheduled Get" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/process-scheduled": { "post": { "tags": [ "bulletin-board" ], "summary": "Admin Process Scheduled", "description": "Process scheduled posts (publish ones that are due).", "operationId": "admin_process_scheduled_api_v1_bulletin_board_admin_bulletin_process_scheduled_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Admin Process Scheduled Api V1 Bulletin Board Admin Bulletin Process Scheduled Post" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/process-expired": { "post": { "tags": [ "bulletin-board" ], "summary": "Admin Process Expired", "description": "Process expired posts (archive ones past expiry).", "operationId": "admin_process_expired_api_v1_bulletin_board_admin_bulletin_process_expired_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Admin Process Expired Api V1 Bulletin Board Admin Bulletin Process Expired Post" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/posts/{post_id}/comments": { "get": { "tags": [ "bulletin-board" ], "summary": "Admin Get Comments", "description": "Get all comments for a post (admin moderation view).", "operationId": "admin_get_comments_api_v1_bulletin_board_admin_bulletin_posts__post_id__comments_get", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Admin Get Comments Api V1 Bulletin Board Admin Bulletin Posts Post Id Comments Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/admin/bulletin/comments/{comment_id}/moderate": { "post": { "tags": [ "bulletin-board" ], "summary": "Admin Moderate Comment", "description": "Moderate a comment (approve/reject).", "operationId": "admin_moderate_comment_api_v1_bulletin_board_admin_bulletin_comments__comment_id__moderate_post", "parameters": [ { "name": "comment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Comment Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "boolean" }, "title": "Response Admin Moderate Comment Api V1 Bulletin Board Admin Bulletin Comments Comment Id Moderate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/posts/public": { "post": { "tags": [ "bulletin-board" ], "summary": "Public Create Post", "description": "Create a public discussion post without authentication. For community token discussions. Posts are published immediately with community category.", "operationId": "public_create_post_api_v1_bulletin_board_posts_public_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicPostRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Public Create Post Api V1 Bulletin Board Posts Public Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/posts": { "get": { "tags": [ "bulletin-board" ], "summary": "Public List Posts", "description": "List published bulletin board posts with pagination. Returns title, slug, excerpt, author, category, publish date, and metadata. Filters by category and search query.", "operationId": "public_list_posts_api_v1_bulletin_board_posts_get", "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Category" } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Search" } }, { "name": "tag", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Tag" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Public List Posts Api V1 Bulletin Board Posts Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/posts/{slug}": { "get": { "tags": [ "bulletin-board" ], "summary": "Public Get Post", "description": "Get a single published post by slug (public).", "operationId": "public_get_post_api_v1_bulletin_board_posts__slug__get", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "title": "Slug" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Public Get Post Api V1 Bulletin Board Posts Slug Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/categories": { "get": { "tags": [ "bulletin-board" ], "summary": "Public Categories", "description": "List all post categories with the count of published posts in each. Useful for navigation and filtering.", "operationId": "public_categories_api_v1_bulletin_board_categories_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Public Categories Api V1 Bulletin Board Categories Get" } } } } } } }, "/api/v1/bulletin-board/pinned": { "get": { "tags": [ "bulletin-board" ], "summary": "Public Pinned Posts", "description": "Get pinned posts that are featured at the top of the bulletin board. Pinned posts are manually curated by admins.", "operationId": "public_pinned_posts_api_v1_bulletin_board_pinned_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 5, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Public Pinned Posts Api V1 Bulletin Board Pinned Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/badges/{user_id}": { "get": { "tags": [ "bulletin-board" ], "summary": "Get Badges", "description": "Get all badges earned by a specific user. Includes badge name, description, icon URL, and earned date.", "operationId": "get_badges_api_v1_bulletin_board_badges__user_id__get", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Badges Api V1 Bulletin Board Badges User Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/leaderboard": { "get": { "tags": [ "bulletin-board" ], "summary": "Get Leaderboard", "description": "Top users by reputation score. Returns ranking with username, score, badge count, and level.", "operationId": "get_leaderboard_api_v1_bulletin_board_leaderboard_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Leaderboard Api V1 Bulletin Board Leaderboard Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/x402/bot-post": { "post": { "tags": [ "bulletin-board" ], "summary": "X402 Bot Post", "description": "Bot posting via x402 - $1 TO JOIN (one-time, 30-day membership).\nPay $1 once, post unlimited for 30 days. Includes badges.", "operationId": "x402_bot_post_api_v1_bulletin_board_x402_bot_post_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Data" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response X402 Bot Post Api V1 Bulletin Board X402 Bot Post Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bulletin-board/x402/info": { "get": { "tags": [ "bulletin-board" ], "summary": "X402 Bot Info", "description": "Info for bots wanting to join the Bulletin Board.\n\nMembership requires a real on-chain USDC payment verified against the\nconfigured payment address (``BB_X402_PAYMENT_ADDRESS``). When no address\nis configured the endpoint says so explicitly \u2014 the old \"$1 to join\"\nhonor-system framing is gone.", "operationId": "x402_bot_info_api_v1_bulletin_board_x402_info_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response X402 Bot Info Api V1 Bulletin Board X402 Info Get" } } } } } } }, "/api/v1/intelligence/market-update": { "post": { "tags": [ "intelligence" ], "summary": "Receive Market Update", "description": "Receive market intelligence update from n8n workflow.", "operationId": "receive_market_update_api_v1_intelligence_market_update_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketUpdate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Receive Market Update Api V1 Intelligence Market Update Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/security-update": { "post": { "tags": [ "intelligence" ], "summary": "Receive Security Update", "description": "Receive security intelligence update from n8n workflow.", "operationId": "receive_security_update_api_v1_intelligence_security_update_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketUpdate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Receive Security Update Api V1 Intelligence Security Update Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/market/trending": { "get": { "tags": [ "intelligence" ], "summary": "Get Trending Tokens", "description": "Fetch trending tokens across multiple chains from DexScreener and CoinGecko. Returns tokens ranked by volume and social momentum. Supports chain and limit filtering.", "operationId": "get_trending_tokens_api_v1_intelligence_market_trending_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain", "default": "solana", "title": "Chain" }, "description": "Blockchain" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of results", "default": 50, "title": "Limit" }, "description": "Number of results" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Trending Tokens Api V1 Intelligence Market Trending Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/market/whales": { "get": { "tags": [ "intelligence" ], "summary": "Get Whale Movements", "description": "Detect large wallet transactions and whale movements across supported chains. Returns recent high-value transfers with entity labels when available.", "operationId": "get_whale_movements_api_v1_intelligence_market_whales_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "min_amount_usd", "in": "query", "required": false, "schema": { "type": "number", "default": 10000, "title": "Min Amount Usd" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Whale Movements Api V1 Intelligence Market Whales Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/market/volume-spikes": { "get": { "tags": [ "intelligence" ], "summary": "Get Volume Spikes", "description": "Alert on sudden volume spikes indicating coordinated trading activity or potential pump-and-dump events. Configurable threshold via query params.", "operationId": "get_volume_spikes_api_v1_intelligence_market_volume_spikes_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "min_change_pct", "in": "query", "required": false, "schema": { "type": "number", "default": 100, "title": "Min Change Pct" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Volume Spikes Api V1 Intelligence Market Volume Spikes Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/premium/smart-money": { "get": { "tags": [ "intelligence" ], "summary": "Get Smart Money Activities", "description": "Get smart money activities (premium feature).", "operationId": "get_smart_money_activities_api_v1_intelligence_premium_smart_money_get", "parameters": [ { "name": "wallet_category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Category" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Smart Money Activities Api V1 Intelligence Premium Smart Money Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/premium/exchange-flows": { "get": { "tags": [ "intelligence" ], "summary": "Get Exchange Flows", "description": "Get exchange flow analysis (premium feature).", "operationId": "get_exchange_flows_api_v1_intelligence_premium_exchange_flows_get", "parameters": [ { "name": "exchange_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Exchange Name" } }, { "name": "flow_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Flow Type" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Exchange Flows Api V1 Intelligence Premium Exchange Flows Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/security/scams": { "get": { "tags": [ "intelligence" ], "summary": "Get Scam Alerts", "description": "Real-time scam alerts aggregated from community reports, on-chain analysis, and threat intel feeds. Includes contract addresses, scam type classification, and severity ratings.", "operationId": "get_scam_alerts_api_v1_intelligence_security_scams_get", "parameters": [ { "name": "scam_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scam Type" } }, { "name": "confirmed_only", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Confirmed Only" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Scam Alerts Api V1 Intelligence Security Scams Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/security/rugpulls": { "get": { "tags": [ "intelligence" ], "summary": "Get Rugpull Alerts", "description": "Real-time rugpull alerts with liquidity analysis, deployer history, and honeypot detection. Flags tokens showing rugpull indicators within the configured time window.", "operationId": "get_rugpull_alerts_api_v1_intelligence_security_rugpulls_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Rugpull Alerts Api V1 Intelligence Security Rugpulls Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/me/alerts": { "get": { "tags": [ "intelligence" ], "summary": "Get My Alerts", "description": "Get intelligence alerts for the authenticated user. Returns personalized alerts based on watched wallets, tokens, and configured notification preferences.", "operationId": "get_my_alerts_api_v1_intelligence_me_alerts_get", "parameters": [ { "name": "unread_only", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Unread Only" } }, { "name": "severity", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get My Alerts Api V1 Intelligence Me Alerts Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/me/alerts/{alert_id}/dismiss": { "post": { "tags": [ "intelligence" ], "summary": "Dismiss Alert", "description": "Dismiss a specific intelligence alert. The alert will be removed from the active queue but retained in history for audit.", "operationId": "dismiss_alert_api_v1_intelligence_me_alerts__alert_id__dismiss_post", "parameters": [ { "name": "alert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Alert Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "type": "string", "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Dismiss Alert Api V1 Intelligence Me Alerts Alert Id Dismiss Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/dashboard": { "get": { "tags": [ "intelligence" ], "summary": "Intelligence Dashboard", "description": "Aggregated market intelligence dashboard \u2014 fear & greed, global stats, trending, DeFi TVL, BTC mempool. Aggregates data from CoinGecko, DeFiLlama, Mempool.space, and Alternative.me.", "operationId": "intelligence_dashboard_api_v1_intelligence_dashboard_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Intelligence Dashboard Api V1 Intelligence Dashboard Get" } } } } } } }, "/api/v1/intelligence/health": { "get": { "tags": [ "intelligence" ], "summary": "Intelligence Health", "description": "Intelligence service health check. Verifies connectivity to n8n, Supabase, and internal intelligence pipelines. Returns status for each subsystem.", "operationId": "intelligence_health_api_v1_intelligence_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Intelligence Health Api V1 Intelligence Health Get" } } } } } } }, "/api/v1/intelligence/cards/generate": { "post": { "tags": [ "intelligence" ], "summary": "Generate Card", "description": "Generate shareable card (win, loss, KOL, rug, etc.).", "operationId": "generate_card_api_v1_intelligence_cards_generate_post", "parameters": [ { "name": "card_type", "in": "query", "required": true, "schema": { "type": "string", "title": "Card Type" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Data" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Generate Card Api V1 Intelligence Cards Generate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/cards/templates": { "get": { "tags": [ "intelligence" ], "summary": "Get Card Templates", "description": "List available intelligence card templates for generating shareable security/market insight graphics.", "operationId": "get_card_templates_api_v1_intelligence_cards_templates_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "type": "object", "title": "Response Get Card Templates Api V1 Intelligence Cards Templates Get" } } } } } } }, "/api/v1/intelligence/marketing/templates": { "get": { "tags": [ "intelligence" ], "summary": "List Marketing Templates Endpoint", "description": "List available marketing graphic templates.", "operationId": "list_marketing_templates_endpoint_api_v1_intelligence_marketing_templates_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Marketing Templates Endpoint Api V1 Intelligence Marketing Templates Get" } } } } } } }, "/api/v1/intelligence/marketing/generate": { "post": { "tags": [ "intelligence" ], "summary": "Generate Marketing Graphic", "description": "Generate marketing graphic (banner, feature card, stats, etc.).", "operationId": "generate_marketing_graphic_api_v1_intelligence_marketing_generate_post", "parameters": [ { "name": "graphic_type", "in": "query", "required": true, "schema": { "type": "string", "title": "Graphic Type" } } ], "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": true }, { "type": "null" } ], "title": "Data" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Generate Marketing Graphic Api V1 Intelligence Marketing Generate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/marketing/generate/feature-cards": { "post": { "tags": [ "intelligence" ], "summary": "Generate All Feature Cards Endpoint", "description": "Generate feature showcase cards for all features.", "operationId": "generate_all_feature_cards_endpoint_api_v1_intelligence_marketing_generate_feature_cards_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Generate All Feature Cards Endpoint Api V1 Intelligence Marketing Generate Feature Cards Post" } } } } } } }, "/api/v1/intelligence/marketing/generate/stats": { "post": { "tags": [ "intelligence" ], "summary": "Generate Stats Graphic", "description": "Generate a stats/metrics marketing graphic from the provided stat value, label, and context. Returns a rendered image URL.", "operationId": "generate_stats_graphic_api_v1_intelligence_marketing_generate_stats_post", "parameters": [ { "name": "stat_value", "in": "query", "required": true, "schema": { "type": "string", "title": "Stat Value" } }, { "name": "stat_label", "in": "query", "required": true, "schema": { "type": "string", "title": "Stat Label" } }, { "name": "context", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Context" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Generate Stats Graphic Api V1 Intelligence Marketing Generate Stats Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/marketing/generate/pricing": { "post": { "tags": [ "intelligence" ], "summary": "Generate Pricing Graphic", "description": "Generate a pricing tier marketing graphic with the given tier name, price, and feature list. Returns a rendered image URL.", "operationId": "generate_pricing_graphic_api_v1_intelligence_marketing_generate_pricing_post", "parameters": [ { "name": "tier_name", "in": "query", "required": true, "schema": { "type": "string", "title": "Tier Name" } }, { "name": "price", "in": "query", "required": true, "schema": { "type": "number", "title": "Price" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" }, "title": "Features" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Generate Pricing Graphic Api V1 Intelligence Marketing Generate Pricing Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/prediction-signals": { "get": { "tags": [ "intelligence-panel" ], "summary": "Get Prediction Signals", "description": "Get actionable intelligence signals from prediction markets.\n\nSignal types:\n - HIGH_CONSENSUS_THREAT: Markets strongly expect an adverse event\n - LOW_CONSENSUS_RISK: Markets dismiss a feared risk\n - TOKEN_RISK_SIGNAL: Specific token flagged by prediction markets\n - ECOSYSTEM_RISK: Broad ecosystem-level threat indicator\n\nEach signal includes: severity, plain-English insight, recommended action.", "operationId": "get_prediction_signals_api_v1_intelligence_prediction_signals_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 20, "minimum": 1, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/IntelSignalResponse" }, "title": "Response Get Prediction Signals Api V1 Intelligence Prediction Signals Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/crypto-fear-index": { "get": { "tags": [ "intelligence-panel" ], "summary": "Get Crypto Fear Index", "description": "Get the Crypto Fear Index - risk aggregated from prediction markets.\n\nComponents:\n - overall_risk: Weighted aggregate of all categories\n - exploit_risk: DeFi hack/exploit/vulnerability probability\n - regulatory_risk: SEC/CFTC/enforcement action probability\n - stablecoin_risk: Depeg/collapse probability\n - exchange_risk: Insolvency/breach probability\n\nDerived from live prediction market data across Polymarket, Kalshi, Limitless, Manifold.\nHigher = more risk priced in by traders with real money at stake.", "operationId": "get_crypto_fear_index_api_v1_intelligence_crypto_fear_index_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FearIndexResponse" } } } } } } }, "/api/v1/intelligence/feed": { "get": { "tags": [ "intelligence-panel" ], "summary": "Get Intelligence Feed", "description": "Get aggregated intelligence feed combining all sources.", "operationId": "get_intelligence_feed_api_v1_intelligence_feed_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IntelligenceFeedResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/intelligence/latest": { "get": { "tags": [ "intelligence-panel" ], "summary": "Get Latest Intelligence", "description": "Get latest intelligence snapshot for quick updates.", "operationId": "get_latest_intelligence_api_v1_intelligence_latest_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Latest Intelligence Api V1 Intelligence Latest Get" } } } } } } }, "/api/v1/chat/history": { "get": { "tags": [ "chat", "chat" ], "summary": "Chat History", "description": "Get user's chat history.", "operationId": "chat_history_api_v1_chat_history_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Chat History Api V1 Chat History Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "chat", "chat" ], "summary": "Clear Chat History", "description": "Clear user's chat history.", "operationId": "clear_chat_history_api_v1_chat_history_delete", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Clear Chat History Api V1 Chat History Delete" } } } } } } }, "/api/v1/chat/stats": { "get": { "tags": [ "chat", "chat" ], "summary": "Chat Stats", "description": "Get user's chat statistics.", "operationId": "chat_stats_api_v1_chat_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Chat Stats Api V1 Chat Stats Get" } } } } } } }, "/api/v1/chat": { "post": { "tags": [ "chat" ], "summary": "Chat", "description": "Send a message and get an AI response (non-streaming).", "operationId": "chat_api_v1_chat_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Chat Api V1 Chat Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/stream": { "post": { "tags": [ "chat" ], "summary": "Chat Stream", "description": "Streaming chat endpoint using Server-Sent Events (SSE).", "operationId": "chat_stream_api_v1_chat_stream_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__chat___chat_models__StreamRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ {}, { "type": "null" } ], "title": "Response Chat Stream Api V1 Chat Stream Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/pay": { "post": { "tags": [ "chat-web3" ], "summary": "Chat Pay", "description": "Send a payment in chat. Requires wallet confirmation.\n\nValidates the payment, provides gas estimation, and returns\na payment request object for the frontend to confirm/sign.", "operationId": "chat_pay_api_v1_chat_web3_pay_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PayRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Chat Pay Api V1 Chat Web3 Pay Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/pay/confirm": { "post": { "tags": [ "chat-web3" ], "summary": "Confirm Payment", "description": "Confirm a payment with a transaction hash after wallet signing.", "operationId": "confirm_payment_api_v1_chat_web3_pay_confirm_post", "parameters": [ { "name": "payment_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Payment ID to confirm", "title": "Payment Id" }, "description": "Payment ID to confirm" }, { "name": "tx_hash", "in": "query", "required": true, "schema": { "type": "string", "description": "Transaction hash from wallet", "title": "Tx Hash" }, "description": "Transaction hash from wallet" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Confirm Payment Api V1 Chat Web3 Pay Confirm Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/tip": { "post": { "tags": [ "chat-web3" ], "summary": "Chat Tip", "description": "Tip a user in any room.", "operationId": "chat_tip_api_v1_chat_web3_tip_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TipRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Chat Tip Api V1 Chat Web3 Tip Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/request": { "post": { "tags": [ "chat-web3" ], "summary": "Request Payment", "description": "Request a payment from another user.", "operationId": "request_payment_api_v1_chat_web3_request_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestPayment" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Request Payment Api V1 Chat Web3 Request Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/split": { "post": { "tags": [ "chat-web3" ], "summary": "Split Payment", "description": "Split a payment among multiple recipients in a group chat.", "operationId": "split_payment_api_v1_chat_web3_split_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SplitRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Split Payment Api V1 Chat Web3 Split Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/wallet/connect": { "post": { "tags": [ "chat-web3" ], "summary": "Connect Wallet", "description": "Connect a wallet to chat for payments.", "operationId": "connect_wallet_api_v1_chat_web3_wallet_connect_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectWalletRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Connect Wallet Api V1 Chat Web3 Wallet Connect Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/wallet/disconnect": { "post": { "tags": [ "chat-web3" ], "summary": "Disconnect Wallet", "description": "Disconnect wallet from chat.", "operationId": "disconnect_wallet_api_v1_chat_web3_wallet_disconnect_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Disconnect Wallet Api V1 Chat Web3 Wallet Disconnect Post" } } } } } } }, "/api/v1/chat/web3/wallet": { "get": { "tags": [ "chat-web3" ], "summary": "Wallet Info", "description": "Get connected wallet info for the current user.", "operationId": "wallet_info_api_v1_chat_web3_wallet_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Wallet Info Api V1 Chat Web3 Wallet Get" } } } } } } }, "/api/v1/chat/web3/balance": { "get": { "tags": [ "chat-web3" ], "summary": "Wallet Balance", "description": "Get wallet balance for connected wallet.", "operationId": "wallet_balance_api_v1_chat_web3_balance_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Token" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Wallet Balance Api V1 Chat Web3 Balance Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/balances": { "get": { "tags": [ "chat-web3" ], "summary": "Wallet Balances", "description": "Get all token balances for connected wallet across chains.", "operationId": "wallet_balances_api_v1_chat_web3_balances_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Wallet Balances Api V1 Chat Web3 Balances Get" } } } } } } }, "/api/v1/chat/web3/swap/quote": { "post": { "tags": [ "chat-web3" ], "summary": "Swap Quote", "description": "Get a swap quote (simulated \u2014 real quotes require 0x or Jupiter API).", "operationId": "swap_quote_api_v1_chat_web3_swap_quote_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwapQuoteRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Swap Quote Api V1 Chat Web3 Swap Quote Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/gas-estimate": { "post": { "tags": [ "chat-web3" ], "summary": "Gas Estimate", "description": "Estimate gas for a transfer.", "operationId": "gas_estimate_api_v1_chat_web3_gas_estimate_post", "parameters": [ { "name": "from_addr", "in": "query", "required": true, "schema": { "type": "string", "description": "Sender address", "title": "From Addr" }, "description": "Sender address" }, { "name": "to_addr", "in": "query", "required": true, "schema": { "type": "string", "description": "Recipient address", "title": "To Addr" }, "description": "Recipient address" }, { "name": "amount", "in": "query", "required": true, "schema": { "type": "string", "description": "Amount in wei", "title": "Amount" }, "description": "Amount in wei" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Gas Estimate Api V1 Chat Web3 Gas Estimate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/rooms/{room_id}/token-gate": { "post": { "tags": [ "chat-web3" ], "summary": "Set Token Gate", "description": "Set token gate requirements for a room.", "operationId": "set_token_gate_api_v1_chat_web3_rooms__room_id__token_gate_post", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Room Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenGateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Set Token Gate Api V1 Chat Web3 Rooms Room Id Token Gate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "chat-web3" ], "summary": "Get Token Gate", "description": "Get token gate requirements for a room.", "operationId": "get_token_gate_api_v1_chat_web3_rooms__room_id__token_gate_get", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Room Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Token Gate Api V1 Chat Web3 Rooms Room Id Token Gate Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "chat-web3" ], "summary": "Remove Token Gate", "description": "Remove token gate from a room.", "operationId": "remove_token_gate_api_v1_chat_web3_rooms__room_id__token_gate_delete", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Room Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Remove Token Gate Api V1 Chat Web3 Rooms Room Id Token Gate Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/rooms/{room_id}/verify-gate": { "post": { "tags": [ "chat-web3" ], "summary": "Verify Room Gate", "description": "Verify a wallet meets token gate requirements.", "operationId": "verify_room_gate_api_v1_chat_web3_rooms__room_id__verify_gate_post", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Room Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerifyGateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Verify Room Gate Api V1 Chat Web3 Rooms Room Id Verify Gate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/rooms/{room_id}/nft-gate": { "post": { "tags": [ "chat-web3" ], "summary": "Set Nft Gate", "description": "Set NFT gate requirements for a room.", "operationId": "set_nft_gate_api_v1_chat_web3_rooms__room_id__nft_gate_post", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Room Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NFTGateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Set Nft Gate Api V1 Chat Web3 Rooms Room Id Nft Gate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "chat-web3" ], "summary": "Get Nft Gate", "description": "Get NFT gate requirements for a room.", "operationId": "get_nft_gate_api_v1_chat_web3_rooms__room_id__nft_gate_get", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Room Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Nft Gate Api V1 Chat Web3 Rooms Room Id Nft Gate Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/transactions": { "get": { "tags": [ "chat-web3" ], "summary": "Transaction History", "description": "Get user's transaction history (payments, tips, splits).", "operationId": "transaction_history_api_v1_chat_web3_transactions_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Transaction History Api V1 Chat Web3 Transactions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/web3/parse-command": { "post": { "tags": [ "chat-web3" ], "summary": "Parse Chat Command", "description": "Parse a chat message for Web3 commands (/pay, /tip, /split, /request).\n\nThe frontend can call this to check if a message contains a Web3 command\nbefore sending it as a regular message.", "operationId": "parse_chat_command_api_v1_chat_web3_parse_command_post", "parameters": [ { "name": "content", "in": "query", "required": true, "schema": { "type": "string", "description": "Chat message content", "title": "Content" }, "description": "Chat message content" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Parse Chat Command Api V1 Chat Web3 Parse Command Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/address-profiler/profile/{address}": { "get": { "tags": [ "address-profiler" ], "summary": "Get Address Profile", "description": "Get cross-chain profile for an address. Use ?chains=ethereum,solana to filter.", "operationId": "get_address_profile_api_v1_address_profiler_profile__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chains", "in": "query", "required": false, "schema": { "type": "string", "title": "Chains" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Address Profile Api V1 Address Profiler Profile Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chain-compare/token/{symbol}": { "get": { "tags": [ "chain-comparability" ], "summary": "Compare Token Chains", "description": "Compare a token's listings across all chains. Flags suspicious activity.", "operationId": "compare_token_chains_api_v1_chain_compare_token__symbol__get", "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string", "title": "Symbol" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Compare Token Chains Api V1 Chain Compare Token Symbol Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chain-compare/arbitrage": { "get": { "tags": [ "chain-comparability" ], "summary": "Find Arbitrage Opportunities", "description": "Find tokens with large price discrepancies across chains (arbitrage signals).", "operationId": "find_arbitrage_opportunities_api_v1_chain_compare_arbitrage_get", "parameters": [ { "name": "min_discrepancy", "in": "query", "required": false, "schema": { "type": "number", "minimum": 0.5, "description": "Minimum % price difference", "default": 2.0, "title": "Min Discrepancy" }, "description": "Minimum % price difference" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 25, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Find Arbitrage Opportunities Api V1 Chain Compare Arbitrage Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/honeypot-map/deployer/{deployer_address}": { "get": { "tags": [ "honeypot-map" ], "summary": "Get Honeypot Deployer", "description": "Map all honeypot contracts deployed by a single address.", "operationId": "get_honeypot_deployer_api_v1_honeypot_map_deployer__deployer_address__get", "parameters": [ { "name": "deployer_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Deployer Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Honeypot Deployer Api V1 Honeypot Map Deployer Deployer Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/honeypot-map/network": { "get": { "tags": [ "honeypot-map" ], "summary": "Get Honeypot Network", "description": "Get the current honeypot network map for a chain. Clusters by deployer groups.", "operationId": "get_honeypot_network_api_v1_honeypot_map_network_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "default": 50, "title": "Limit" } }, { "name": "min_risk", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "default": 50, "title": "Min Risk" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Honeypot Network Api V1 Honeypot Map Network Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/honeypot-map/stats": { "get": { "tags": [ "honeypot-map" ], "summary": "Get Honeypot Stats", "description": "Global honeypot statistics.", "operationId": "get_honeypot_stats_api_v1_honeypot_map_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Honeypot Stats Api V1 Honeypot Map Stats Get" } } } } } } }, "/api/v1/labels/lookup": { "post": { "tags": [ "wallet-labels" ], "summary": "Lookup Labels", "description": "Batch lookup wallet labels for enrichment.\n\nCalled by CF Workers to annotate tool responses with wallet intelligence.\nReturns labels from Redis cache + ClickHouse, with 5min Redis caching.", "operationId": "lookup_labels_api_v1_labels_lookup_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LabelLookupRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Lookup Labels Api V1 Labels Lookup Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/whale-alerts/subscribe": { "post": { "tags": [ "whale-alerts" ], "summary": "Subscribe", "description": "Subscribe to whale alerts for an address.", "operationId": "subscribe_api_v1_whale_alerts_subscribe_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WhaleAlert" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Subscribe Api V1 Whale Alerts Subscribe Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/whale-alerts/subscribe/{alert_id}": { "delete": { "tags": [ "whale-alerts" ], "summary": "Unsubscribe", "description": "Remove a whale alert subscription.", "operationId": "unsubscribe_api_v1_whale_alerts_subscribe__alert_id__delete", "parameters": [ { "name": "alert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Alert Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Unsubscribe Api V1 Whale Alerts Subscribe Alert Id Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/whale-alerts/subscriptions/{user_id}": { "get": { "tags": [ "whale-alerts" ], "summary": "List Subscriptions", "description": "List all whale alert subscriptions for a user.", "operationId": "list_subscriptions_api_v1_whale_alerts_subscriptions__user_id__get", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "anyOf": [ {}, { "type": "null" } ] }, "title": "Response List Subscriptions Api V1 Whale Alerts Subscriptions User Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/whale-alerts/check/{address}": { "get": { "tags": [ "whale-alerts" ], "summary": "Check Transfer", "description": "Check recent large transfers for an address (on-demand scan).", "operationId": "check_transfer_api_v1_whale_alerts_check__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "min_usd", "in": "query", "required": false, "schema": { "type": "number", "default": 50000, "title": "Min Usd" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Check Transfer Api V1 Whale Alerts Check Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/whale-alerts/scan": { "post": { "tags": [ "whale-alerts" ], "summary": "Scan Whale Activity", "description": "Trigger a scan of all subscribed addresses. Cron-friendly.", "operationId": "scan_whale_activity_api_v1_whale_alerts_scan_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Scan Whale Activity Api V1 Whale Alerts Scan Post" } } } } } } }, "/api/v1/lp-health/check/{lp_address}": { "get": { "tags": [ "lp-health-monitor" ], "summary": "Check Lp Health", "description": "Check health of a specific liquidity pool.", "operationId": "check_lp_health_api_v1_lp_health_check__lp_address__get", "parameters": [ { "name": "lp_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Lp Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": true }, { "type": "object", "additionalProperties": { "type": "string" } } ], "title": "Response Check Lp Health Api V1 Lp Health Check Lp Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/lp-health/track": { "post": { "tags": [ "lp-health-monitor" ], "summary": "Track Lp", "description": "Start tracking an LP for health changes.", "operationId": "track_lp_api_v1_lp_health_track_post", "parameters": [ { "name": "lp_address", "in": "query", "required": true, "schema": { "type": "string", "title": "Lp Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "notify_tg", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Notify Tg" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Track Lp Api V1 Lp Health Track Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/lp-health/track/{lp_id}": { "delete": { "tags": [ "lp-health-monitor" ], "summary": "Untrack Lp", "description": "Stop tracking an LP.", "operationId": "untrack_lp_api_v1_lp_health_track__lp_id__delete", "parameters": [ { "name": "lp_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Lp Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Untrack Lp Api V1 Lp Health Track Lp Id Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/lp-health/tracked": { "get": { "tags": [ "lp-health-monitor" ], "summary": "List Tracked LPs", "description": "List all liquidity pools currently being monitored for health changes.", "operationId": "list_tracked_api_v1_lp_health_tracked_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Tracked Api V1 Lp Health Tracked Get" } } } } } } }, "/api/v1/lp-health/unhealthy": { "get": { "tags": [ "lp-health-monitor" ], "summary": "Find Unhealthy Pools", "description": "Scan for unhealthy pools: low locked LP, LP drain, single-holder dominance.", "operationId": "find_unhealthy_pools_api_v1_lp_health_unhealthy_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 20, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Find Unhealthy Pools Api V1 Lp Health Unhealthy Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/ai/stream": { "post": { "tags": [ "ai-streaming" ], "summary": "Stream Ai", "description": "Stream AI response with RAG context, tool results, and web search.", "operationId": "stream_ai_api_v1_ai_stream_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__ai_stream__StreamRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Stream Ai Api V1 Ai Stream Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/ai/route": { "post": { "tags": [ "ai-streaming" ], "summary": "Ai Route", "description": "Non-streaming RAG-augmented chat. Returns complete response with sources.", "operationId": "ai_route_api_v1_ai_route_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__ai_stream__StreamRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Ai Route Api V1 Ai Route Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/ai/providers": { "get": { "tags": [ "ai-streaming" ], "summary": "List Providers", "description": "List available AI providers with capabilities.", "operationId": "list_providers_api_v1_ai_providers_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Providers Api V1 Ai Providers Get" } } } } } } }, "/api/v1/rugcharts/trending": { "get": { "tags": [ "rugcharts" ], "summary": "Rugcharts Trending", "description": "Get trending tokens sorted by volume for RugCharts.\n\nData sources: DexScreener (boosted tokens + latest profiles).\nFused with DataFusion engine for multi-source confidence.", "operationId": "rugcharts_trending_api_v1_rugcharts_trending_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain to query", "default": "solana", "title": "Chain" }, "description": "Blockchain to query" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Max tokens to return", "default": 30, "title": "Limit" }, "description": "Max tokens to return" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Rugcharts Trending Api V1 Rugcharts Trending Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugcharts/ohlcv/{chain}/{pair_address}": { "get": { "tags": [ "rugcharts" ], "summary": "Rugcharts Ohlcv", "description": "Get OHLCV candle data for a specific pair.\n\nTries the chain-indexer ClickHouse materialized view first (freshest\non-chain data, own-data), falls back to GeckoTerminal when unavailable\nor for sub-hourly timeframes. The response's ``source`` field reports\nwhich backend actually served the candles.", "operationId": "rugcharts_ohlcv_api_v1_rugcharts_ohlcv__chain___pair_address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "pair_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Pair Address" } }, { "name": "timeframe", "in": "query", "required": false, "schema": { "type": "string", "description": "Candle timeframe", "default": "1h", "title": "Timeframe" }, "description": "Candle timeframe" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of candles", "default": 100, "title": "Limit" }, "description": "Number of candles" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Rugcharts Ohlcv Api V1 Rugcharts Ohlcv Chain Pair Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugcharts/intel/{chain}/{pair_address}": { "get": { "tags": [ "rugcharts" ], "summary": "Rugcharts Intel", "description": "Get comprehensive intelligence on a token pair.\n\nFuses GeckoTerminal OHLCV, DexScreener pair info, volume authenticity,\nshared-module TA and predictive heuristics through the DataFusion engine\ninto a consolidated intelligence brief with confidence scoring.", "operationId": "rugcharts_intel_api_v1_rugcharts_intel__chain___pair_address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "pair_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Pair Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Rugcharts Intel Api V1 Rugcharts Intel Chain Pair Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugcharts/whales/{chain}/{token_address}": { "get": { "tags": [ "rugcharts" ], "summary": "Rugcharts Whales", "description": "Whale trade markers + wallet-behavior labels for a token.\n\nQueries ``wallet_memory.dex_events`` for whale-flagged swaps where the\ntoken appears on either side of the pair. Each marker carries unix time,\nprice, USD notional, tx hash, buy/sell side (V2 semantics; V3 =\n\"unknown\") AND a heuristic ``wallet_label`` (whale/bot/sniper/bundle/\nswap) computed by ``classifier.py`` from measurable trade-sequence\nproperties \u2014 the labels the frontend trade-tape filters on.", "operationId": "rugcharts_whales_api_v1_rugcharts_whales__chain___token_address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "token_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Token Address" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "description": "Max whale trades to return", "default": 100, "title": "Limit" }, "description": "Max whale trades to return" }, { "name": "min_usd", "in": "query", "required": false, "schema": { "type": "number", "minimum": 0.0, "description": "Optional minimum USD notional filter (0 = any whale-flagged event)", "default": 0.0, "title": "Min Usd" }, "description": "Optional minimum USD notional filter (0 = any whale-flagged event)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Rugcharts Whales Api V1 Rugcharts Whales Chain Token Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugcharts/health": { "get": { "tags": [ "rugcharts" ], "summary": "Rugcharts Health", "description": "Health/capability probe for RugCharts.", "operationId": "rugcharts_health_api_v1_rugcharts_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Rugcharts Health Api V1 Rugcharts Health Get" } } } } } } }, "/api/v1/rugcharts/analyze/{address}": { "get": { "tags": [ "rugcharts" ], "summary": "Rugcharts Analyze", "description": "Token analysis snapshot for the RugCharts compare/multi-chain UI.\n\nReal data from GeckoTerminal pair info + rug/volume scoring helpers +\nREAL holder concentration via Helius (Solana). Metrics we cannot source\nare ``null`` \u2014 never placeholder zeros presented as facts.", "operationId": "rugcharts_analyze_api_v1_rugcharts_analyze__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain to query", "default": "solana", "title": "Chain" }, "description": "Blockchain to query" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Rugcharts Analyze Api V1 Rugcharts Analyze Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugcharts/ta/{address}": { "get": { "tags": [ "rugcharts" ], "summary": "Rugcharts Ta", "description": "Technical-analysis snapshot derived from real GeckoTerminal OHLCV.\n\nUses the shared TA module so /ta, /intel and AI chart analysis can\nnever drift apart. Returns available=False when no candles resolve.", "operationId": "rugcharts_ta_api_v1_rugcharts_ta__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain to query", "default": "solana", "title": "Chain" }, "description": "Blockchain to query" }, { "name": "timeframe", "in": "query", "required": false, "schema": { "type": "string", "description": "Candle timeframe", "default": "1h", "title": "Timeframe" }, "description": "Candle timeframe" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Rugcharts Ta Api V1 Rugcharts Ta Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugcharts/signals/{address}": { "get": { "tags": [ "rugcharts" ], "summary": "Rugcharts Signals", "description": "Trading signals for a token, built from labeled whale-trade data.\n\nEach signal derives from a real ClickHouse dex event and carries the\nclassifier's wallet_label. When no trades resolve we return an empty\nlist \u2014 the frontend renders empty gracefully.", "operationId": "rugcharts_signals_api_v1_rugcharts_signals__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain to query", "default": "solana", "title": "Chain" }, "description": "Blockchain to query" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Max signals to return", "default": 20, "title": "Limit" }, "description": "Max signals to return" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Rugcharts Signals Api V1 Rugcharts Signals Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugcharts/volume-analysis/{chain}/{token_address}": { "get": { "tags": [ "rugcharts" ], "summary": "Rugcharts Volume Analysis", "description": "Aggregate bot/wash-volume analysis \u2014 the metric DexScreener lacks.\n\nClassifies the token's most recent dex trades (own indexer data) and\nreports what share of traded volume is machine-generated vs organic.\nDefinitions are explicit in the response (`method` field); confidence\nscales with sample size and thin samples return null percentages\nrather than guesses.", "operationId": "rugcharts_volume_analysis_api_v1_rugcharts_volume_analysis__chain___token_address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "token_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Token Address" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 10, "description": "Recent trades to analyze", "default": 200, "title": "Limit" }, "description": "Recent trades to analyze" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Rugcharts Volume Analysis Api V1 Rugcharts Volume Analysis Chain Token Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/ws/trades/stats": { "get": { "tags": [ "rugcharts-ws" ], "summary": "Ws Trades Stats", "description": "Ops visibility into live tape usage.", "operationId": "ws_trades_stats_ws_trades_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Ws Trades Stats Ws Trades Stats Get" } } } } } } }, "/api/v1/rugmaps/map": { "post": { "tags": [ "rugmaps" ], "summary": "Generate Rug Map", "description": "Generate interactive RugMap for a wallet (2-hop default).", "operationId": "generate_rug_map_api_v1_rugmaps_map_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RugMapsRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Generate Rug Map Api V1 Rugmaps Map Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugmaps/analyze/{address}": { "get": { "tags": [ "rugmaps" ], "summary": "Analyze Wallet", "description": "Quick wallet analysis with RugMaps data.", "operationId": "analyze_wallet_api_v1_rugmaps_analyze__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "depth", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 5, "minimum": 1, "default": 2, "title": "Depth" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Analyze Wallet Api V1 Rugmaps Analyze Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugmaps/entity/{address}": { "get": { "tags": [ "rugmaps" ], "summary": "Get Entity Info", "description": "Get entity information for an address.", "operationId": "get_entity_info_api_v1_rugmaps_entity__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Entity Info Api V1 Rugmaps Entity Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugmaps/health": { "get": { "tags": [ "rugmaps" ], "summary": "Rugmaps Health", "description": "Health check for the RugMaps visualization engine.", "operationId": "rugmaps_health_api_v1_rugmaps_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Rugmaps Health Api V1 Rugmaps Health Get" } } } } } } }, "/api/v1/rugmaps/wallet-labels": { "get": { "tags": [ "rugmaps" ], "summary": "Rugmaps Wallet Labels", "description": "Batch wallet labels for the RugMaps canvas.\n\nResolves each address against OUR own data \u2014 wallet_v2 Qdrant collection,\nClickHouse ``wallet_memory.wallet_labels``, and the DataBus wallet\nscanner \u2014 and returns a per-address label record with a node ``class``\n(CEX / DEX / mixer / bridge / whale / bot / sniper / dev / normal) that\nthe frontend colors by.", "operationId": "rugmaps_wallet_labels_api_v1_rugmaps_wallet_labels_get", "parameters": [ { "name": "addresses", "in": "query", "required": true, "schema": { "type": "string", "description": "Comma-separated wallet addresses (max 200)", "title": "Addresses" }, "description": "Comma-separated wallet addresses (max 200)" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Rugmaps Wallet Labels Api V1 Rugmaps Wallet Labels Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugmaps/fund-flows": { "get": { "tags": [ "rugmaps" ], "summary": "Rugmaps Fund Flows", "description": "Fund-flow arrows for a clicked wallet node.\n\nReturns inbound (funds received by the wallet) and outbound (funds sent)\ntransfers from our ClickHouse wallet_flow engine, plus a cross-chain\nprofile from the cross-chain aggregator.", "operationId": "rugmaps_fund_flows_api_v1_rugmaps_fund_flows_get", "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string", "description": "Token address the map is centered on", "title": "Token" }, "description": "Token address the map is centered on" }, { "name": "address", "in": "query", "required": true, "schema": { "type": "string", "description": "Wallet address to trace", "title": "Address" }, "description": "Wallet address to trace" }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "hops", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 2, "minimum": 1, "default": 1, "title": "Hops" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Rugmaps Fund Flows Api V1 Rugmaps Fund Flows Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugmaps/token-graph": { "get": { "tags": [ "rugmaps" ], "summary": "Token Holder Graph", "description": "Generate a token holder graph with AI analysis and RAG caching.\nUses the remote long (deep-reasoning) tier first, DeepSeek fallback, +\nour FAISS indexes + wallet labels + semantic cache.\nFalls back to DexScreener pair data when on-chain holder graph is empty.", "operationId": "token_holder_graph_api_v1_rugmaps_token_graph_get", "parameters": [ { "name": "token_address", "in": "query", "required": true, "schema": { "type": "string", "title": "Token Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 5, "default": 50, "title": "Limit" } }, { "name": "skip_cache", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Skip Cache" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ {}, { "type": "object", "additionalProperties": true } ], "title": "Response Token Holder Graph Api V1 Rugmaps Token Graph Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugmaps/auto-label": { "post": { "tags": [ "rugmaps" ], "summary": "Auto Label Wallet", "description": "Submit wallet observations for automatic labeling.", "operationId": "auto_label_wallet_api_v1_rugmaps_auto_label_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Request" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Auto Label Wallet Api V1 Rugmaps Auto Label Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugmaps/auto-label/stats": { "get": { "tags": [ "rugmaps" ], "summary": "Auto Label Stats", "description": "Get auto-labeler statistics.\n\nValues are intentionally heterogeneous (ints, dicts, None) \u2014 the\nannotation is ``dict[str, Any]`` so FastAPI does not coerce/validate\nthem as strings (previously caused ResponseValidationError 500).", "operationId": "auto_label_stats_api_v1_rugmaps_auto_label_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Auto Label Stats Api V1 Rugmaps Auto Label Stats Get" } } } } } } }, "/api/v1/rugmaps/cluster-analysis": { "post": { "tags": [ "rugmaps" ], "summary": "Ai Holder Cluster Analysis", "description": "AI-powered wallet cluster analysis for suspicious patterns.\n\nUses the remote long (deep-reasoning) tier first, then a DeepSeek fallback\nto identify bundled launches, sniper coordination, wash trading rings,\ninsider clusters, and dev-linked wallets.", "operationId": "ai_holder_cluster_analysis_api_v1_rugmaps_cluster_analysis_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HolderClusterRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Ai Holder Cluster Analysis Api V1 Rugmaps Cluster Analysis Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugmaps/anomaly-detection": { "post": { "tags": [ "rugmaps" ], "summary": "Ai Contract Anomaly Detection", "description": "AI-powered contract anomaly detection for rug pull indicators.\n\nUses the remote long (deep-reasoning) tier first, then a DeepSeek fallback\nto review token holder distribution, contract behavior, and on-chain\npatterns for honeypots, rug pulls, and manipulation indicators.", "operationId": "ai_contract_anomaly_detection_api_v1_rugmaps_anomaly_detection_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContractAnomalyRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Ai Contract Anomaly Detection Api V1 Rugmaps Anomaly Detection Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rugmaps/ai-health": { "get": { "tags": [ "rugmaps" ], "summary": "Ai Health Check", "description": "Check RugMaps AI analysis availability (remote-tier routing).", "operationId": "ai_health_check_api_v1_rugmaps_ai_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Ai Health Check Api V1 Rugmaps Ai Health Get" } } } } } } }, "/api/v1/token/{chain}/{address}": { "get": { "tags": [ "token" ], "summary": "Token Page", "description": "Unified token page that combines all token intelligence into one endpoint.\n\nReturns:\n- dex_data: Real-time pair data from DexScreener (price, volume, liquidity, txns)\n- bbs_posts: Recent community discussions about this token (tagged by address)\n- links: Deep links to RugCharts, RugMaps, Scanner for this token", "operationId": "token_page_api_v1_token__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "include_discussions", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Include Discussions" } }, { "name": "discussion_limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 10, "title": "Discussion Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Token Page Api V1 Token Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/mev-advisory/check/{address}": { "get": { "tags": [ "mev-advisory" ], "summary": "Check Mev Risk", "description": "Check MEV risk before trading a token. Returns sandwich attack risk and protection recommendation.", "operationId": "check_mev_risk_api_v1_mev_advisory_check__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Check Mev Risk Api V1 Mev Advisory Check Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/mev-advisory/safe-swap": { "get": { "tags": [ "mev-advisory" ], "summary": "Safe Swap Params", "description": "Get optimal swap parameters to avoid MEV.", "operationId": "safe_swap_params_api_v1_mev_advisory_safe_swap_get", "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "amount_usd", "in": "query", "required": false, "schema": { "type": "number", "minimum": 1, "default": 100, "title": "Amount Usd" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Safe Swap Params Api V1 Mev Advisory Safe Swap Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/impersonation/audit/{address}": { "get": { "tags": [ "impersonation-detector" ], "summary": "Audit Address", "description": "Full impersonation audit for an address.", "operationId": "audit_address_api_v1_impersonation_audit__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Audit Address Api V1 Impersonation Audit Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/community-forensics/reports": { "get": { "tags": [ "community-forensics" ], "summary": "List Community Reports", "description": "List community-submitted forensic reports (newest first).", "operationId": "list_reports_api_v1_community_forensics_reports_get", "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Category" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response List Reports Api V1 Community Forensics Reports Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "community-forensics" ], "summary": "Submit Community Report", "description": "Submit a new community forensics report.", "operationId": "submit_report_api_v1_community_forensics_reports_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReportSubmit" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Submit Report Api V1 Community Forensics Reports Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/community-forensics/reports/{report_id}": { "get": { "tags": [ "community-forensics" ], "summary": "Get Report Detail", "description": "Get full details of a community forensics report.", "operationId": "get_report_api_v1_community_forensics_reports__report_id__get", "parameters": [ { "name": "report_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Report Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Report Api V1 Community Forensics Reports Report Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/community-forensics/verify-graph": { "post": { "tags": [ "community-forensics" ], "summary": "Verify Report Graph", "description": "Verify and enrich a report's graph data with Blockscout lookups.", "operationId": "verify_graph_api_v1_community_forensics_verify_graph_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GraphVerifyRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Verify Graph Api V1 Community Forensics Verify Graph Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/community-forensics/correlate": { "post": { "tags": [ "community-forensics" ], "summary": "Cross-Chain Correlation", "description": "Batch cross-chain correlation for community investigation addresses.", "operationId": "correlate_addresses_api_v1_community_forensics_correlate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CorrelationRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Correlate Addresses Api V1 Community Forensics Correlate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/community-forensics/leaderboard": { "get": { "tags": [ "community-forensics" ], "summary": "Community Leaderboard", "description": "Get community forensics leaderboard (top sleuths by contributions).", "operationId": "get_leaderboard_api_v1_community_forensics_leaderboard_get", "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^(daily|weekly|monthly|all)$", "default": "weekly", "title": "Period" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Leaderboard Api V1 Community Forensics Leaderboard Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/community-forensics/health": { "get": { "tags": [ "community-forensics" ], "summary": "Forensics Service Health", "description": "Check if Blockscout and Redis are available.", "operationId": "health_check_api_v1_community_forensics_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Health Check Api V1 Community Forensics Health Get" } } } } } } }, "/api/v1/kol/health": { "get": { "tags": [ "social-intel" ], "summary": "KOL Intel Health", "description": "Counts of the bundled KOL data files (never raises).", "operationId": "health_check_api_v1_kol_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__kol_intel__HealthResponse" } } } } } } }, "/api/v1/kol/scammers": { "get": { "tags": [ "social-intel" ], "summary": "List Known Scammers", "description": "List known scammers from ``known_scammers.json``, optionally filtered.", "operationId": "list_scammers_api_v1_kol_scammers_get", "parameters": [ { "name": "severity", "in": "query", "required": false, "schema": { "type": "string", "description": "Filter by severity (e.g. high|medium|low)", "default": "", "title": "Severity" }, "description": "Filter by severity (e.g. high|medium|low)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response List Scammers Api V1 Kol Scammers Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/kol/kol/{handle}": { "get": { "tags": [ "social-intel" ], "summary": "KOL Profile (score + rug history + wallets)", "description": "Compose trust score, documented rug history and attributed wallets.", "operationId": "kol_profile_api_v1_kol_kol__handle__get", "parameters": [ { "name": "handle", "in": "path", "required": true, "schema": { "type": "string", "title": "Handle" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/kol/leaderboard": { "get": { "tags": [ "social-intel" ], "summary": "KOL Trust-Score Leaderboard", "description": "Rank tracked KOLs by trust score (descending).", "operationId": "leaderboard_api_v1_kol_leaderboard_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Leaderboard Api V1 Kol Leaderboard Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/kol/wallets/{handle}": { "get": { "tags": [ "social-intel" ], "summary": "Attributed Wallets for a KOL", "description": "Attributed wallets for a handle (200 with empty list when unknown).", "operationId": "wallets_api_v1_kol_wallets__handle__get", "parameters": [ { "name": "handle", "in": "path", "required": true, "schema": { "type": "string", "title": "Handle" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Wallets Api V1 Kol Wallets Handle Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/kol/cross-chain/{handle}": { "get": { "tags": [ "social-intel" ], "summary": "Cross-Chain Wallet Links for a KOL", "description": "Cross-chain wallet links for a handle (200 with empty list when none).", "operationId": "cross_chain_api_v1_kol_cross_chain__handle__get", "parameters": [ { "name": "handle", "in": "path", "required": true, "schema": { "type": "string", "title": "Handle" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Cross Chain Api V1 Kol Cross Chain Handle Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/kol/shill-signals": { "get": { "tags": [ "social-intel" ], "summary": "Detected Shill Signals", "description": "Run the shill detector over the (currently empty) live signal set.\n\nThe read-only router has no post/tx ingestion source yet, so this\nreturns a safe zero-result summary until the pipeline seeds the\ndetector inputs. Never raises.", "operationId": "shill_signals_api_v1_kol_shill_signals_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Shill Signals Api V1 Kol Shill Signals Get" } } } } } } }, "/api/v1/kol/scammer-calls": { "get": { "tags": [ "social-intel" ], "summary": "Captured Scammer-Call Posts", "description": "Return captured scammer-call posts from the append-only call store.\n\nReads ``app/databus/scammer_calls.json`` (JSON Lines, newest first)\nthrough ``CallStore`` and returns the ``{calls, total}`` shape the\nfrontend expects. Empty/corrupt store degrades to\n``{\"calls\": [], \"total\": 0}``. Never raises.", "operationId": "scammer_calls_api_v1_kol_scammer_calls_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "severity", "in": "query", "required": false, "schema": { "type": "string", "description": "Filter by severity (e.g. critical|high|medium|low)", "default": "", "title": "Severity" }, "description": "Filter by severity (e.g. critical|high|medium|low)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Scammer Calls Api V1 Kol Scammer Calls Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/kol/profiles": { "get": { "tags": [ "social-intel" ], "summary": "Enriched KOL Profiles (avatar/category/rating/calls)", "description": "List enriched KOL profiles, ranked: rated first (score desc), then\nunrated by follower count desc. Each entry carries avatar, category,\napproximate followers, wallet count, calls count and the computed\nrug-risk-weighted rating (null when insufficient data). Never raises.", "operationId": "kol_profiles_api_v1_kol_profiles_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "description": "Filter by category (trader|alpha|influencer|analyst)", "default": "", "title": "Category" }, "description": "Filter by category (trader|alpha|influencer|analyst)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Kol Profiles Api V1 Kol Profiles Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/kol/profiles/{handle}": { "get": { "tags": [ "social-intel" ], "summary": "Full Enriched KOL Profile (calls + performance + wallets)", "description": "Full enriched profile for a handle: metadata, historical calls,\ncomputed performance, risk associations and attributed wallets.\nUnknown handles return 404; missing profile data degrades to a minimal\nwallet-derived profile (200) when the handle is in the wallet list.", "operationId": "kol_profile_detail_api_v1_kol_profiles__handle__get", "parameters": [ { "name": "handle", "in": "path", "required": true, "schema": { "type": "string", "title": "Handle" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rug-recovery/trace/{token_address}": { "get": { "tags": [ "rug-recovery" ], "summary": "Trace Rug", "description": "Trace stolen funds from a rugged token.", "operationId": "trace_rug_api_v1_rug_recovery_trace__token_address__get", "parameters": [ { "name": "token_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Token Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "max_hops", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 5, "default": 3, "title": "Max Hops" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": true }, { "type": "object", "additionalProperties": { "type": "string" } } ], "title": "Response Trace Rug Api V1 Rug Recovery Trace Token Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rug-recovery/victims/{token_address}": { "get": { "tags": [ "rug-recovery" ], "summary": "Get Affected Victims", "description": "Get list of addresses that interacted with (lost money to) a rug token.", "operationId": "get_affected_victims_api_v1_rug_recovery_victims__token_address__get", "parameters": [ { "name": "token_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Token Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Affected Victims Api V1 Rug Recovery Victims Token Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/laundry-matcher/match/{address}": { "get": { "tags": [ "laundry-matcher" ], "summary": "Find Matches", "description": "Find tokens similar to the given address. Returns top-N copycat matches.", "operationId": "find_matches_api_v1_laundry_matcher_match__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "min_similarity", "in": "query", "required": false, "schema": { "type": "number", "maximum": 1, "minimum": 0, "default": 0.3, "title": "Min Similarity" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 25, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Find Matches Api V1 Laundry Matcher Match Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/laundry-matcher/scan-similar/{address}": { "get": { "tags": [ "laundry-matcher" ], "summary": "Scan And Match", "description": "Scan the address AND find its matches in a single call.", "operationId": "scan_and_match_api_v1_laundry_matcher_scan_similar__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Scan And Match Api V1 Laundry Matcher Scan Similar Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/death-clock/predict/{chain}/{address}": { "get": { "tags": [ "death-clock" ], "summary": "Predict Death Clock", "description": "Predict days until rug/death for a token. Free: basic, Paid (x402): full model.", "operationId": "predict_death_clock_api_v1_death_clock_predict__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "x_x402_sig", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X X402 Sig" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Predict Death Clock Api V1 Death Clock Predict Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/token-cv/{chain}/{address}": { "get": { "tags": [ "token-cv" ], "summary": "Get Token Cv", "description": "Generate a complete on-chain CV for a token.", "operationId": "get_token_cv_api_v1_token_cv__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Token Cv Api V1 Token Cv Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/token-cv/compare": { "get": { "tags": [ "token-cv" ], "summary": "Compare Tokens", "description": "Compare two tokens side by side.", "operationId": "compare_tokens_api_v1_token_cv_compare_get", "parameters": [ { "name": "token_a", "in": "query", "required": true, "schema": { "type": "string", "title": "Token A" } }, { "name": "chain_a", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain A" } }, { "name": "token_b", "in": "query", "required": true, "schema": { "type": "string", "title": "Token B" } }, { "name": "chain_b", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain B" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": true } }, { "type": "object", "additionalProperties": { "type": "string" } }, {} ], "title": "Response Compare Tokens Api V1 Token Cv Compare Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/tvl-verify/protocol/{slug}": { "get": { "tags": [ "tvl-verifier" ], "summary": "Verify Protocol Tvl", "description": "Verify a DeFiLlama protocol's TVL against on-chain data.", "operationId": "verify_protocol_tvl_api_v1_tvl_verify_protocol__slug__get", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "title": "Slug" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "anyOf": [ {}, { "type": "null" } ] }, "title": "Response Verify Protocol Tvl Api V1 Tvl Verify Protocol Slug Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/tvl-verify/top-mismatches": { "get": { "tags": [ "tvl-verifier" ], "summary": "Find Top Mismatches", "description": "Scan top DeFiLlama protocols for TVL mismatches.", "operationId": "find_top_mismatches_api_v1_tvl_verify_top_mismatches_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 20, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Find Top Mismatches Api V1 Tvl Verify Top Mismatches Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/contract-analyzer/analyze/{address}": { "get": { "tags": [ "contract-analyzer" ], "summary": "Analyze Contract", "description": "Analyze a smart contract's functions and risk profile.", "operationId": "analyze_contract_api_v1_contract_analyzer_analyze__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Analyze Contract Api V1 Contract Analyzer Analyze Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/contract-analyzer/detect-mint/{address}": { "get": { "tags": [ "contract-analyzer" ], "summary": "Detect Mint Function", "description": "Quick check: does this contract have a mint function?", "operationId": "detect_mint_function_api_v1_contract_analyzer_detect_mint__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Detect Mint Function Api V1 Contract Analyzer Detect Mint Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/criminal-clusters/deployer/{deployer_address}": { "get": { "tags": [ "criminal-clusters" ], "summary": "Get Deployer Cluster", "description": "Get all tokens deployed by this address. Shows full rug adjacency.", "operationId": "get_deployer_cluster_api_v1_criminal_clusters_deployer__deployer_address__get", "parameters": [ { "name": "deployer_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Deployer Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Deployer Cluster Api V1 Criminal Clusters Deployer Deployer Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/criminal-clusters/token/{token_address}": { "get": { "tags": [ "criminal-clusters" ], "summary": "Get Token Cluster", "description": "Get all related tokens for a given token - same deployer, same funder, code clones.", "operationId": "get_token_cluster_api_v1_criminal_clusters_token__token_address__get", "parameters": [ { "name": "token_address", "in": "path", "required": true, "schema": { "type": "string", "title": "Token Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Token Cluster Api V1 Criminal Clusters Token Token Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/criminal-clusters/search": { "get": { "tags": [ "criminal-clusters" ], "summary": "Search Clusters", "description": "Search for deployers/tokens in the cluster database.", "operationId": "search_clusters_api_v1_criminal_clusters_search_get", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "minLength": 2, "title": "Q" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Search Clusters Api V1 Criminal Clusters Search Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rag/metrics": { "get": { "tags": [ "rag-metrics" ], "summary": "Rag Metrics", "description": "RAG system metrics - latency, cache, ingestion, errors.", "operationId": "rag_metrics_api_v1_rag_metrics_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Rag Metrics Api V1 Rag Metrics Get" } } } } } } }, "/api/v1/news/feed": { "get": { "tags": [ "news" ], "summary": "Get News Feed", "description": "Full aggregated news feed from all sources.", "operationId": "get_news_feed_api_v1_news_feed_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "sentiment", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sentiment" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" } }, { "name": "tier", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tier" } }, { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" } }, { "name": "include_rss", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Include Rss" } }, { "name": "include_reddit", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Include Reddit" } }, { "name": "include_internal", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Include Internal" } }, { "name": "refresh", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Force refresh, bypass cache", "default": false, "title": "Refresh" }, "description": "Force refresh, bypass cache" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsFeedResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/articles": { "get": { "tags": [ "news" ], "summary": "Get News Articles", "description": "Get rated news articles with Ground News-style filters.\n\nQueries Qdrant ``news_v2`` with metadata filters (category, source,\ntoken), computes an ``ArticleRating`` card per article on the fly,\nthen applies the rating-based filters and sorts.", "operationId": "get_news_articles_api_v1_news_articles_get", "parameters": [ { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "default": 20, "title": "Limit" } }, { "name": "category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" } }, { "name": "sentiment", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sentiment" } }, { "name": "factuality", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Factuality" } }, { "name": "market_impact", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Market Impact" } }, { "name": "token", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Token" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^(published_at|market_impact|sentiment)$", "default": "published_at", "title": "Sort" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/articles/{article_id}": { "get": { "tags": [ "news" ], "summary": "Get Article", "description": "Get a single article with its full Ground News rating card.", "operationId": "get_article_api_v1_news_articles__article_id__get", "parameters": [ { "name": "article_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Article Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsArticle" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/sources": { "get": { "tags": [ "news" ], "summary": "Get News Sources", "description": "List all news sources with reputation tiers (Qdrant news_v2).", "operationId": "get_news_sources_api_v1_news_sources_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get News Sources Api V1 News Sources Get" } } } } } } }, "/api/v1/news/sentiment": { "get": { "tags": [ "news" ], "summary": "Get Sentiment", "description": "Real-time sentiment overview from current news feed.\n\nReturns the feed sentiment summary plus a Ground News-style\nsentiment_breakdown computed from Qdrant news_v2 ratings.", "operationId": "get_sentiment_api_v1_news_sentiment_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Sentiment Api V1 News Sentiment Get" } } } } } } }, "/api/v1/news/headlines": { "get": { "tags": [ "news" ], "summary": "Get Headlines", "description": "Top headlines only - fast, lightweight.\n\nReads from Redis cache first (populated by background task every 5 min),\nfalls back to in-memory cache, then triggers background refresh.", "operationId": "get_headlines_api_v1_news_headlines_get", "parameters": [ { "name": "count", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 10, "title": "Count" } }, { "name": "category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Headlines Api V1 News Headlines Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/categories": { "get": { "tags": [ "news" ], "summary": "Get Categories", "description": "Get all news categories with counts.", "operationId": "get_categories_api_v1_news_categories_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "type": "object", "title": "Response Get Categories Api V1 News Categories Get" } } } } } } }, "/api/v1/news/stats": { "get": { "tags": [ "news" ], "summary": "Get Stats", "description": "Aggregate statistics about the news pipeline.", "operationId": "get_stats_api_v1_news_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Stats Api V1 News Stats Get" } } } } } } }, "/api/v1/news/comment": { "post": { "tags": [ "news" ], "summary": "Post Comment", "description": "Post a comment on any news article. Requires public profile.", "operationId": "post_comment_api_v1_news_comment_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommentRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommentResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/comments/{article_id}": { "get": { "tags": [ "news" ], "summary": "Get Comments", "description": "Get comments for a specific article.", "operationId": "get_comments_api_v1_news_comments__article_id__get", "parameters": [ { "name": "article_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Article Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CommentResponse" }, "title": "Response Get Comments Api V1 News Comments Article Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/internal/scanner-alert": { "post": { "tags": [ "news" ], "summary": "Post Scanner Alert", "description": "Internal endpoint for cron jobs to inject scanner findings into news feed.", "operationId": "post_scanner_alert_api_v1_news_internal_scanner_alert_post", "parameters": [ { "name": "token_name", "in": "query", "required": true, "schema": { "type": "string", "title": "Token Name" } }, { "name": "chain", "in": "query", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "risk_score", "in": "query", "required": true, "schema": { "type": "number", "title": "Risk Score" } }, { "name": "address", "in": "query", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "flags", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Flags" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Post Scanner Alert Api V1 News Internal Scanner Alert Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/overview": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Overview", "description": "Global market overview - total cap, dominance, fear & greed, BTC/ETH prices.", "operationId": "get_market_overview_api_v1_market_overview_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Market Overview Api V1 Market Overview Get" } } } } } } }, "/api/v1/market/movers": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Movers", "description": "Top gainers/losers \u2014 real movers, no stablecoins/flat majors.\n\nSources: CoinGecko /coins/markets (1h/24h/7d windows, 6h falls back to\n24h) + best-effort GMGN fresh-pair supplement (fail-open). Items are\nfiltered by the stablecoin blacklist and a |change| floor so flat\nstablecoins/majors never appear as \"movers\".", "operationId": "get_market_movers_api_v1_market_movers_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 10, "title": "Limit" } }, { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } }, { "name": "timeframe", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^(1h|6h|24h|7d)$", "default": "24h", "title": "Timeframe" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Movers Api V1 Market Movers Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/chains": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Chains", "description": "Chain activity - TPS, gas, active addresses from CoinGecko chain data.", "operationId": "get_market_chains_api_v1_market_chains_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Market Chains Api V1 Market Chains Get" } } } } } } }, "/api/v1/market/fear-greed": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Fear Greed", "description": "Fear & Greed index from alternative.me.", "operationId": "get_fear_greed_api_v1_market_fear_greed_get", "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 365, "minimum": 1, "default": 7, "title": "Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Fear Greed Api V1 Market Fear Greed Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/onchain": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Onchain", "description": "On-chain metrics - exchange flows, stablecoin inflows.", "operationId": "get_market_onchain_api_v1_market_onchain_get", "parameters": [ { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Onchain Api V1 Market Onchain Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/macro": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Macro", "description": "Macro correlation - BTC vs traditional assets.", "operationId": "get_market_macro_api_v1_market_macro_get", "parameters": [ { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Macro Api V1 Market Macro Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/sentiment": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Sentiment", "description": "Social sentiment - aggregated from market data.", "operationId": "get_market_sentiment_api_v1_market_sentiment_get", "parameters": [ { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Sentiment Api V1 Market Sentiment Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/launches": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Launches", "description": "New token launches from DexScreener boosts.", "operationId": "get_market_launches_api_v1_market_launches_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 8, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Launches Api V1 Market Launches Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/trending": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Trending", "description": "Trending tokens \u2014 our own merged list from CoinGecko + DexScreener.\n\nDexScreener token-boosts (top) = what is actually getting attention and\nvolume on DEXes right now (chain + real token address). CoinGecko\n/search/trending = CEX-level social/volume momentum. Both are live,\ncached 60-120s. Items are ranked: DEX boosts first (real traded volume),\nthen CoinGecko coins.", "operationId": "get_market_trending_api_v1_market_trending_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 8, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Trending Api V1 Market Trending Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/whales": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Whales", "description": "Whale movements - large swaps from DexScreener.", "operationId": "get_market_whales_api_v1_market_whales_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 5, "title": "Limit" } }, { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Whales Api V1 Market Whales Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/predictions": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Predictions", "description": "Prediction markets - Polymarket data.", "operationId": "get_market_predictions_api_v1_market_predictions_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 6, "title": "Limit" } }, { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Predictions Api V1 Market Predictions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/insiders": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Insiders", "description": "Insider trading signals - derived from CoinGecko trending + price anomalies.", "operationId": "get_market_insiders_api_v1_market_insiders_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 5, "title": "Limit" } }, { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Insiders Api V1 Market Insiders Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/dex-flows": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Dex Flows", "description": "DEX flow data - buy/sell pressure from top pairs.", "operationId": "get_market_dex_flows_api_v1_market_dex_flows_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Dex Flows Api V1 Market Dex Flows Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/liquidations": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Liquidations", "description": "Liquidation levels - estimated from Binance price data.", "operationId": "get_market_liquidations_api_v1_market_liquidations_get", "parameters": [ { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Liquidations Api V1 Market Liquidations Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/funding": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Funding", "description": "Funding rates from Binance.", "operationId": "get_market_funding_api_v1_market_funding_get", "parameters": [ { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Funding Api V1 Market Funding Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/options": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Options", "description": "Options flow - unusual activity proxy from funding rate extremes.", "operationId": "get_market_options_api_v1_market_options_get", "parameters": [ { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Options Api V1 Market Options Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/airdrops": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Airdrops", "description": "Airdrop opportunities - curated list of confirmed and upcoming drops.", "operationId": "get_market_airdrops_api_v1_market_airdrops_get", "parameters": [ { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Airdrops Api V1 Market Airdrops Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/runners": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Runners", "description": "Potential runners - tokens with early momentum.", "operationId": "get_market_runners_api_v1_market_runners_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Runners Api V1 Market Runners Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/scams": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Scams", "description": "Scam alerts - flagged tokens from DexScreener with suspicious patterns.", "operationId": "get_market_scams_api_v1_market_scams_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 5, "title": "Limit" } }, { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Scams Api V1 Market Scams Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/alerts-feed": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Alerts Feed", "description": "Combined alerts feed - scams from DexScreener, system alerts, bad actors.", "operationId": "get_market_alerts_feed_api_v1_market_alerts_feed_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } }, { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Alerts Feed Api V1 Market Alerts Feed Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/likely-rugs": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Likely Rugs", "description": "Likely rug pulls - premium data from scanner.", "operationId": "get_market_likely_rugs_api_v1_market_likely_rugs_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Likely Rugs Api V1 Market Likely Rugs Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/alpha": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Alpha", "description": "Alpha signals - from trending + whale data.", "operationId": "get_market_alpha_api_v1_market_alpha_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Market Alpha Api V1 Market Alpha Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/smart-money": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Smart Money", "description": "Smart money flows by sector.", "operationId": "get_market_smart_money_api_v1_market_smart_money_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Market Smart Money Api V1 Market Smart Money Get" } } } } } } }, "/api/v1/market/bundlers": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Market Bundlers", "description": "Bundler detection - coordinated buy patterns.", "operationId": "get_market_bundlers_api_v1_market_bundlers_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Market Bundlers Api V1 Market Bundlers Get" } } } } } } }, "/api/v1/market/insider-wallets": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Insider Wallets", "description": "Likely insider trader wallets to watch.\nPremium feature: Tracks wallets with high win rates, early entries before pumps,\nand coordinated buying patterns across chains.", "operationId": "get_insider_wallets_api_v1_market_insider_wallets_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 10, "title": "Limit" } }, { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Insider Wallets Api V1 Market Insider Wallets Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/prediction-signals": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Prediction Signals", "description": "Prediction market intelligence signals.\nDetects probability swings, ecosystem risks, and token-specific threats\nfrom Polymarket, Kalshi, Limitless, and Manifold.", "operationId": "get_prediction_signals_api_v1_market_prediction_signals_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 20, "minimum": 1, "default": 5, "title": "Limit" } }, { "name": "tier", "in": "query", "required": false, "schema": { "type": "string", "default": "free", "title": "Tier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Prediction Signals Api V1 Market Prediction Signals Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/hyperliquid": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Hyperliquid Data", "description": "Hyperliquid perp markets and funding rates.", "operationId": "get_hyperliquid_data_api_v1_market_hyperliquid_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Hyperliquid Data Api V1 Market Hyperliquid Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/hyperliquid-action": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Hyperliquid Action", "description": "Hyperliquid 'Gain/Loss Porn': Biggest 24h movers and funding squeezes.\nShows where the market is ripping, dumping, and who is getting liquidated/squeezed.", "operationId": "get_hyperliquid_action_api_v1_market_hyperliquid_action_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 20, "minimum": 1, "default": 5, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Hyperliquid Action Api V1 Market Hyperliquid Action Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/hyperliquid-liquidations": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Hyperliquid Liquidation Map", "description": "Liquidation pressure heatmap \u2014 REAL data from Hyperliquid metaAndAssetCtxs.\n\nFor every perpetual asset: open interest (USD), mark price, funding rate,\nand a liquidation-pressure estimate derived from OI x typical leverage\nbands. Longs cluster below mark (long liq level \u2248 mark / (1 + 1/lev)),\nshorts above. Pressure score ranks where forced unwinds would concentrate\nfirst. This is the data layer for the website heatmap + bot /liqmap.", "operationId": "get_hyperliquid_liquidation_map_api_v1_market_hyperliquid_liquidations_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 5, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Hyperliquid Liquidation Map Api V1 Market Hyperliquid Liquidations Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/market/liquidations-multi-venue": { "get": { "tags": [ "market-intel", "market-intel" ], "summary": "Get Multi Venue Liquidation Map", "description": "Cross-exchange liquidation pressure map: Hyperliquid + Bybit + Binance + OKX.\n\nPer asset: total OI across venues, per-venue OI share, funding spread,\nand 10x liquidation reference levels computed off the volume-weighted mark.\nRanked by aggregate cascade pressure. All venues fail independently.", "operationId": "get_multi_venue_liquidation_map_api_v1_market_liquidations_multi_venue_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 5, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Multi Venue Liquidation Map Api V1 Market Liquidations Multi Venue Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/prediction-markets/search": { "get": { "tags": [ "prediction-markets" ], "summary": "Search Markets", "description": "Search all prediction market sources for crypto security intelligence.\n\nQueries Polymarket, Kalshi, Limitless, and Manifold in parallel.\nResults show probability, volume, and auto-classified relevance.", "operationId": "search_markets_api_v1_prediction_markets_search_get", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "description": "Search query (token name, event, protocol, etc.)", "title": "Q" }, "description": "Search query (token name, event, protocol, etc.)" }, { "name": "security_only", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Only return security-relevant markets", "default": false, "title": "Security Only" }, "description": "Only return security-relevant markets" }, { "name": "min_volume", "in": "query", "required": false, "schema": { "type": "number", "description": "Minimum USD volume to include", "default": 0.0, "title": "Min Volume" }, "description": "Minimum USD volume to include" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Max results to return", "default": 20, "title": "Limit" }, "description": "Max results to return" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Search Markets Api V1 Prediction Markets Search Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/prediction-markets/trending": { "get": { "tags": [ "prediction-markets" ], "summary": "Trending Markets", "description": "Get top trending prediction markets by volume across all sources.", "operationId": "trending_markets_api_v1_prediction_markets_trending_get", "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter: crypto, security, regulation, all", "title": "Category" }, "description": "Filter: crypto, security, regulation, all" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Max results", "default": 20, "title": "Limit" }, "description": "Max results" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Trending Markets Api V1 Prediction Markets Trending Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/prediction-markets/token/{symbol}": { "get": { "tags": [ "prediction-markets" ], "summary": "Token Markets", "description": "Find all prediction markets mentioning a specific token symbol.\n\nUseful for: gauging market sentiment on specific tokens,\nfinding rug/exploit probability markets for tokens in scanner results.", "operationId": "token_markets_api_v1_prediction_markets_token__symbol__get", "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string", "title": "Symbol" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Max results", "default": 20, "title": "Limit" }, "description": "Max results" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Token Markets Api V1 Prediction Markets Token Symbol Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/prediction-markets/sentinel": { "get": { "tags": [ "prediction-markets" ], "summary": "Sentinel Digest", "description": "Daily intelligence digest of security-relevant prediction markets.\n\nCategorizes markets into:\n- Top threats: High-volume security-relevant markets\n- Token-specific: Markets about specific tokens with security signals\n- Ecosystem risk: Broad crypto risk markets\n- Regulatory: SEC, CFTC, DOJ, sanction-related markets\n\nUsed by: SENTINEL scanner for cross-referencing with on-chain risk scores.", "operationId": "sentinel_digest_api_v1_prediction_markets_sentinel_get", "parameters": [ { "name": "refresh", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Force refresh (bypass cache)", "default": false, "title": "Refresh" }, "description": "Force refresh (bypass cache)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Sentinel Digest Api V1 Prediction Markets Sentinel Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/prediction-markets/detail/{source}/{market_id}": { "get": { "tags": [ "prediction-markets" ], "summary": "Market Detail", "description": "Get detailed market data including live orderbook prices.\n\nSources: polymarket, kalshi", "operationId": "market_detail_api_v1_prediction_markets_detail__source___market_id__get", "parameters": [ { "name": "source", "in": "path", "required": true, "schema": { "type": "string", "title": "Source" } }, { "name": "market_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Market Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Market Detail Api V1 Prediction Markets Detail Source Market Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/prediction-markets/sources": { "get": { "tags": [ "prediction-markets" ], "summary": "List Sources", "description": "List all integrated prediction market data sources.", "operationId": "list_sources_api_v1_prediction_markets_sources_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Sources Api V1 Prediction Markets Sources Get" } } } } } } }, "/scam-school/courses": { "get": { "tags": [ "scam-school", "scam-school" ], "summary": "List Courses", "description": "List all available courses with metadata.", "operationId": "list_courses_scam_school_courses_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Courses Scam School Courses Get" } } } } } } }, "/scam-school/courses/{course_id}": { "get": { "tags": [ "scam-school", "scam-school" ], "summary": "Get Course", "description": "Get full course content including all lesson slides.", "operationId": "get_course_scam_school_courses__course_id__get", "parameters": [ { "name": "course_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Course Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Course Scam School Courses Course Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scam-school/courses/{course_id}/modules/{module_id}": { "get": { "tags": [ "scam-school", "scam-school" ], "summary": "Get Module", "description": "Get a specific module's content.", "operationId": "get_module_scam_school_courses__course_id__modules__module_id__get", "parameters": [ { "name": "course_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Course Id" } }, { "name": "module_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Module Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Module Scam School Courses Course Id Modules Module Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scam-school/badges": { "get": { "tags": [ "scam-school", "scam-school" ], "summary": "List Badges", "description": "List all available badges.", "operationId": "list_badges_scam_school_badges_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Badges Scam School Badges Get" } } } } } } }, "/scam-school/achievements": { "get": { "tags": [ "scam-school", "scam-school" ], "summary": "List Achievements", "description": "List all achievements.", "operationId": "list_achievements_scam_school_achievements_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Achievements Scam School Achievements Get" } } } } } } }, "/scam-school/levels": { "get": { "tags": [ "scam-school", "scam-school" ], "summary": "List Levels", "description": "List level progression.", "operationId": "list_levels_scam_school_levels_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Levels Scam School Levels Get" } } } } } } }, "/scam-school/verify-cert/{cert_id}": { "get": { "tags": [ "scam-school", "scam-school" ], "summary": "Verify Certificate", "description": "Verify a certificate's authenticity.", "operationId": "verify_certificate_scam_school_verify_cert__cert_id__get", "parameters": [ { "name": "cert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cert Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Verify Certificate Scam School Verify Cert Cert Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scam-school/progress": { "get": { "tags": [ "scam-school", "scam-school" ], "summary": "Get Progress", "description": "Get current user's full progress.", "operationId": "get_progress_scam_school_progress_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Progress Scam School Progress Get" } } } } } } }, "/scam-school/lessons/{course_id}/{lesson_id}/complete": { "post": { "tags": [ "scam-school", "scam-school" ], "summary": "Complete Lesson", "description": "Mark a lesson as complete and award XP.", "operationId": "complete_lesson_scam_school_lessons__course_id___lesson_id__complete_post", "parameters": [ { "name": "course_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Course Id" } }, { "name": "lesson_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Lesson Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LessonComplete" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Complete Lesson Scam School Lessons Course Id Lesson Id Complete Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scam-school/exams/{course_id}/{exam_id}": { "post": { "tags": [ "scam-school", "scam-school" ], "summary": "Submit Exam", "description": "Submit an exam and get results.", "operationId": "submit_exam_scam_school_exams__course_id___exam_id__post", "parameters": [ { "name": "course_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Course Id" } }, { "name": "exam_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Exam Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExamSubmit" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Submit Exam Scam School Exams Course Id Exam Id Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scam-school/leaderboard": { "get": { "tags": [ "scam-school", "scam-school" ], "summary": "Get Leaderboard", "description": "Get global leaderboard by XP.", "operationId": "get_leaderboard_scam_school_leaderboard_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Leaderboard Scam School Leaderboard Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/wallet-clusters/detect": { "post": { "tags": [ "wallet-clustering" ], "summary": "Detect Clusters", "description": "Detect wallet clusters from a list of addresses (7 methods).", "operationId": "detect_clusters_api_v1_wallet_clusters_detect_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__wallet_clustering_router__ClusterRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Detect Clusters Api V1 Wallet Clusters Detect Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/wallet-clusters/funding-path": { "post": { "tags": [ "wallet-clustering" ], "summary": "Trace Funding Path", "description": "Trace the funding path between two wallets (BFS).", "operationId": "trace_funding_path_api_v1_wallet_clusters_funding_path_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FundingPathRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Trace Funding Path Api V1 Wallet Clusters Funding Path Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/wallet-clusters/scan": { "post": { "tags": [ "wallet-clustering" ], "summary": "Scan All", "description": "Run all 4 clustering methods and return merged results with fusion brief.", "operationId": "scan_all_api_v1_wallet_clusters_scan_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Scan All Api V1 Wallet Clusters Scan Post" } } } } } } }, "/api/v1/wallet-clusters/health": { "get": { "tags": [ "wallet-clustering" ], "summary": "Clustering Health", "description": "Health check for the wallet clustering engine. Returns status of clustering models and data sources.", "operationId": "clustering_health_api_v1_wallet_clusters_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Clustering Health Api V1 Wallet Clusters Health Get" } } } } } } }, "/api/v1/wallet-clusters/report/{cluster_id}": { "get": { "tags": [ "wallet-clustering" ], "summary": "Get Cluster Report", "description": "Get detailed report for a specific cluster.", "operationId": "get_cluster_report_api_v1_wallet_clusters_report__cluster_id__get", "parameters": [ { "name": "cluster_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cluster Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Cluster Report Api V1 Wallet Clusters Report Cluster Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/wallet-clusters/rugmap-data": { "post": { "tags": [ "wallet-clustering" ], "summary": "Get Rugmap Data", "description": "Generate RugMap data for a wallet.\nSupports up to 250 wallets deep. Optional AI deep dive for advanced forensics.\n\nResponses are wrapped with DataFusion intelligence brief for\ncross-referenced risk assessment.", "operationId": "get_rugmap_data_api_v1_wallet_clusters_rugmap_data_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RugMapRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Rugmap Data Api V1 Wallet Clusters Rugmap Data Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/wallet-clusters/ai-forensic-breakdown": { "post": { "tags": [ "wallet-clustering" ], "summary": "Get Ai Forensic Breakdown", "description": "Premium AI-driven forensic breakdown that dynamically pulls deeper if necessary.\n\nThis is a unique feature that analyzes the initial cluster (up to 250 wallets) for\nrisk vectors. If complex layering, high-risk patterns, or obfuscation tactics are\ndetected, it automatically expands the search depth (up to 1000 wallets) to provide\na comprehensive forensic breakdown that competitors lack.", "operationId": "get_ai_forensic_breakdown_api_v1_wallet_clusters_ai_forensic_breakdown_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RugMapRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Ai Forensic Breakdown Api V1 Wallet Clusters Ai Forensic Breakdown Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/wallet-clusters/contract-scan": { "post": { "tags": [ "wallet-clustering" ], "summary": "Scan Contract Clusters", "description": "Scan a contract for wallet clusters among its holders.\nFinds real holder wallets via Helius, then detects clusters.", "operationId": "scan_contract_clusters_api_v1_wallet_clusters_contract_scan_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContractScanRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Scan Contract Clusters Api V1 Wallet Clusters Contract Scan Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/contract/{address}": { "get": { "tags": [ "security" ], "summary": "Get Contract Intelligence", "description": "Get contract security intelligence including Mythril and Slither analysis results, known vulnerabilities, and risk scoring.", "operationId": "contract_analysis_api_v1_security_contract__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "deep", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Deep" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Contract Analysis Api V1 Security Contract Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/scan/batch": { "post": { "tags": [ "security" ], "summary": "Batch Contract Scan", "description": "Batch contract scan - fast or deep.", "operationId": "batch_contract_scan_api_v1_security_scan_batch_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchContractRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Batch Contract Scan Api V1 Security Scan Batch Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/wallet/{address}": { "get": { "tags": [ "security" ], "summary": "Wallet Security Check", "description": "Full wallet security check: reputation + threat intel.", "operationId": "wallet_security_check_api_v1_security_wallet__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "auto", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Wallet Security Check Api V1 Security Wallet Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/wallet/analyze": { "post": { "tags": [ "security" ], "summary": "Wallet Ml Analysis", "description": "ML behavioral analysis of wallet transactions.", "operationId": "wallet_ml_analysis_api_v1_security_wallet_analyze_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletAnalyzeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Wallet Ml Analysis Api V1 Security Wallet Analyze Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/threat/check": { "post": { "tags": [ "security" ], "summary": "Batch Threat Check", "description": "Batch threat intel lookup.", "operationId": "batch_threat_check_api_v1_security_threat_check_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ThreatBatchRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Batch Threat Check Api V1 Security Threat Check Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/graph/analyze": { "post": { "tags": [ "security" ], "summary": "Graph Analyze", "description": "Transaction graph: clusters, flows, anomalies.", "operationId": "graph_analyze_api_v1_security_graph_analyze_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GraphAnalyzeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Graph Analyze Api V1 Security Graph Analyze Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/crosschain/correlate": { "post": { "tags": [ "security" ], "summary": "Crosschain Correlate", "description": "Find cross-chain wallet correlations.", "operationId": "crosschain_correlate_api_v1_security_crosschain_correlate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CrossChainRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Crosschain Correlate Api V1 Security Crosschain Correlate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/ml/token/anomaly": { "post": { "tags": [ "security" ], "summary": "Token Metric Anomaly", "description": "Detect token metric anomalies vs baseline.", "operationId": "token_metric_anomaly_api_v1_security_ml_token_anomaly_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenMetricRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Token Metric Anomaly Api V1 Security Ml Token Anomaly Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/mempool/status": { "get": { "tags": [ "security" ], "summary": "Mempool Status", "description": "Mempool sentinel status + recent detections.", "operationId": "mempool_status_api_v1_security_mempool_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Mempool Status Api V1 Security Mempool Status Get" } } } } } } }, "/api/v1/security/mempool/start": { "post": { "tags": [ "security" ], "summary": "Mempool Start", "description": "Start monitoring the mempool for suspicious transactions on a specified chain.", "operationId": "mempool_start_api_v1_security_mempool_start_post", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Mempool Start Api V1 Security Mempool Start Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/mempool/stop": { "post": { "tags": [ "security" ], "summary": "Mempool Stop", "description": "Stop monitoring the mempool for a specified chain.", "operationId": "mempool_stop_api_v1_security_mempool_stop_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Mempool Stop Api V1 Security Mempool Stop Post" } } } } } } }, "/api/v1/security/dashboard/stats": { "get": { "tags": [ "security" ], "summary": "Dashboard Stats", "description": "Security dashboard statistics.", "operationId": "dashboard_stats_api_v1_security_dashboard_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Dashboard Stats Api V1 Security Dashboard Stats Get" } } } } } } }, "/api/v1/security/dashboard/alerts": { "get": { "tags": [ "security" ], "summary": "Dashboard Alerts", "description": "Query security alerts.", "operationId": "dashboard_alerts_api_v1_security_dashboard_alerts_get", "parameters": [ { "name": "severity", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "title": "Limit" } }, { "name": "unacknowledged", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Unacknowledged" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Dashboard Alerts Api V1 Security Dashboard Alerts Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/dashboard/acknowledge": { "post": { "tags": [ "security" ], "summary": "Dashboard Acknowledge", "description": "Acknowledge an alert.", "operationId": "dashboard_acknowledge_api_v1_security_dashboard_acknowledge_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertAckRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Dashboard Acknowledge Api V1 Security Dashboard Acknowledge Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/dashboard/score": { "get": { "tags": [ "security" ], "summary": "Dashboard Score", "description": "Get rolling security score.", "operationId": "dashboard_score_api_v1_security_dashboard_score_get", "parameters": [ { "name": "hours", "in": "query", "required": false, "schema": { "type": "integer", "default": 24, "title": "Hours" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Dashboard Score Api V1 Security Dashboard Score Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/dashboard/timeline/{target}": { "get": { "tags": [ "security" ], "summary": "Dashboard Timeline", "description": "Get incident timeline for a target.", "operationId": "dashboard_timeline_api_v1_security_dashboard_timeline__target__get", "parameters": [ { "name": "target", "in": "path", "required": true, "schema": { "type": "string", "title": "Target" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Dashboard Timeline Api V1 Security Dashboard Timeline Target Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/entity/label/{address}": { "get": { "tags": [ "security" ], "summary": "Entity Label", "description": "Lookup entity label for an address.", "operationId": "entity_label_api_v1_security_entity_label__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Entity Label Api V1 Security Entity Label Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/entity/batch": { "post": { "tags": [ "security" ], "summary": "Entity Batch Label", "description": "Batch entity label lookup.", "operationId": "entity_batch_label_api_v1_security_entity_batch_post", "requestBody": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array", "title": "Addresses" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Entity Batch Label Api V1 Security Entity Batch Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/entity/search": { "get": { "tags": [ "security" ], "summary": "Entity Search", "description": "Search entity database.", "operationId": "entity_search_api_v1_security_entity_search_get", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Q" } }, { "name": "category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Entity Search Api V1 Security Entity Search Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/entity/stats": { "get": { "tags": [ "security" ], "summary": "Entity Stats", "description": "Entity database statistics.", "operationId": "entity_stats_api_v1_security_entity_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Entity Stats Api V1 Security Entity Stats Get" } } } } } } }, "/api/v1/security/entity/{entity_id}": { "get": { "tags": [ "security" ], "summary": "Entity Detail", "description": "Full entity graph with addresses and relationships.", "operationId": "entity_detail_api_v1_security_entity__entity_id__get", "parameters": [ { "name": "entity_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Entity Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Entity Detail Api V1 Security Entity Entity Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/portfolio/{wallet}": { "get": { "tags": [ "security" ], "summary": "Portfolio Single", "description": "Get portfolio for a single wallet.", "operationId": "portfolio_single_api_v1_security_portfolio__wallet__get", "parameters": [ { "name": "wallet", "in": "path", "required": true, "schema": { "type": "string", "title": "Wallet" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Portfolio Single Api V1 Security Portfolio Wallet Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/portfolio/multi": { "post": { "tags": [ "security" ], "summary": "Portfolio Multi", "description": "Aggregate portfolio across multiple wallets/chains.", "operationId": "portfolio_multi_api_v1_security_portfolio_multi_post", "requestBody": { "content": { "application/json": { "schema": { "items": { "additionalProperties": { "type": "string" }, "type": "object" }, "type": "array", "title": "Wallets" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Portfolio Multi Api V1 Security Portfolio Multi Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/portfolio/history/{wallet}": { "get": { "tags": [ "security" ], "summary": "Portfolio History", "description": "Historical net worth chart data.", "operationId": "portfolio_history_api_v1_security_portfolio_history__wallet__get", "parameters": [ { "name": "wallet", "in": "path", "required": true, "schema": { "type": "string", "title": "Wallet" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "hours", "in": "query", "required": false, "schema": { "type": "integer", "default": 24, "title": "Hours" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Portfolio History Api V1 Security Portfolio History Wallet Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/monitor/watch": { "post": { "tags": [ "security" ], "summary": "Monitor Watch", "description": "Add a wallet to the watchlist.", "operationId": "monitor_watch_api_v1_security_monitor_watch_post", "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } }, { "name": "tags", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Tags" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Monitor Watch Api V1 Security Monitor Watch Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/monitor/unwatch": { "post": { "tags": [ "security" ], "summary": "Monitor Unwatch", "description": "Remove a wallet from the watchlist.", "operationId": "monitor_unwatch_api_v1_security_monitor_unwatch_post", "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "ethereum", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Monitor Unwatch Api V1 Security Monitor Unwatch Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/monitor/watches": { "get": { "tags": [ "security" ], "summary": "Monitor List", "description": "List all watched wallets.", "operationId": "monitor_list_api_v1_security_monitor_watches_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Monitor List Api V1 Security Monitor Watches Get" } } } } } } }, "/api/v1/security/flows/analyze": { "post": { "tags": [ "security" ], "summary": "Flows Analyze", "description": "Analyze fund flows for an entity.", "operationId": "flows_analyze_api_v1_security_flows_analyze_post", "parameters": [ { "name": "entity_name", "in": "query", "required": true, "schema": { "type": "string", "title": "Entity Name" } }, { "name": "entity_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Entity Id" } }, { "name": "chain", "in": "query", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "hours", "in": "query", "required": false, "schema": { "type": "integer", "default": 24, "title": "Hours" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Body_flows_analyze_api_v1_security_flows_analyze_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Flows Analyze Api V1 Security Flows Analyze Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/flows/reserves": { "post": { "tags": [ "security" ], "summary": "Flows Reserves", "description": "Get reserve snapshot for entity addresses.", "operationId": "flows_reserves_api_v1_security_flows_reserves_post", "parameters": [ { "name": "entity_name", "in": "query", "required": true, "schema": { "type": "string", "title": "Entity Name" } }, { "name": "entity_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Entity Id" } }, { "name": "chain", "in": "query", "required": true, "schema": { "type": "string", "title": "Chain" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" }, "title": "Entity Addresses" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Flows Reserves Api V1 Security Flows Reserves Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/flows/compare": { "post": { "tags": [ "security" ], "summary": "Flows Compare", "description": "Compare fund flows between two entities.", "operationId": "flows_compare_api_v1_security_flows_compare_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Body_flows_compare_api_v1_security_flows_compare_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Flows Compare Api V1 Security Flows Compare Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/security/health": { "get": { "tags": [ "security" ], "summary": "Security Health", "description": "Full subsystem health check.", "operationId": "security_health_api_v1_security_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Security Health Api V1 Security Health Get" } } } } } } }, "/api/v1/mev-sniper/signals": { "get": { "tags": [ "mev-sniper" ], "summary": "Get Snipe Signals", "description": "Get real-time snipe signals for a chain. Sorted by snipe_score descending.", "operationId": "get_snipe_signals_api_v1_mev_sniper_signals_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "max_age_min", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 120, "minimum": 1, "default": 30, "title": "Max Age Min" } }, { "name": "min_liquidity", "in": "query", "required": false, "schema": { "type": "number", "minimum": 0, "default": 5000, "title": "Min Liquidity" } }, { "name": "min_safety", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 0, "default": 30, "title": "Min Safety" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Snipe Signals Api V1 Mev Sniper Signals Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/mev-sniper/chains": { "get": { "tags": [ "mev-sniper" ], "summary": "List Sniper Chains", "description": "List all supported blockchain networks available for MEV sniper signal detection.", "operationId": "list_sniper_chains_api_v1_mev_sniper_chains_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Sniper Chains Api V1 Mev Sniper Chains Get" } } } } } } }, "/api/v2/scanner/token/scan": { "post": { "tags": [ "scanner-v2" ], "summary": "Scan Token", "description": "Comprehensive token scan across 50+ security modules. Returns safety score, risk flags, green flags, and detailed module results.", "operationId": "scan_token_api_v2_scanner_token_scan_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenScanRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Scan Token Api V2 Scanner Token Scan Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v2/scanner/token/deepscan": { "post": { "tags": [ "scanner-v2" ], "summary": "Deep Scan Token", "description": "Full deep scan \u2014 runs ALL modules including premium/SENTINEL (bundle detect, cluster map, dev finder, wash trade, MEV, sniper, insider, bot farm, holder analysis, LP verification, contract authority, proxy detection). Not gated \u2014 free to use.", "operationId": "deepscan_token_api_v2_scanner_token_deepscan_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenScanRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Deepscan Token Api V2 Scanner Token Deepscan Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v2/scanner/token/scan/{chain}/{address}/status": { "get": { "tags": [ "scanner-v2" ], "summary": "Token Scan Status", "description": "Get the status of an in-flight token scan (or a completed cached result). The scan endpoint returns within ~25s while deep/intel/SENTINEL/news phases continue in the background; poll this endpoint for progress and the final full result.", "operationId": "get_token_scan_status_api_v2_scanner_token_scan__chain___address__status_get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Token Scan Status Api V2 Scanner Token Scan Chain Address Status Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v2/scanner/wallet/scan": { "post": { "tags": [ "scanner-v2" ], "summary": "Scan Wallet", "description": "Comprehensive wallet scan with entity clustering, risk scoring, behavioral analysis, and RAG-based threat intelligence matching.", "operationId": "scan_wallet_api_v2_scanner_wallet_scan_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletScanRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Scan Wallet Api V2 Scanner Wallet Scan Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v2/scanner/token/price/{chain}/{address}": { "get": { "tags": [ "scanner-data" ], "summary": "Get cached scanner price data", "description": "Return cached price data from the last scanner run.\n\nFields returned: price_usd, market_cap_usd, liquidity_usd, volume_24h_usd,\nname, symbol, scanned_at, age_hours.", "operationId": "get_scanner_price_api_v2_scanner_token_price__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Scanner Price Api V2 Scanner Token Price Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v2/scanner/token/holders/{chain}/{address}": { "get": { "tags": [ "scanner-data" ], "summary": "Get cached holder distribution", "description": "Return cached holder distribution from the last scanner run.\n\nIncludes wallet freshness breakdown (fresh/established), exchange funding\nanalysis, and scam-overlap data when available.", "operationId": "get_scanner_holders_api_v2_scanner_token_holders__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Scanner Holders Api V2 Scanner Token Holders Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v2/scanner/token/liquidity/{chain}/{address}": { "get": { "tags": [ "scanner-data" ], "summary": "Get cached LP analysis", "description": "Return cached LP analysis from the last scanner run.\n\nIncludes liquidity pool health, lock status, concentration metrics (HHI),\nand SENTINEL liquidity verification results.", "operationId": "get_scanner_liquidity_api_v2_scanner_token_liquidity__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Scanner Liquidity Api V2 Scanner Token Liquidity Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v2/scanner/token/risk/{chain}/{address}": { "get": { "tags": [ "scanner-data" ], "summary": "Get cached risk scores", "description": "Return cached risk scores from the last scanner run.\n\nIncludes safety_score, risk_level, all risk_flags, green_flags,\nconfidence, breakdown, evidence, and any SENTINEL deep-forensic findings.", "operationId": "get_scanner_risk_api_v2_scanner_token_risk__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Scanner Risk Api V2 Scanner Token Risk Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v2/scanner/token/full/{chain}/{address}": { "get": { "tags": [ "scanner-data" ], "summary": "Get all cached scanner data", "description": "Return the complete cached scan result.\n\nConvenience endpoint that returns everything the scanner cached.\nUse the individual endpoints above for targeted queries.", "operationId": "get_scanner_full_api_v2_scanner_token_full__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Scanner Full Api V2 Scanner Token Full Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/rugmap": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Rugmap", "description": "Holder RugMap. $0.02/call.", "operationId": "x402_rugmap_api_v1_x402_databus_rugmap_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddressDepthRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Rugmap Api V1 X402 Databus Rugmap Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/rugmaps-analysis": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Rugmaps Analysis", "description": "RugMaps AI holder analysis. $0.02/call.", "operationId": "x402_rugmaps_analysis_api_v1_x402_databus_rugmaps_analysis_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Rugmaps Analysis Api V1 X402 Databus Rugmaps Analysis Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/risk-scan": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Risk Scan", "description": "RugShield quick scan. $0.02/call.", "operationId": "x402_risk_scan_api_v1_x402_databus_risk_scan_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Risk Scan Api V1 X402 Databus Risk Scan Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/threat-check": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Threat Check", "description": "Threat intel check. $0.02/call.", "operationId": "x402_threat_check_api_v1_x402_databus_threat_check_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Threat Check Api V1 X402 Databus Threat Check Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/contract-scan": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Contract Scan", "description": "Deep contract auditor. $0.08/call.", "operationId": "x402_contract_scan_api_v1_x402_databus_contract_scan_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Contract Scan Api V1 X402 Databus Contract Scan Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/sentinel-deep": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Sentinel Deep", "description": "SENTINEL deep scan. $0.10/call.", "operationId": "x402_sentinel_deep_api_v1_x402_databus_sentinel_deep_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Sentinel Deep Api V1 X402 Databus Sentinel Deep Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/entity-intel": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Entity Intel", "description": "Entity intelligence lookup. $0.10/call.", "operationId": "x402_entity_intel_api_v1_x402_databus_entity_intel_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Entity Intel Api V1 X402 Databus Entity Intel Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/rag-search": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Rag Search", "description": "Knowledge search engine. $0.05/call.", "operationId": "x402_rag_search_api_v1_x402_databus_rag_search_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QueryRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Rag Search Api V1 X402 Databus Rag Search Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/fetch": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Universal Fetch", "description": "Universal DataBus fetch through x402 paywall.\nAccepts any data_type. Pricing is automatic based on X402_TOOL_PRICING.", "operationId": "x402_universal_fetch_api_v1_x402_databus_fetch_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericDataRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Universal Fetch Api V1 X402 Databus Fetch Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/catalog": { "get": { "tags": [ "x402-databus-tools" ], "summary": "X402 Catalog", "description": "Full catalog of available x402 DataBus tools with pricing.", "operationId": "x402_catalog_api_v1_x402_databus_catalog_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response X402 Catalog Api V1 X402 Databus Catalog Get" } } } } } } }, "/api/v1/x402-databus/access-matrix": { "get": { "tags": [ "x402-databus-tools" ], "summary": "X402 Access Matrix", "description": "Show which data types each x402 tier can access.", "operationId": "x402_access_matrix_api_v1_x402_databus_access_matrix_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response X402 Access Matrix Api V1 X402 Databus Access Matrix Get" } } } } } } }, "/api/v1/x402-databus/trials/{identifier}": { "get": { "tags": [ "x402-databus-tools" ], "summary": "X402 Trial Status", "description": "Check remaining free trials for a wallet or fingerprint.", "operationId": "x402_trial_status_api_v1_x402_databus_trials__identifier__get", "parameters": [ { "name": "identifier", "in": "path", "required": true, "schema": { "type": "string", "title": "Identifier" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response X402 Trial Status Api V1 X402 Databus Trials Identifier Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/token-price": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Token Price", "description": "Token price from multi-source consensus. $0.01/call.", "operationId": "x402_token_price_api_v1_x402_databus_token_price_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MintRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Token Price Api V1 X402 Databus Token Price Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/token-detail": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Token Detail", "description": "Rich token intelligence report. $0.02/call.", "operationId": "x402_token_detail_api_v1_x402_databus_token_detail_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MintRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Token Detail Api V1 X402 Databus Token Detail Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/trending": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Trending", "description": "Trending tokens feed. $0.01/call.", "operationId": "x402_trending_api_v1_x402_databus_trending_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QueryRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Trending Api V1 X402 Databus Trending Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/market-overview": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Market Overview", "description": "Market landscape overview. $0.02/call.", "operationId": "x402_market_overview_api_v1_x402_databus_market_overview_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Market Overview Api V1 X402 Databus Market Overview Post" } } } } } } }, "/api/v1/x402-databus/market-movers": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Market Movers", "description": "Top market movers. $0.01/call.", "operationId": "x402_market_movers_api_v1_x402_databus_market_movers_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Market Movers Api V1 X402 Databus Market Movers Post" } } } } } } }, "/api/v1/x402-databus/tvl": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Tvl", "description": "DeFi TVL tracker. $0.01/call.", "operationId": "x402_tvl_api_v1_x402_databus_tvl_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QueryRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Tvl Api V1 X402 Databus Tvl Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/news": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 News", "description": "Crypto news feed. $0.01/call.", "operationId": "x402_news_api_v1_x402_databus_news_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QueryRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 News Api V1 X402 Databus News Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/social-feed": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Social Feed", "description": "Social intelligence feed. $0.01/call.", "operationId": "x402_social_feed_api_v1_x402_databus_social_feed_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Social Feed Api V1 X402 Databus Social Feed Post" } } } } } } }, "/api/v1/x402-databus/dex-data": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Dex Data", "description": "DEX liquidity data. $0.01/call.", "operationId": "x402_dex_data_api_v1_x402_databus_dex_data_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MintRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Dex Data Api V1 X402 Databus Dex Data Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/defi-protocols": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Defi Protocols", "description": "DeFi protocol tracker. $0.01/call.", "operationId": "x402_defi_protocols_api_v1_x402_databus_defi_protocols_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Defi Protocols Api V1 X402 Databus Defi Protocols Post" } } } } } } }, "/api/v1/x402-databus/prediction-markets": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Prediction Markets", "description": "Prediction market intel. $0.02/call.", "operationId": "x402_prediction_markets_api_v1_x402_databus_prediction_markets_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QueryRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Prediction Markets Api V1 X402 Databus Prediction Markets Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/prediction-signals": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Prediction Signals", "description": "Automated trading signals. $0.02/call.", "operationId": "x402_prediction_signals_api_v1_x402_databus_prediction_signals_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Prediction Signals Api V1 X402 Databus Prediction Signals Post" } } } } } } }, "/api/v1/x402-databus/wallet-balance": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Wallet Balance", "description": "Wallet balance check. $0.01/call.", "operationId": "x402_wallet_balance_api_v1_x402_databus_wallet_balance_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Wallet Balance Api V1 X402 Databus Wallet Balance Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/wallet-labels": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Wallet Labels", "description": "Wallet entity lookup. $0.02/call.", "operationId": "x402_wallet_labels_api_v1_x402_databus_wallet_labels_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Wallet Labels Api V1 X402 Databus Wallet Labels Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/socialfi-resolve": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Socialfi Resolve", "description": "Social identity resolver. $0.01/call.", "operationId": "x402_socialfi_resolve_api_v1_x402_databus_socialfi_resolve_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Socialfi Resolve Api V1 X402 Databus Socialfi Resolve Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/wallet-profile": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Wallet Profile", "description": "Wallet intelligence profiler. $0.05/call.", "operationId": "x402_wallet_profile_api_v1_x402_databus_wallet_profile_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Wallet Profile Api V1 X402 Databus Wallet Profile Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/smart-money": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Smart Money", "description": "Smart money tracker. $0.05/call.", "operationId": "x402_smart_money_api_v1_x402_databus_smart_money_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QueryRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Smart Money Api V1 X402 Databus Smart Money Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/funding-source": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Funding Source", "description": "Funding source tracer. $0.08/call.", "operationId": "x402_funding_source_api_v1_x402_databus_funding_source_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Funding Source Api V1 X402 Databus Funding Source Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/cross-chain": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Cross Chain", "description": "Cross-chain correlator. $0.08/call.", "operationId": "x402_cross_chain_api_v1_x402_databus_cross_chain_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Cross Chain Api V1 X402 Databus Cross Chain Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/wallet-cluster": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Wallet Cluster", "description": "Syndicate network mapper. $0.08/call.", "operationId": "x402_wallet_cluster_api_v1_x402_databus_wallet_cluster_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Wallet Cluster Api V1 X402 Databus Wallet Cluster Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/bundle-detect": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Bundle Detect", "description": "Bot activity detector. $0.08/call.", "operationId": "x402_bundle_detect_api_v1_x402_databus_bundle_detect_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Bundle Detect Api V1 X402 Databus Bundle Detect Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/wallet-tokens": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Wallet Tokens", "description": "Wallet token holdings. $0.05/call.", "operationId": "x402_wallet_tokens_api_v1_x402_databus_wallet_tokens_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Wallet Tokens Api V1 X402 Databus Wallet Tokens Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/wallet-pnl": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Wallet Pnl", "description": "Wallet PnL tracker. $0.05/call.", "operationId": "x402_wallet_pnl_api_v1_x402_databus_wallet_pnl_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Wallet Pnl Api V1 X402 Databus Wallet Pnl Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/arkham-portfolio": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Arkham Portfolio", "description": "Arkham portfolio intel. $0.25/call. Requires admin key.", "operationId": "x402_arkham_portfolio_api_v1_x402_databus_arkham_portfolio_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Arkham Portfolio Api V1 X402 Databus Arkham Portfolio Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/arkham-transfers": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Arkham Transfers", "description": "Arkham transfer tracer. $0.20/call.", "operationId": "x402_arkham_transfers_api_v1_x402_databus_arkham_transfers_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Arkham Transfers Api V1 X402 Databus Arkham Transfers Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/nansen-labels": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Nansen Labels", "description": "Nansen label intelligence. $0.15/call.", "operationId": "x402_nansen_labels_api_v1_x402_databus_nansen_labels_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Nansen Labels Api V1 X402 Databus Nansen Labels Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-databus/portfolio": { "post": { "tags": [ "x402-databus-tools" ], "summary": "X402 Portfolio", "description": "Multi-wallet portfolio tracker. $0.15/call.", "operationId": "x402_portfolio_api_v1_x402_databus_portfolio_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__x402_databus_tools__models__AddressRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response X402 Portfolio Api V1 X402 Databus Portfolio Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/status": { "get": { "tags": [ "status-page" ], "summary": "Get Status", "description": "Get full status for all services.", "operationId": "get_status_api_v1_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Status Api V1 Status Get" } } } } } } }, "/api/v1/status/summary": { "get": { "tags": [ "status-page" ], "summary": "Status Summary", "description": "Get one-line summary for status badges.", "operationId": "status_summary_api_v1_status_summary_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Status Summary Api V1 Status Summary Get" } } } } } } }, "/api/v1/status/history": { "get": { "tags": [ "status-page" ], "summary": "Status History", "description": "Get uptime history.", "operationId": "status_history_api_v1_status_history_get", "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "default": 7, "title": "Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Status History Api V1 Status History Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/status/incident": { "post": { "tags": [ "status-page" ], "summary": "Create Incident", "description": "Report an incident (admin only).", "operationId": "create_incident_api_v1_status_incident_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IncidentReport" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Create Incident Api V1 Status Incident Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/status/services": { "get": { "tags": [ "status-page" ], "summary": "List Services", "description": "List all monitored services.", "operationId": "list_services_api_v1_status_services_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response List Services Api V1 Status Services Get" } } } } } } }, "/api/v1/system/backup-status": { "get": { "tags": [ "system", "backup" ], "summary": "Backup Status", "description": "Full backup pipeline status.\n\nReturns:\n - last_backup: timestamp and archive info from last run\n - b2: B2 connectivity check\n - directory: backup directory disk usage and file counts\n - recent_archives: last 5 local backup archives\n - log: recent log entries (completion/errors)\n - overall: healthy/degraded/unhealthy verdict", "operationId": "backup_status_api_v1_system_backup_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/v1/system/backup-config": { "get": { "tags": [ "system", "backup" ], "summary": "Backup Config", "description": "Current backup configuration values.\n\nReturns sanitized config \u2014 no secrets or infra details.", "operationId": "backup_config_api_v1_system_backup_config_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/api/v1/protect/check-url": { "post": { "tags": [ "protection" ], "summary": "Check Url", "description": "Check a URL for phishing/scam content.", "operationId": "check_url_api_v1_protect_check_url_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/URLCheckRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProtectionResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/protect/check-wallet": { "post": { "tags": [ "protection" ], "summary": "Check Wallet", "description": "Check a wallet address for risk.", "operationId": "check_wallet_api_v1_protect_check_wallet_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletCheckRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProtectionResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/protect/check-token": { "post": { "tags": [ "protection" ], "summary": "Check Token", "description": "Check a token address for safety.", "operationId": "check_token_api_v1_protect_check_token_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenCheckRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProtectionResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/protect/domains": { "get": { "tags": [ "protection" ], "summary": "Get Domains", "description": "Return the blocklist JSON for extension download.", "operationId": "get_domains_api_v1_protect_domains_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "additionalProperties": { "items": {}, "type": "array" }, "type": "object" } ], "title": "Response Get Domains Api V1 Protect Domains Get" } } } } } } }, "/api/v1/protect/health": { "get": { "tags": [ "protection" ], "summary": "Protection Health", "description": "Health check for protection modules.", "operationId": "protection_health_api_v1_protect_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Protection Health Api V1 Protect Health Get" } } } } } } }, "/api/v1/developer/keys": { "post": { "tags": [ "developer-portal" ], "summary": "Create Api Key", "description": "Generate a new API key. Free tier: 100 requests/day.", "operationId": "create_api_key_api_v1_developer_keys_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateKeyRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Create Api Key Api V1 Developer Keys Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "developer-portal" ], "summary": "List Keys", "description": "List your API keys.", "operationId": "list_keys_api_v1_developer_keys_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": true, "schema": { "type": "string", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "array", "items": {} }, "title": "Response List Keys Api V1 Developer Keys Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/developer/keys/{key}": { "delete": { "tags": [ "developer-portal" ], "summary": "Revoke Key", "description": "Revoke an API key.", "operationId": "revoke_key_api_v1_developer_keys__key__delete", "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "title": "Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Revoke Key Api V1 Developer Keys Key Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/developer/usage": { "get": { "tags": [ "developer-portal" ], "summary": "Get Usage", "description": "Get your API usage stats.", "operationId": "get_usage_api_v1_developer_usage_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": true, "schema": { "type": "string", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Usage Api V1 Developer Usage Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "developer-tier" ], "summary": "Get Usage", "description": "Get detailed usage for an API key.", "operationId": "get_usage_api_v1_developer_usage_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UsageRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Usage Api V1 Developer Usage Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/developer/docs": { "get": { "tags": [ "developer-portal" ], "summary": "Api Docs", "description": "API documentation - available endpoints.", "operationId": "api_docs_api_v1_developer_docs_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Api Docs Api V1 Developer Docs Get" } } } } } } }, "/api/v1/developer/register": { "post": { "tags": [ "developer-tier" ], "summary": "Register Developer", "description": "Register for a free developer API key. 100 calls/day, no payment needed.", "operationId": "register_developer_api_v1_developer_register_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegisterRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Register Developer Api V1 Developer Register Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/developer/verify": { "post": { "tags": [ "developer-tier" ], "summary": "Verify Key", "description": "Verify an API key and get usage stats.", "operationId": "verify_key_api_v1_developer_verify_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerifyRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Verify Key Api V1 Developer Verify Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/developer/tiers": { "get": { "tags": [ "developer-tier" ], "summary": "List Tiers", "description": "List available developer tiers.", "operationId": "list_tiers_api_v1_developer_tiers_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response List Tiers Api V1 Developer Tiers Get" } } } } } } }, "/api/v1/developer/wallet/verify": { "post": { "tags": [ "developer-tier" ], "summary": "Verify Wallet Identity", "description": "Verify wallet ownership via signature.\n\nGrants a persistent wallet-based identity for trials that survives IP changes.\nUsers sign a challenge message with their wallet to prove ownership.", "operationId": "verify_wallet_identity_api_v1_developer_wallet_verify_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletVerifyRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Verify Wallet Identity Api V1 Developer Wallet Verify Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/developer/wallet/get_challenge": { "post": { "tags": [ "developer-tier" ], "summary": "Get Wallet Challenge", "description": "Get a challenge message to sign with your wallet.", "operationId": "get_wallet_challenge_api_v1_developer_wallet_get_challenge_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerifyRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Wallet Challenge Api V1 Developer Wallet Get Challenge Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/developer/wallet/status/{chain}/{address}": { "get": { "tags": [ "developer-tier" ], "summary": "Wallet Status", "description": "Check wallet verification status and benefits.", "operationId": "wallet_status_api_v1_developer_wallet_status__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Wallet Status Api V1 Developer Wallet Status Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v2/tokens/{address}/intelligence": { "get": { "tags": [ "token-intelligence-v2" ], "summary": "Token Intelligence", "description": "Return composite token intelligence \u2014 all DataBus layers in one call.", "operationId": "token_intelligence_api_v2_tokens__address__intelligence_get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Token Intelligence Api V2 Tokens Address Intelligence Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/facilitator-health/status/{name}": { "get": { "tags": [ "facilitator-health" ], "summary": "Get Facilitator Status", "description": "Get health status for a specific facilitator.", "operationId": "get_facilitator_status_api_v1_x402_facilitator_health_status__name__get", "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string", "title": "Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Facilitator Status Api V1 X402 Facilitator Health Status Name Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/facilitator-health/chains/{chain}": { "get": { "tags": [ "facilitator-health" ], "summary": "Get Facilitators For Chain", "description": "Get healthy facilitators for a specific chain.", "operationId": "get_facilitators_for_chain_api_v1_x402_facilitator_health_chains__chain__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Get Facilitators For Chain Api V1 X402 Facilitator Health Chains Chain Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402/facilitator-health/check/{name}": { "post": { "tags": [ "facilitator-health" ], "summary": "Trigger Health Check", "description": "Manually trigger a health check for a facilitator.", "operationId": "trigger_health_check_api_v1_x402_facilitator_health_check__name__post", "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string", "title": "Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Trigger Health Check Api V1 X402 Facilitator Health Check Name Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/bridge_health": { "post": { "tags": [ "x402-bridge-health" ], "summary": "Bridge Health Scan", "description": "Cross-Chain Bridge Health & Exploit Monitor.\n\nReal-time security intelligence across 12 major bridges:\n LayerZero, Stargate, Across, Wormhole, Hop, Synapse,\n Axelar, Celer cBridge, DeBridge, Chainlink CCIP, Connext, Orbiter.\n\nPricing: $0.10 per scan (2 free trials per wallet per 24h).", "operationId": "bridge_health_scan_api_v1_x402_tools_bridge_health_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BridgeHealthRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Bridge Health Scan Api V1 X402 Tools Bridge Health Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/audit": { "post": { "tags": [ "x402-facade", "x402-token-tools" ], "summary": "Deep Contract Audit", "description": "Full 100-point forensic scan. Returns risk score 0-100 with findings.", "operationId": "deep_contract_audit_api_v1_x402_tools_audit_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Deep Contract Audit Api V1 X402 Tools Audit Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/rugshield": { "post": { "tags": [ "x402-facade", "x402-token-tools" ], "summary": "Rug Shield", "description": "Quick pre-buy safety check. Binary safe/unsafe in under 2 seconds.", "operationId": "rug_shield_api_v1_x402_tools_rugshield_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Rug Shield Api V1 X402 Tools Rugshield Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/pulse": { "post": { "tags": [ "x402-facade", "x402-token-tools" ], "summary": "Token Pulse", "description": "Token health dashboard - liquidity, volume, momentum, trajectory.", "operationId": "token_pulse_api_v1_x402_tools_pulse_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Token Pulse Api V1 X402 Tools Pulse Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/forensics": { "post": { "tags": [ "x402-facade", "x402-token-tools" ], "summary": "Token Forensics", "description": "Deep token forensics report.", "operationId": "token_forensics_api_v1_x402_tools_forensics_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Token Forensics Api V1 X402 Tools Forensics Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/token_deep_dive": { "post": { "tags": [ "x402-facade", "x402-token-tools" ], "summary": "Token Deep Dive", "description": "Deep token analysis across chains.", "operationId": "token_deep_dive_api_v1_x402_tools_token_deep_dive_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Token Deep Dive Api V1 X402 Tools Token Deep Dive Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/honeypot_check": { "post": { "tags": [ "x402-facade", "x402-token-tools" ], "summary": "Honeypot Check", "description": "Honeypot detection.", "operationId": "honeypot_check_api_v1_x402_tools_honeypot_check_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Honeypot Check Api V1 X402 Tools Honeypot Check Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/token_comparison": { "post": { "tags": [ "x402-facade", "x402-token-tools" ], "summary": "Token Comparison", "description": "Side-by-side token comparison.", "operationId": "token_comparison_api_v1_x402_tools_token_comparison_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MultiTokenRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Token Comparison Api V1 X402 Tools Token Comparison Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/risk_monitor": { "post": { "tags": [ "x402-facade", "x402-token-tools" ], "summary": "Risk Monitor", "description": "Real-time risk monitoring.", "operationId": "risk_monitor_api_v1_x402_tools_risk_monitor_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Risk Monitor Api V1 X402 Tools Risk Monitor Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/liquidity_flow": { "post": { "tags": [ "x402-facade", "x402-token-tools" ], "summary": "Liquidity Flow", "description": "Liquidity flow analysis.", "operationId": "liquidity_flow_api_v1_x402_tools_liquidity_flow_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Liquidity Flow Api V1 X402 Tools Liquidity Flow Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/rug_pull_predictor": { "post": { "tags": [ "x402-facade", "x402-token-tools" ], "summary": "Rug Pull Predictor", "description": "Rug pull prediction.", "operationId": "rug_pull_predictor_api_v1_x402_tools_rug_pull_predictor_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Rug Pull Predictor Api V1 X402 Tools Rug Pull Predictor Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/wallet": { "post": { "tags": [ "x402-facade", "x402-wallet-tools" ], "summary": "Wallet Profiler", "description": "Full wallet analysis - persona, activity, holdings, patterns.", "operationId": "wallet_profiler_api_v1_x402_tools_wallet_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Wallet Profiler Api V1 X402 Tools Wallet Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/smartmoney": { "get": { "tags": [ "x402-facade", "x402-wallet-tools" ], "summary": "Smart Money Tracker", "description": "Real-time whale/insider tracking across chains.", "operationId": "smart_money_tracker_api_v1_x402_tools_smartmoney_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "threshold", "in": "query", "required": false, "schema": { "type": "number", "default": 10000.0, "title": "Threshold" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Smart Money Tracker Api V1 X402 Tools Smartmoney Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/cluster": { "post": { "tags": [ "x402-facade", "x402-wallet-tools" ], "summary": "Cluster Detection", "description": "Wallet cluster mapping - sybil detection, hidden networks.", "operationId": "cluster_detection_api_v1_x402_tools_cluster_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__domains__billing__x402__shared_models__ClusterRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Cluster Detection Api V1 X402 Tools Cluster Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/whale": { "post": { "tags": [ "x402-facade", "x402-wallet-tools" ], "summary": "Whale Decoder", "description": "Whale wallet decoder and analysis.", "operationId": "whale_decoder_api_v1_x402_tools_whale_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Whale Decoder Api V1 X402 Tools Whale Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/portfolio_tracker": { "post": { "tags": [ "x402-facade", "x402-wallet-tools" ], "summary": "Portfolio Tracker", "description": "Multi-wallet portfolio tracker.", "operationId": "portfolio_tracker_api_v1_x402_tools_portfolio_tracker_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletListRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Portfolio Tracker Api V1 X402 Tools Portfolio Tracker Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/copy_trade_finder": { "post": { "tags": [ "x402-facade", "x402-wallet-tools" ], "summary": "Copy Trade Finder", "description": "Copy trade intelligence.", "operationId": "copy_trade_finder_api_v1_x402_tools_copy_trade_finder_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Copy Trade Finder Api V1 X402 Tools Copy Trade Finder Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/insider": { "post": { "tags": [ "x402-facade", "x402-deployer-tools" ], "summary": "Insider Tracker", "description": "Dev/team wallet tracking across all their tokens.", "operationId": "insider_tracker_api_v1_x402_tools_insider_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InsiderRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Insider Tracker Api V1 X402 Tools Insider Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/whale_accumulation": { "post": { "tags": [ "x402-facade", "x402-deployer-tools" ], "summary": "Whale Accumulation", "description": "Detect stealth accumulation by large holders before price impact.\nIdentifies quiet buying patterns, OTC accumulation signals, and wallet\nfunding sequences that precede major positions.", "operationId": "whale_accumulation_api_v1_x402_tools_whale_accumulation_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Whale Accumulation Api V1 X402 Tools Whale Accumulation Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/launch": { "get": { "tags": [ "x402-facade", "x402-market-tools" ], "summary": "Launch Radar", "description": "New token launch detection with risk scoring.", "operationId": "launch_radar_api_v1_x402_tools_launch_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "default": "solana", "title": "Chain" } }, { "name": "window_minutes", "in": "query", "required": false, "schema": { "type": "integer", "default": 5, "title": "Window Minutes" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Launch Radar Api V1 X402 Tools Launch Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/launch_intel": { "post": { "tags": [ "x402-facade", "x402-market-tools" ], "summary": "Launch Intel", "description": "Token launch intelligence.", "operationId": "launch_intel_api_v1_x402_tools_launch_intel_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Launch Intel Api V1 X402 Tools Launch Intel Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/anomaly": { "post": { "tags": [ "x402-facade", "x402-market-tools" ], "summary": "Anomaly Detector", "description": "Market anomaly detector.", "operationId": "anomaly_detector_api_v1_x402_tools_anomaly_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Anomaly Detector Api V1 X402 Tools Anomaly Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/market_overview": { "post": { "tags": [ "x402-facade", "x402-market-tools" ], "summary": "Market Overview", "description": "Comprehensive market overview.", "operationId": "market_overview_api_v1_x402_tools_market_overview_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Market Overview Api V1 X402 Tools Market Overview Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/chain_health": { "post": { "tags": [ "x402-facade", "x402-market-tools" ], "summary": "Chain Health", "description": "Chain health metrics.", "operationId": "chain_health_api_v1_x402_tools_chain_health_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Chain Health Api V1 X402 Tools Chain Health Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/defi_yield_scanner": { "post": { "tags": [ "x402-facade", "x402-market-tools" ], "summary": "Defi Yield Scanner", "description": "DeFi yield scanner.", "operationId": "defi_yield_scanner_api_v1_x402_tools_defi_yield_scanner_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Defi Yield Scanner Api V1 X402 Tools Defi Yield Scanner Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/gas_forecast": { "post": { "tags": [ "x402-facade", "x402-market-tools" ], "summary": "Gas Forecast", "description": "Gas price forecast.", "operationId": "gas_forecast_api_v1_x402_tools_gas_forecast_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Gas Forecast Api V1 X402 Tools Gas Forecast Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/sniper_alert": { "post": { "tags": [ "x402-facade", "x402-market-tools" ], "summary": "Sniper Alert", "description": "Sniper bot detection.", "operationId": "sniper_alert_api_v1_x402_tools_sniper_alert_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Sniper Alert Api V1 X402 Tools Sniper Alert Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/airdrop_finder": { "post": { "tags": [ "x402-facade", "x402-market-tools" ], "summary": "Airdrop Finder", "description": "Airdrop opportunity finder.", "operationId": "airdrop_finder_api_v1_x402_tools_airdrop_finder_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Airdrop Finder Api V1 X402 Tools Airdrop Finder Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/mev_protection": { "post": { "tags": [ "x402-facade", "x402-market-tools" ], "summary": "Mev Protection", "description": "MEV protection analysis.", "operationId": "mev_protection_api_v1_x402_tools_mev_protection_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Mev Protection Api V1 X402 Tools Mev Protection Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/sentiment": { "post": { "tags": [ "x402-facade", "x402-analysis-tools" ], "summary": "Social Sentiment", "description": "Social signal analysis across Twitter, Telegram, RSS feeds.", "operationId": "social_sentiment_api_v1_x402_tools_sentiment_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentimentRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Social Sentiment Api V1 X402 Tools Sentiment Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/urlcheck": { "post": { "tags": [ "x402-facade", "x402-analysis-tools" ], "summary": "Url Scam Detector", "description": "URL scam analysis - structural analysis, no blacklists needed.", "operationId": "url_scam_detector_api_v1_x402_tools_urlcheck_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/URLRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Url Scam Detector Api V1 X402 Tools Urlcheck Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/tw_profile": { "post": { "tags": [ "x402-facade", "x402-analysis-tools" ], "summary": "Twitter Profile", "description": "Twitter/X profile lookup.", "operationId": "twitter_profile_api_v1_x402_tools_tw_profile_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Twitter Profile Api V1 X402 Tools Tw Profile Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/tw_timeline": { "post": { "tags": [ "x402-facade", "x402-analysis-tools" ], "summary": "Twitter Timeline", "description": "Get recent tweets from a user.", "operationId": "twitter_timeline_api_v1_x402_tools_tw_timeline_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Twitter Timeline Api V1 X402 Tools Tw Timeline Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/tw_search": { "post": { "tags": [ "x402-facade", "x402-analysis-tools" ], "summary": "Twitter Search", "description": "Search Twitter/X for tweets.", "operationId": "twitter_search_api_v1_x402_tools_tw_search_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Twitter Search Api V1 X402 Tools Tw Search Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/social_signal": { "post": { "tags": [ "x402-facade", "x402-analysis-tools" ], "summary": "Social Signal", "description": "Social signal analyzer.", "operationId": "social_signal_api_v1_x402_tools_social_signal_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Social Signal Api V1 X402 Tools Social Signal Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/nft_wash_detector": { "post": { "tags": [ "x402-facade", "x402-analysis-tools" ], "summary": "Nft Wash Detector", "description": "NFT wash trading detector.", "operationId": "nft_wash_detector_api_v1_x402_tools_nft_wash_detector_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Nft Wash Detector Api V1 X402 Tools Nft Wash Detector Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/bridge_security": { "post": { "tags": [ "x402-facade", "x402-analysis-tools" ], "summary": "Bridge Security", "description": "Bridge security monitoring.", "operationId": "bridge_security_api_v1_x402_tools_bridge_security_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Bridge Security Api V1 X402 Tools Bridge Security Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/sentinel_scan": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Sentinel Full Scan", "description": "Full SENTINEL deep scan - all 9 modules in parallel with graceful degradation.\n\nPricing: $0.15 - the most comprehensive token security scan available.\nReturns composite risk score (0-100), per-module breakdown, and aggregated red flags.", "operationId": "sentinel_full_scan_api_v1_x402_tools_sentinel_scan_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelScanRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Sentinel Full Scan Api V1 X402 Tools Sentinel Scan Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/holder_analysis": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Holder Analysis Endpoint", "description": "SENTINEL Holder Analysis - HHI concentration, fake diversification detection.\n\nPricing: $0.05", "operationId": "holder_analysis_endpoint_api_v1_x402_tools_holder_analysis_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Holder Analysis Endpoint Api V1 X402 Tools Holder Analysis Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/bundle_detect": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Bundle Detect Endpoint", "description": "SENTINEL Bundle Detection - enhanced bundle/sniper detection, funding chain analysis.\n\nPricing: $0.08", "operationId": "bundle_detect_endpoint_api_v1_x402_tools_bundle_detect_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Bundle Detect Endpoint Api V1 X402 Tools Bundle Detect Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/exchange_fund_check": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Exchange Fund Check Endpoint", "description": "SENTINEL Exchange Funder Check - CEX-funded wallet detection for token buyers.\n\nPricing: $0.05", "operationId": "exchange_fund_check_endpoint_api_v1_x402_tools_exchange_fund_check_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Exchange Fund Check Endpoint Api V1 X402 Tools Exchange Fund Check Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/liquidity_verify": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Liquidity Verify Endpoint", "description": "SENTINEL Liquidity Verification - lock verification, fake locker detection, expiry monitoring.\n\nPricing: $0.05", "operationId": "liquidity_verify_endpoint_api_v1_x402_tools_liquidity_verify_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Liquidity Verify Endpoint Api V1 X402 Tools Liquidity Verify Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/dev_reputation": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Dev Reputation Endpoint", "description": "SENTINEL Dev Reputation - serial rugg detection, cross-chain dev tracking.\n\nPricing: $0.08\nRequires dev_address (deployer/creator wallet). Falls back to address if dev_address not provided.", "operationId": "dev_reputation_endpoint_api_v1_x402_tools_dev_reputation_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Dev Reputation Endpoint Api V1 X402 Tools Dev Reputation Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/wash_trading": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Wash Trading Endpoint", "description": "SENTINEL Wash Trading Detection - circular transfer detection, cross-DEX loop analysis.\n\nPricing: $0.08", "operationId": "wash_trading_endpoint_api_v1_x402_tools_wash_trading_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Wash Trading Endpoint Api V1 X402 Tools Wash Trading Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/social_engineering": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Social Engineering Endpoint", "description": "SENTINEL Social Engineering & Identity Fraud Detection.\n\nDetects fake teams, AI-generated profiles, phishing domains,\ncopied whitepapers, and social engineering campaigns.\n\nPricing: $0.15", "operationId": "social_engineering_endpoint_api_v1_x402_tools_social_engineering_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Social Engineering Endpoint Api V1 X402 Tools Social Engineering Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/metadata_fingerprint": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Metadata Fingerprint Endpoint", "description": "SENTINEL Metadata Fingerprint - HTML structure hashing, description similarity, social overlap detection.\n\nPricing: $0.05", "operationId": "metadata_fingerprint_endpoint_api_v1_x402_tools_metadata_fingerprint_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Metadata Fingerprint Endpoint Api V1 X402 Tools Metadata Fingerprint Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/sentiment_check": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Sentiment Check Endpoint", "description": "SENTINEL Sentiment Check - social sentiment scoring, bot campaign detection, pump probability.\n\nPricing: $0.05", "operationId": "sentiment_check_endpoint_api_v1_x402_tools_sentiment_check_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Sentiment Check Endpoint Api V1 X402 Tools Sentiment Check Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/pumpfun_analysis": { "post": { "tags": [ "x402-facade", "x402-sentinel-t1" ], "summary": "Pumpfun Analysis Endpoint", "description": "SENTINEL PumpFun Analysis - bonding curve progress, bot detection, graduation probability (Solana only).\n\nPricing: $0.08\nOnly works for Solana tokens. Returns error for other chains.", "operationId": "pumpfun_analysis_endpoint_api_v1_x402_tools_pumpfun_analysis_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Pumpfun Analysis Endpoint Api V1 X402 Tools Pumpfun Analysis Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/flash_loan_detect": { "post": { "tags": [ "x402-facade", "x402-sentinel-t2-t3" ], "summary": "Flash Loan Detect Endpoint", "description": "SENTINEL Flash Loan Detection - borrow-then-dump patterns, single-block exploits.\n\nPricing: $0.08\nDetects wallet activity that matches flash loan attack patterns:\nlarge buy/sell in consecutive blocks, near-zero pre-trade balance,\nvolume exceeding pool liquidity ratio.", "operationId": "flash_loan_detect_endpoint_api_v1_x402_tools_flash_loan_detect_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Flash Loan Detect Endpoint Api V1 X402 Tools Flash Loan Detect Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/pump_dump_detect": { "post": { "tags": [ "x402-facade", "x402-sentinel-t2-t3" ], "summary": "Pump Dump Detect Endpoint", "description": "SENTINEL Pump-and-Dump Detection - volume spikes, coordinated buys, lifecycle stage.\n\nPricing: $0.08\nDetects pump-and-dump patterns: sudden volume spikes (>5x average),\ncoordinated fresh-wallet buy clusters, price-volume divergence,\nand rug pull lifecycle stage (deploy/pump/distribution/dump).", "operationId": "pump_dump_detect_endpoint_api_v1_x402_tools_pump_dump_detect_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Pump Dump Detect Endpoint Api V1 X402 Tools Pump Dump Detect Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/oracle_manipulation": { "post": { "tags": [ "x402-facade", "x402-sentinel-t2-t3" ], "summary": "Oracle Manipulation Endpoint", "description": "SENTINEL Oracle Manipulation - oracle source analysis, price manipulation vulnerability.\n\nPricing: $0.08\nAnalyzes oracle risk: single-source dependency, pool depth vulnerability,\nDEX-vs-oracle price deviation, and overall manipulable score.\nCritical for lending/borrowing protocols that rely on price feeds.", "operationId": "oracle_manipulation_endpoint_api_v1_x402_tools_oracle_manipulation_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Oracle Manipulation Endpoint Api V1 X402 Tools Oracle Manipulation Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/governance_attack": { "post": { "tags": [ "x402-facade", "x402-sentinel-t2-t3" ], "summary": "Governance Attack Endpoint", "description": "x402 Governance Attack - governance concentration, timelock/quorum risk detection.\n\nPricing: $0.08 (x402 tool #44)\nDetects governance risks: top holder dominance (>50%), missing timelock,\nlow quorum thresholds enabling flash-loan governance attacks,\nand admin key concentration on Solana programs.\n\nStandalone module: app/governance_attack_detector.py", "operationId": "governance_attack_endpoint_api_v1_x402_tools_governance_attack_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Governance Attack Endpoint Api V1 X402 Tools Governance Attack Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/proxy_detect": { "post": { "tags": [ "x402-facade", "x402-sentinel-t2-t3" ], "summary": "Proxy Detect Endpoint", "description": "SENTINEL Proxy Detection - proxy resolution, implementation fingerprinting, upgrade risk.\n\nPricing: $0.08\nResolves proxy contracts to their real implementation, checks upgrade authority\nand timelock status, and fingerprints implementation bytecode against known\nrug contract patterns. Essential for EVM tokens behind proxies.", "operationId": "proxy_detect_endpoint_api_v1_x402_tools_proxy_detect_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Proxy Detect Endpoint Api V1 X402 Tools Proxy Detect Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/static_analysis": { "post": { "tags": [ "x402-facade", "x402-sentinel-t2-t3" ], "summary": "Static Analysis Endpoint", "description": "SENTINEL Static Analysis - Slither vulnerability detection + Forta alert integration.\n\nPricing: $0.12\nRuns Slither static analysis on verified (or Heimdall-decompiled) contracts\nand queries Forta public alerts for the address. Returns vulnerability findings\nand active threat alerts.", "operationId": "static_analysis_endpoint_api_v1_x402_tools_static_analysis_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Static Analysis Endpoint Api V1 X402 Tools Static Analysis Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/decompiler_analysis": { "post": { "tags": [ "x402-facade", "x402-sentinel-t2-t3" ], "summary": "Decompiler Analysis Endpoint", "description": "SENTINEL Decompiler Analysis - Heimdall decompilation + whatsABI function extraction.\n\nPricing: $0.10\nDecompiles unverified contract bytecode using Heimdall-rs, extracts function\nselectors via PUSH4 scanning, and identifies dangerous rug-pull function signatures.\nEssential for tokens with unverified source code.", "operationId": "decompiler_analysis_endpoint_api_v1_x402_tools_decompiler_analysis_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Decompiler Analysis Endpoint Api V1 X402 Tools Decompiler Analysis Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/fund_flow": { "post": { "tags": [ "x402-facade", "x402-sentinel-t2-t3" ], "summary": "Fund Flow Endpoint", "description": "SENTINEL Fund Flow Visualization - SVG fund flow graph for token analysis.\nPricing: $0.10", "operationId": "fund_flow_endpoint_api_v1_x402_tools_fund_flow_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Fund Flow Endpoint Api V1 X402 Tools Fund Flow Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/contract_diff": { "post": { "tags": [ "x402-facade", "x402-sentinel-t2-t3" ], "summary": "Contract Diff Endpoint", "description": "SENTINEL Contract Diff - bytecode hash comparison against known rug contracts.\n\nPricing: $0.10\nCompares a token's contract bytecode against a database of known rug contracts.\nDetects clones, forks, and near-identical contracts by hashing function selectors,\nbytecode sections, and metadata patterns. Identifies dangerous function signatures\n(withdrawAll, drain, setOwner, emergencyWithdraw) and rug-specific bytecode patterns.", "operationId": "contract_diff_endpoint_api_v1_x402_tools_contract_diff_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Contract Diff Endpoint Api V1 X402 Tools Contract Diff Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/address_labels": { "post": { "tags": [ "x402-facade", "x402-labels" ], "summary": "Address Labels Endpoint", "description": "SENTINEL Address Labels - multi-source wallet address labeling.\n\nPricing: $0.08\nResolves any address across Etherscan labels, RolodETH, walletLabels.xyz,\nbluepages.fyi, and internal RAG. Returns unified labels (exchange, MEV bot,\nknown scammer, deployer, etc.).", "operationId": "address_labels_endpoint_api_v1_x402_tools_address_labels_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SentinelModuleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Address Labels Endpoint Api V1 X402 Tools Address Labels Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/discovery": { "get": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Tools Discovery", "description": "Human-friendly tool discovery - organized by category with SEO descriptions.", "operationId": "tools_discovery_api_v1_x402_tools_discovery_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Tools Discovery Api V1 X402 Tools Discovery Get" } } } } } } }, "/api/v1/x402-tools/catalog": { "get": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Tools Catalog Bot", "description": "Bot-optimized tool catalog - flat list with IDs, pricing, chain support.", "operationId": "tools_catalog_bot_api_v1_x402_tools_catalog_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Tools Catalog Bot Api V1 X402 Tools Catalog Get" } } } } } } }, "/api/v1/x402-tools/openai-tools": { "get": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Openai Tools", "description": "Returns ALL 201+ tool definitions in OpenAI function calling format.", "operationId": "openai_tools_api_v1_x402_tools_openai_tools_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Openai Tools Api V1 X402 Tools Openai Tools Get" } } } } } } }, "/api/v1/x402-tools/langchain-tools": { "get": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Langchain Tools", "description": "Returns ALL 201+ tool definitions in LangChain format.", "operationId": "langchain_tools_api_v1_x402_tools_langchain_tools_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Langchain Tools Api V1 X402 Tools Langchain Tools Get" } } } } } } }, "/api/v1/x402-tools/anthropic-tools": { "get": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Anthropic Tools", "description": "Returns ALL 201+ tool definitions in Anthropic Claude API format.", "operationId": "anthropic_tools_api_v1_x402_tools_anthropic_tools_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Anthropic Tools Api V1 X402 Tools Anthropic Tools Get" } } } } } } }, "/api/v1/x402-tools/gemini-tools": { "get": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Gemini Tools", "description": "Returns ALL 201+ tool definitions in Google Gemini function calling format.", "operationId": "gemini_tools_api_v1_x402_tools_gemini_tools_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Gemini Tools Api V1 X402 Tools Gemini Tools Get" } } } } } } }, "/api/v1/x402-tools/frameworks": { "get": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Framework Discovery", "description": "Returns all available framework integrations with endpoints.", "operationId": "framework_discovery_api_v1_x402_tools_frameworks_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Framework Discovery Api V1 X402 Tools Frameworks Get" } } } } } } }, "/api/v1/x402-tools/mcp-proxy": { "post": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Mcp Proxy", "description": "Proxy MCP tool calls from Cloudflare Workers to external APIs.", "operationId": "mcp_proxy_api_v1_x402_tools_mcp_proxy_post", "parameters": [ { "name": "req", "in": "query", "required": true, "schema": { "title": "Req" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Mcp Proxy Api V1 X402 Tools Mcp Proxy Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/bundles": { "get": { "tags": [ "x402-facade", "x402-integration" ], "summary": "List Bundles", "description": "List all available tool bundles with pricing and savings.", "operationId": "list_bundles_api_v1_x402_tools_bundles_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "additionalProperties": true, "type": "object" }, "type": "object", "title": "Response List Bundles Api V1 X402 Tools Bundles Get" } } } } } } }, "/api/v1/x402-tools/bundles/security_pack": { "post": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Bundle Security Pack", "description": "Security Pack: rugshield + audit + urlcheck + honeypot_check at 23% discount.", "operationId": "bundle_security_pack_api_v1_x402_tools_bundles_security_pack_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BundleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Bundle Security Pack Api V1 X402 Tools Bundles Security Pack Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/bundles/intelligence_pack": { "post": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Bundle Intelligence Pack", "description": "Intelligence Pack: whale + smartmoney + cluster + insider at 29% discount.", "operationId": "bundle_intelligence_pack_api_v1_x402_tools_bundles_intelligence_pack_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BundleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Bundle Intelligence Pack Api V1 X402 Tools Bundles Intelligence Pack Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/bundles/all_in_one": { "post": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Bundle All In One", "description": "All-in-One: comprehensive_audit + smart_money_alpha + meme_vibe_score at 30% discount.", "operationId": "bundle_all_in_one_api_v1_x402_tools_bundles_all_in_one_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BundleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Bundle All In One Api V1 X402 Tools Bundles All In One Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/forensic_pack": { "post": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Bundle Forensic Pack", "description": "Forensic Investigation Pack \u2014 valuation + OSINT + report at 33% discount.", "operationId": "bundle_forensic_pack_api_v1_x402_tools_forensic_pack_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BundleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Bundle Forensic Pack Api V1 X402 Tools Forensic Pack Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/{tool_id}": { "get": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Tool Alias Dispatcher Get", "description": "GET catch-all for paid tools \u2014 converts query params to JSON body and dispatches.", "operationId": "tool_alias_dispatcher_get_api_v1_x402_tools__tool_id__get", "parameters": [ { "name": "tool_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Tool Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Tool Alias Dispatcher Get Api V1 X402 Tools Tool Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Tool Alias Dispatcher", "description": "Catch-all dispatcher for tool aliases and per-chain variants.\n\nHandles three cases:\n1. Named aliases (scam_database -> urlcheck)\n2. Per-chain variants (wallet_solana -> wallet with chain=solana)\n3. Expanded tools (flash_loan_detect -> closest real handler)\n\nReturns 404 for truly unknown tools.", "operationId": "tool_alias_dispatcher_api_v1_x402_tools__tool_id__post", "parameters": [ { "name": "tool_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Tool Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Tool Alias Dispatcher Api V1 X402 Tools Tool Id Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/payment-methods": { "get": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Get Payment Methods", "description": "List all payment methods available for human wallet payments.", "operationId": "get_payment_methods_api_v1_x402_tools_payment_methods_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Payment Methods Api V1 X402 Tools Payment Methods Get" } } } } } } }, "/api/v1/x402-tools/human-execute": { "post": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Human Execute", "description": "Execute a tool after human wallet payment verification.\n\nMulti-chain: Base, Solana, Ethereum, BSC, Polygon, Arbitrum, TRON, Bitcoin, SEPA/EUR.", "operationId": "human_execute_api_v1_x402_tools_human_execute_post", "parameters": [ { "name": "req", "in": "query", "required": true, "schema": { "title": "Req" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Human Execute Api V1 X402 Tools Human Execute Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/comprehensive_audit": { "post": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Comprehensive Audit", "description": "One-call deep audit combining rug check, forensics, social, and whale analysis.", "operationId": "comprehensive_audit_api_v1_x402_tools_comprehensive_audit_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Comprehensive Audit Api V1 X402 Tools Comprehensive Audit Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/smart_money_alpha": { "post": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Smart Money Alpha", "description": "One-call smart money signal combining wallet analysis, smart money tracking, and cluster/sybil detection.", "operationId": "smart_money_alpha_api_v1_x402_tools_smart_money_alpha_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SmartMoneyAlphaRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Smart Money Alpha Api V1 X402 Tools Smart Money Alpha Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/x402-tools/meme_vibe_score": { "post": { "tags": [ "x402-facade", "x402-integration" ], "summary": "Meme Vibe Score", "description": "One-call meme token vibe check combining sentiment, social signals, and launch analysis.", "operationId": "meme_vibe_score_api_v1_x402_tools_meme_vibe_score_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemeVibeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Meme Vibe Score Api V1 X402 Tools Meme Vibe Score Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/auth/login": { "post": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Login", "description": "Admin login \u2014 returns session token.", "operationId": "login_api_v1_admin_backend_auth_login_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Login Api V1 Admin Backend Auth Login Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/auth/me": { "get": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Me", "description": "Get current admin info.", "operationId": "me_api_v1_admin_backend_auth_me_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Me Api V1 Admin Backend Auth Me Get" } } } } } } }, "/api/v1/admin/backend/dashboard": { "get": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Dashboard", "description": "Dashboard overview \u2014 stats + health summary.", "operationId": "dashboard_api_v1_admin_backend_dashboard_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Dashboard Api V1 Admin Backend Dashboard Get" } } } } } } }, "/api/v1/admin/backend/system/health": { "get": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "System Health", "description": "Full system health report.", "operationId": "system_health_api_v1_admin_backend_system_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response System Health Api V1 Admin Backend System Health Get" } } } } } } }, "/api/v1/admin/backend/users": { "get": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "List Users", "description": "List bot users.", "operationId": "list_users_api_v1_admin_backend_users_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 100, "title": "Limit" } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 100, "default": "", "title": "Search" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response List Users Api V1 Admin Backend Users Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/users/{user_id}/ban": { "post": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Ban User", "description": "Ban a bot user.", "operationId": "ban_user_api_v1_admin_backend_users__user_id__ban_post", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "User Id" } } ], "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/BanUserRequest" }, { "type": "null" } ], "title": "Req" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Ban User Api V1 Admin Backend Users User Id Ban Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/security/blocked-ips": { "get": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Blocked Ips", "description": "List all blocked IPs.", "operationId": "blocked_ips_api_v1_admin_backend_security_blocked_ips_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Blocked Ips Api V1 Admin Backend Security Blocked Ips Get" } } } } } } }, "/api/v1/admin/backend/security/block-ip": { "post": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Block Ip", "description": "Block an IP address.", "operationId": "block_ip_api_v1_admin_backend_security_block_ip_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BlockIPRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Block Ip Api V1 Admin Backend Security Block Ip Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/security/unblock-ip": { "post": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Unblock Ip", "description": "Unblock an IP address.", "operationId": "unblock_ip_api_v1_admin_backend_security_unblock_ip_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnblockIPRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Unblock Ip Api V1 Admin Backend Security Unblock Ip Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/security/audit-logs": { "get": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Audit Logs", "description": "Query audit logs.", "operationId": "audit_logs_api_v1_admin_backend_security_audit_logs_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Audit Logs Api V1 Admin Backend Security Audit Logs Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/admins": { "get": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "List Admins", "description": "List all admin users.", "operationId": "list_admins_api_v1_admin_backend_admins_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Admins Api V1 Admin Backend Admins Get" } } } } } }, "post": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Create Admin", "description": "Create a new admin user.", "operationId": "create_admin_api_v1_admin_backend_admins_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAdminRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Admin Api V1 Admin Backend Admins Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/api-keys": { "get": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "List Api Keys", "description": "List all API keys.", "operationId": "list_api_keys_api_v1_admin_backend_api_keys_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Api Keys Api V1 Admin Backend Api Keys Get" } } } } } }, "post": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Create Api Key", "description": "Create a new API key.", "operationId": "create_api_key_api_v1_admin_backend_api_keys_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAPIKeyRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Api Key Api V1 Admin Backend Api Keys Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/api-keys/{key_id}/revoke": { "post": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Revoke Api Key", "description": "Revoke an API key.", "operationId": "revoke_api_key_api_v1_admin_backend_api_keys__key_id__revoke_post", "parameters": [ { "name": "key_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Key Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Revoke Api Key Api V1 Admin Backend Api Keys Key Id Revoke Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/webhooks": { "get": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "List Webhooks", "description": "List all webhooks.", "operationId": "list_webhooks_api_v1_admin_backend_webhooks_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Webhooks Api V1 Admin Backend Webhooks Get" } } } } } }, "post": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Create Webhook", "description": "Create a new webhook.", "operationId": "create_webhook_api_v1_admin_backend_webhooks_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__admin__backend__CreateWebhookRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Webhook Api V1 Admin Backend Webhooks Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/backend/content/announcements": { "get": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "List Announcements", "description": "List announcements.", "operationId": "list_announcements_api_v1_admin_backend_content_announcements_get", "parameters": [ { "name": "active_only", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Active Only" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response List Announcements Api V1 Admin Backend Content Announcements Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "admin-extensions", "admin-backend" ], "summary": "Create Announcement", "description": "Create an announcement.", "operationId": "create_announcement_api_v1_admin_backend_content_announcements_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnnouncementRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Create Announcement Api V1 Admin Backend Content Announcements Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/telegram/stats": { "get": { "tags": [ "admin-extensions" ], "summary": "Telegram Stats", "description": "Get Telegram bot statistics.", "operationId": "telegram_stats_api_v1_admin_telegram_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Telegram Stats Api V1 Admin Telegram Stats Get" } } } } } } }, "/api/v1/admin/telegram/users": { "get": { "tags": [ "admin-extensions" ], "summary": "Telegram Users", "description": "Get Telegram bot users.", "operationId": "telegram_users_api_v1_admin_telegram_users_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Telegram Users Api V1 Admin Telegram Users Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/telegram/messages": { "get": { "tags": [ "admin-extensions" ], "summary": "Telegram Messages", "description": "Get recent Telegram messages.", "operationId": "telegram_messages_api_v1_admin_telegram_messages_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Telegram Messages Api V1 Admin Telegram Messages Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/telegram/send": { "post": { "tags": [ "admin-extensions" ], "summary": "Telegram Send", "description": "Send a message via Telegram bot.", "operationId": "telegram_send_api_v1_admin_telegram_send_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TelegramSendRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Telegram Send Api V1 Admin Telegram Send Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/telegram/broadcast": { "post": { "tags": [ "admin-extensions" ], "summary": "Telegram Broadcast", "description": "Broadcast a message to all Telegram bot users.", "operationId": "telegram_broadcast_api_v1_admin_telegram_broadcast_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TelegramBroadcastRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Telegram Broadcast Api V1 Admin Telegram Broadcast Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/content/drafts": { "get": { "tags": [ "admin-extensions" ], "summary": "Ghost Drafts", "description": "Get Ghost drafts.", "operationId": "ghost_drafts_api_v1_admin_content_drafts_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": { "type": "array", "items": {} } }, { "type": "object", "additionalProperties": true } ], "title": "Response Ghost Drafts Api V1 Admin Content Drafts Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/content/tags": { "get": { "tags": [ "admin-extensions" ], "summary": "Ghost Tags", "description": "Get Ghost tags.", "operationId": "ghost_tags_api_v1_admin_content_tags_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "additionalProperties": { "items": {}, "type": "array" }, "type": "object" }, { "additionalProperties": true, "type": "object" } ], "title": "Response Ghost Tags Api V1 Admin Content Tags Get" } } } } } } }, "/api/v1/admin/content/analytics": { "get": { "tags": [ "admin-extensions" ], "summary": "Ghost Analytics", "description": "Get Ghost analytics computed from local data.", "operationId": "ghost_analytics_api_v1_admin_content_analytics_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "additionalProperties": { "type": "string" }, "type": "object" } ], "title": "Response Ghost Analytics Api V1 Admin Content Analytics Get" } } } } } } }, "/api/v1/admin/content/post/{post_id}/publish": { "post": { "tags": [ "admin-extensions" ], "summary": "Ghost Publish", "description": "Publish a Ghost draft post.", "operationId": "ghost_publish_api_v1_admin_content_post__post_id__publish_post", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": { "type": "string" } }, { "type": "object", "additionalProperties": { "type": "boolean" } } ], "title": "Response Ghost Publish Api V1 Admin Content Post Post Id Publish Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/cron/jobs": { "get": { "tags": [ "admin-extensions" ], "summary": "Cron Jobs", "description": "List all Hermes cron jobs.", "operationId": "cron_jobs_api_v1_admin_cron_jobs_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Cron Jobs Api V1 Admin Cron Jobs Get" } } } } } } }, "/api/v1/admin/cron/logs": { "get": { "tags": [ "admin-extensions" ], "summary": "Cron Logs", "description": "Get cron execution logs.", "operationId": "cron_logs_api_v1_admin_cron_logs_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Cron Logs Api V1 Admin Cron Logs Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/cron/{job_id}/run": { "post": { "tags": [ "admin-extensions" ], "summary": "Cron Run", "description": "Trigger a cron job manually.", "operationId": "cron_run_api_v1_admin_cron__job_id__run_post", "parameters": [ { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Job Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Cron Run Api V1 Admin Cron Job Id Run Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/cron/{job_id}/pause": { "post": { "tags": [ "admin-extensions" ], "summary": "Cron Pause", "description": "Pause a cron job.", "operationId": "cron_pause_api_v1_admin_cron__job_id__pause_post", "parameters": [ { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Job Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Cron Pause Api V1 Admin Cron Job Id Pause Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/cron/{job_id}/resume": { "post": { "tags": [ "admin-extensions" ], "summary": "Cron Resume", "description": "Resume a cron job.", "operationId": "cron_resume_api_v1_admin_cron__job_id__resume_post", "parameters": [ { "name": "job_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Job Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Cron Resume Api V1 Admin Cron Job Id Resume Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/dify/status": { "get": { "tags": [ "admin-extensions" ], "summary": "Dify Status", "description": "Check Dify AI advisor status.", "operationId": "dify_status_api_v1_admin_dify_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, {} ], "title": "Response Dify Status Api V1 Admin Dify Status Get" } } } } } } }, "/api/v1/admin/dify/conversations": { "get": { "tags": [ "admin-extensions" ], "summary": "Dify Conversations", "description": "Get Dify conversation list.", "operationId": "dify_conversations_api_v1_admin_dify_conversations_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": { "type": "array", "items": {} } }, { "type": "object", "additionalProperties": true } ], "title": "Response Dify Conversations Api V1 Admin Dify Conversations Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/dify/apps": { "get": { "tags": [ "admin-extensions" ], "summary": "Dify Apps", "description": "Get Dify apps list.", "operationId": "dify_apps_api_v1_admin_dify_apps_get", "parameters": [ { "name": "use_proxy", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Use Proxy" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": { "type": "array", "items": {} } }, { "type": "object", "additionalProperties": { "anyOf": [ {}, { "type": "null" } ] } }, {} ], "title": "Response Dify Apps Api V1 Admin Dify Apps Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/dify/conversations/{conversation_id}/messages": { "get": { "tags": [ "admin-extensions" ], "summary": "Dify Messages", "description": "Get messages for a Dify conversation.", "operationId": "dify_messages_api_v1_admin_dify_conversations__conversation_id__messages_get", "parameters": [ { "name": "conversation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Conversation Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "default": 30, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Dify Messages Api V1 Admin Dify Conversations Conversation Id Messages Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/dify/chat": { "post": { "tags": [ "admin-extensions" ], "summary": "Dify Chat", "description": "Send a chat message to Dify AI advisor.", "operationId": "dify_chat_api_v1_admin_dify_chat_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DifyChatRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "additionalProperties": { "anyOf": [ {}, { "type": "null" } ] }, "type": "object" }, {}, { "additionalProperties": true, "type": "object" } ], "title": "Response Dify Chat Api V1 Admin Dify Chat Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/processes": { "get": { "tags": [ "admin-extensions" ], "summary": "Admin Processes", "description": "Get running processes on the server.", "operationId": "admin_processes_api_v1_admin_processes_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "additionalProperties": { "type": "string" }, "type": "object" } ], "title": "Response Admin Processes Api V1 Admin Processes Get" } } } } } } }, "/api/v1/admin/disk": { "get": { "tags": [ "admin-extensions" ], "summary": "Admin Disk", "description": "Get disk usage information.", "operationId": "admin_disk_api_v1_admin_disk_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "additionalProperties": { "type": "string" }, "type": "object" } ], "title": "Response Admin Disk Api V1 Admin Disk Get" } } } } } } }, "/api/v1/admin/network": { "get": { "tags": [ "admin-extensions" ], "summary": "Admin Network", "description": "Get network I/O statistics.", "operationId": "admin_network_api_v1_admin_network_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "additionalProperties": { "type": "string" }, "type": "object" } ], "title": "Response Admin Network Api V1 Admin Network Get" } } } } } } }, "/api/v1/admin/updates": { "get": { "tags": [ "admin-extensions" ], "summary": "Admin Updates", "description": "Get system update status \u2014 Docker, packages, Python deps, system health.\n\nDelegates to the system-updates-check.sh script and augments with\nreal-time psutil data. No external API calls \u2014 all local checks.", "operationId": "admin_updates_api_v1_admin_updates_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Admin Updates Api V1 Admin Updates Get" } } } } } } }, "/api/v1/admin/mail/sent": { "get": { "tags": [ "admin-extensions" ], "summary": "Mail Sent", "description": "Get recently sent emails.", "operationId": "mail_sent_api_v1_admin_mail_sent_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Mail Sent Api V1 Admin Mail Sent Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/mail/folders": { "get": { "tags": [ "admin-extensions" ], "summary": "Mail Folders", "description": "Get email folders.", "operationId": "mail_folders_api_v1_admin_mail_folders_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Mail Folders Api V1 Admin Mail Folders Get" } } } } } } }, "/api/v1/admin/mail/{msg_id}": { "delete": { "tags": [ "admin-extensions" ], "summary": "Mail Delete", "description": "Delete an email \u2014 requires SMTP sent tracking.", "operationId": "mail_delete_api_v1_admin_mail__msg_id__delete", "parameters": [ { "name": "msg_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Msg Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Mail Delete Api V1 Admin Mail Msg Id Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scrape": { "post": { "tags": [ "pryscraper" ], "summary": "Scrape Url", "description": "Scrape a single URL via the Pry service.\n\nThe Pry container fetches the URL, extracts markdown/text/html, and\nreturns the result. This endpoint proxies that result with consistent\nauth and error handling.", "operationId": "scrape_url_api_v1_scrape_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScrapeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScrapeResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/extract": { "post": { "tags": [ "pryscraper" ], "summary": "Extract Url", "description": "Extract structured data from a URL via the Pry service.", "operationId": "extract_url_api_v1_extract_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtractRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScrapeResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/news/search": { "get": { "tags": [ "pryscraper" ], "summary": "Search News", "description": "Search news articles via the Pry scraper's search capability.", "operationId": "search_news_api_v1_news_search_get", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "description": "Search query", "title": "Q" }, "description": "Search query" }, { "name": "max_results", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 10, "title": "Max Results" } }, { "name": "days_back", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 30, "minimum": 1, "default": 7, "title": "Days Back" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Search News Api V1 News Search Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/pryscraper/health": { "get": { "tags": [ "pryscraper" ], "summary": "Pryscraper Health", "description": "Health check passthrough to the Pry service.", "operationId": "pryscraper_health_api_v1_pryscraper_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Pryscraper Health Api V1 Pryscraper Health Get" } } } } } } }, "/api/v1/pryscraper/stats": { "get": { "tags": [ "pryscraper" ], "summary": "Pryscraper Stats", "description": "Client circuit-breaker statistics.", "operationId": "pryscraper_stats_api_v1_pryscraper_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Pryscraper Stats Api V1 Pryscraper Stats Get" } } } } } } }, "/api/v1/rag/ingest-news": { "post": { "tags": [ "pryscraper" ], "summary": "Ingest News Webhook", "description": "Webhook: ingest a scraped news article into the RAG ``news`` collection.\n\nCalled automatically after Pryscraper scrapes a news article.\nThe article is chunked, embedded, and stored for semantic search.\n\nAuth: JWT or API key required.\nRate limit: 1 req/s burst 5 (token-bucket).", "operationId": "ingest_news_webhook_api_v1_rag_ingest_news_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestNewsRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Ingest News Webhook Api V1 Rag Ingest News Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/degenfeed/protocols": { "get": { "tags": [ "degenfeed" ], "summary": "List Protocols", "description": "List all supported DegenFeed protocols.", "operationId": "list_protocols_api_v1_degenfeed_protocols_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProtocolListResponse" } } } } } } }, "/api/v1/degenfeed/{protocol}/feed": { "get": { "tags": [ "degenfeed" ], "summary": "Get protocol feed", "description": "Fetch a unified feed from the specified protocol. Cached for 60s.", "operationId": "get_feed_api_v1_degenfeed__protocol__feed_get", "parameters": [ { "name": "protocol", "in": "path", "required": true, "schema": { "type": "string", "description": "Protocol name (e.g. farcaster, lens, twitter)", "title": "Protocol" }, "description": "Protocol name (e.g. farcaster, lens, twitter)" }, { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Optional user ID for personalized feed", "default": "", "title": "User Id" }, "description": "Optional user ID for personalized feed" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Page number", "default": 1, "title": "Page" }, "description": "Page number" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/degenfeed/{protocol}/post/{post_id}": { "get": { "tags": [ "degenfeed" ], "summary": "Get a specific post", "description": "Fetch a single post by ID from the specified protocol. Cached for 30s.", "operationId": "get_post_api_v1_degenfeed__protocol__post__post_id__get", "parameters": [ { "name": "protocol", "in": "path", "required": true, "schema": { "type": "string", "description": "Protocol name", "title": "Protocol" }, "description": "Protocol name" }, { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "description": "Post ID on the protocol", "title": "Post Id" }, "description": "Post ID on the protocol" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PostResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/degenfeed/{protocol}/post": { "post": { "tags": [ "degenfeed" ], "summary": "Create a post", "description": "Create a post on the specified protocol. Supports cross-posting to other protocols.", "operationId": "create_post_api_v1_degenfeed__protocol__post_post", "parameters": [ { "name": "protocol", "in": "path", "required": true, "schema": { "type": "string", "description": "Primary protocol to post to", "title": "Protocol" }, "description": "Primary protocol to post to" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__degenfeed_proxy__CreatePostRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Create Post Api V1 Degenfeed Protocol Post Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/degenfeed/identity/{protocol}/{handle}": { "get": { "tags": [ "degenfeed" ], "summary": "Resolve identity", "description": "Resolve a handle/username to an identity on the specified protocol. Cached for 5min.", "operationId": "resolve_identity_api_v1_degenfeed_identity__protocol___handle__get", "parameters": [ { "name": "protocol", "in": "path", "required": true, "schema": { "type": "string", "description": "Protocol name", "title": "Protocol" }, "description": "Protocol name" }, { "name": "handle", "in": "path", "required": true, "schema": { "type": "string", "description": "Username/handle to resolve", "title": "Handle" }, "description": "Username/handle to resolve" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__routers__degenfeed_proxy__IdentityResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/degenfeed/health": { "get": { "tags": [ "degenfeed" ], "summary": "DegenFeed health check", "description": "Health check for DegenFeed proxy, cache, and protocol services.", "operationId": "degenfeed_health_api_v1_degenfeed_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Degenfeed Health Api V1 Degenfeed Health Get" } } } } } } }, "/api/v1/degenfeed/status": { "get": { "tags": [ "degenfeed" ], "summary": "DegenFeed protocol health", "description": "Health status for all DegenFeed protocol services.", "operationId": "protocol_health_api_v1_degenfeed_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Protocol Health Api V1 Degenfeed Status Get" } } } } } } }, "/api/v1/degenfeed/storage/cache/{key}": { "get": { "tags": [ "degenfeed-storage" ], "summary": "Cache Get", "description": "Redis GET \u2014 return { value: string | null }.", "operationId": "cache_get_api_v1_degenfeed_storage_cache__key__get", "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "title": "Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": "Response Cache Get Api V1 Degenfeed Storage Cache Key Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "degenfeed-storage" ], "summary": "Cache Put", "description": "Redis SETEX \u2014 store value with TTL.", "operationId": "cache_put_api_v1_degenfeed_storage_cache__key__put", "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "title": "Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CachePutRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "boolean" }, "title": "Response Cache Put Api V1 Degenfeed Storage Cache Key Put" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "degenfeed-storage" ], "summary": "Cache Delete", "description": "Redis DEL.", "operationId": "cache_delete_api_v1_degenfeed_storage_cache__key__delete", "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "title": "Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "boolean" }, "title": "Response Cache Delete Api V1 Degenfeed Storage Cache Key Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/degenfeed/storage/kv/{namespace}/{key}": { "get": { "tags": [ "degenfeed-storage" ], "summary": "Kv Get", "description": "Postgres read. For api_keys, does a read-through Redis cache first (hot path).", "operationId": "kv_get_api_v1_degenfeed_storage_kv__namespace___key__get", "parameters": [ { "name": "namespace", "in": "path", "required": true, "schema": { "type": "string", "title": "Namespace" } }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "title": "Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": "Response Kv Get Api V1 Degenfeed Storage Kv Namespace Key Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "degenfeed-storage" ], "summary": "Kv Put", "description": "Postgres upsert. Invalidates the Redis cache for api_keys.", "operationId": "kv_put_api_v1_degenfeed_storage_kv__namespace___key__put", "parameters": [ { "name": "namespace", "in": "path", "required": true, "schema": { "type": "string", "title": "Namespace" } }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "title": "Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KvPutRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "boolean" }, "title": "Response Kv Put Api V1 Degenfeed Storage Kv Namespace Key Put" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "degenfeed-storage" ], "summary": "Kv Delete", "description": "Postgres delete. Invalidates the Redis cache for api_keys.", "operationId": "kv_delete_api_v1_degenfeed_storage_kv__namespace___key__delete", "parameters": [ { "name": "namespace", "in": "path", "required": true, "schema": { "type": "string", "title": "Namespace" } }, { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "title": "Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "boolean" }, "title": "Response Kv Delete Api V1 Degenfeed Storage Kv Namespace Key Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rate-limits/report": { "post": { "tags": [ "kv-migration" ], "summary": "Rate Limit Report", "description": "Report an IP+path that is near its rate limit.\n\nStores the count/max pair in Redis with a TTL equal to the reporting\nwindow, so cross-isolate enforcement can read it back on other edges.", "operationId": "rate_limit_report_api_v1_rate_limits_report_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitReport" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rate-limits/batch": { "post": { "tags": [ "kv-migration" ], "summary": "Rate Limit Batch", "description": "Batch-sync rate limit records from worker isolates.\n\nEach entry is stored independently in Redis with the same TTL-based\nexpiration as individual reports. Failures for individual entries\nare logged but do not block the rest of the batch.", "operationId": "rate_limit_batch_api_v1_rate_limits_batch_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitBatchRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/rate-limits/check": { "get": { "tags": [ "kv-migration" ], "summary": "Rate Limit Check", "description": "Return the current rate limit status for an ip+path.", "operationId": "rate_limit_check_api_v1_rate_limits_check_get", "parameters": [ { "name": "ip", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 64, "title": "Ip" } }, { "name": "path", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 512, "title": "Path" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimitStatus" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/queue/enqueue": { "post": { "tags": [ "kv-migration" ], "summary": "Queue Enqueue", "description": "Enqueue a background job for sync, offline, or premium processing.", "operationId": "queue_enqueue_api_v1_queue_enqueue_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnqueueRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnqueueResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/queue/dequeue": { "get": { "tags": [ "kv-migration" ], "summary": "Queue Dequeue", "description": "Dequeue up to N jobs from the front of a queue.", "operationId": "queue_dequeue_api_v1_queue_dequeue_get", "parameters": [ { "name": "queue", "in": "query", "required": true, "schema": { "enum": [ "sync", "offline", "premium", "scheduled", "bridgy:users", "bridgy:config" ], "type": "string", "title": "Queue" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DequeueResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/sessions": { "post": { "tags": [ "kv-migration" ], "summary": "Session Upsert", "description": "Create or upsert a session in Redis with a TTL.", "operationId": "session_upsert_api_v1_sessions_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionPutRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "kv-migration" ], "summary": "Session Get", "description": "Fetch a session by id. Returns empty data when the session is unknown/expired.", "operationId": "session_get_api_v1_sessions_get", "parameters": [ { "name": "session_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 255, "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "kv-migration" ], "summary": "Session Delete", "description": "Delete a session by id.", "operationId": "session_delete_api_v1_sessions_delete", "parameters": [ { "name": "session_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 255, "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat-history": { "post": { "tags": [ "kv-migration" ], "summary": "Chat History Create", "description": "Store a chat message for a room.", "operationId": "chat_history_create_api_v1_chat_history_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatMessageCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatMessageOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "kv-migration" ], "summary": "Chat History List", "description": "List the most recent chat messages for a room (oldest first).", "operationId": "chat_history_list_api_v1_chat_history_get", "parameters": [ { "name": "room_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 255, "title": "Room Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatHistoryResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/identities": { "post": { "tags": [ "kv-migration" ], "summary": "Identity Upsert", "description": "Upsert an identity mapping (address \u2192 JSON blob).", "operationId": "identity_upsert_api_v1_identities_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IdentityPut" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__api__v1__kv_migration__IdentityResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "kv-migration" ], "summary": "Identity Get", "description": "Fetch an identity mapping by address.", "operationId": "identity_get_api_v1_identities_get", "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 255, "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__api__v1__kv_migration__IdentityResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bookmarks": { "post": { "tags": [ "kv-migration" ], "summary": "Bookmark Create", "description": "Add a bookmark for an address. Idempotent \u2014 duplicates are ignored.", "operationId": "bookmark_create_api_v1_bookmarks_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookmarkCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OkResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "kv-migration" ], "summary": "Bookmark List", "description": "List bookmarks for an address (newest first).", "operationId": "bookmark_list_api_v1_bookmarks_get", "parameters": [ { "name": "address", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 255, "title": "Address" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookmarkResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/ai/contract-analysis": { "post": { "tags": [ "ai-analysis" ], "summary": "Contract Analysis", "description": "AI-powered contract analysis with anomaly detection.\n\nAccepts holder/distribution data and scanner results, runs AI analysis\nvia the free remote long config (OpenRouter fallback), and falls back to\nrule-based detection if AI is unavailable.\n\nReturns a comprehensive risk report with identified anomalies and clusters.", "operationId": "contract_analysis_api_v1_ai_contract_analysis_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContractAnalysisRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContractAnalysisResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/ai/ai-health": { "get": { "tags": [ "ai-analysis" ], "summary": "Ai Analysis Health", "description": "Check AI analysis availability across all providers.", "operationId": "ai_analysis_health_api_v1_ai_ai_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Ai Analysis Health Api V1 Ai Ai Health Get" } } } } } } }, "/api/v1/live/battles/request": { "post": { "tags": [ "live" ], "summary": "Challenge another creator to a battle", "description": "Send a battle challenge to another creator.", "operationId": "post_battle_request_api_v1_live_battles_request_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BattleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Post Battle Request Api V1 Live Battles Request Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/battles/accept": { "post": { "tags": [ "live" ], "summary": "Accept a battle challenge", "description": "Accept a pending battle and start it.", "operationId": "post_battle_accept_api_v1_live_battles_accept_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BattleAccept" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Post Battle Accept Api V1 Live Battles Accept Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/battles/{battle_id}/gift": { "post": { "tags": [ "live" ], "summary": "Send a gift during a battle", "description": "Send a gift that converts to battle points.", "operationId": "post_battle_gift_api_v1_live_battles__battle_id__gift_post", "parameters": [ { "name": "battle_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Battle Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BattleGiftSend" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Post Battle Gift Api V1 Live Battles Battle Id Gift Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/battles/{battle_id}/end": { "post": { "tags": [ "live" ], "summary": "End a battle", "description": "End a battle and declare the winner.", "operationId": "post_battle_end_api_v1_live_battles__battle_id__end_post", "parameters": [ { "name": "battle_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Battle Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Post Battle End Api V1 Live Battles Battle Id End Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/battles/{battle_id}": { "get": { "tags": [ "live" ], "summary": "Get battle state and real-time score", "description": "Get real-time battle scores and state.", "operationId": "get_battle_api_v1_live_battles__battle_id__get", "parameters": [ { "name": "battle_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Battle Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Battle Api V1 Live Battles Battle Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/battles/history": { "get": { "tags": [ "live" ], "summary": "Get battle history", "description": "Get current user's battle history.", "operationId": "get_history_api_v1_live_battles_history_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get History Api V1 Live Battles History Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/battles/record": { "get": { "tags": [ "live" ], "summary": "Get win/loss record", "description": "Get current user's battle win/loss record.", "operationId": "get_record_api_v1_live_battles_record_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Record Api V1 Live Battles Record Get" } } } } } } }, "/api/v1/live/battles/active": { "get": { "tags": [ "live" ], "summary": "Get my active battle", "description": "Get the current live battle for the user.", "operationId": "get_active_battle_api_v1_live_battles_active_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Active Battle Api V1 Live Battles Active Get" } } } } } } }, "/api/v1/live/viewers/me/xp": { "get": { "tags": [ "live" ], "summary": "Get my XP and level", "description": "Get current user's XP, level, and next level progress.", "operationId": "get_my_xp_api_v1_live_viewers_me_xp_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get My Xp Api V1 Live Viewers Me Xp Get" } } } } } } }, "/api/v1/live/viewers/me/transactions": { "get": { "tags": [ "live" ], "summary": "Get my XP transactions", "description": "Get recent XP earning transactions.", "operationId": "get_my_xp_transactions_api_v1_live_viewers_me_transactions_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get My Xp Transactions Api V1 Live Viewers Me Transactions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/viewers/xp/award": { "post": { "tags": [ "live" ], "summary": "Award XP to a user", "description": "Award XP for watching, chatting, gifting, or sharing.", "operationId": "post_award_xp_api_v1_live_viewers_xp_award_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AwardXPRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Post Award Xp Api V1 Live Viewers Xp Award Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/viewers/leaderboard": { "get": { "tags": [ "live" ], "summary": "Viewer XP leaderboard", "description": "Get the global XP leaderboard.", "operationId": "get_viewer_leaderboard_api_v1_live_viewers_leaderboard_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Viewer Leaderboard Api V1 Live Viewers Leaderboard Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/challenges": { "get": { "tags": [ "live" ], "summary": "Get active challenges", "description": "Get all currently active challenges.", "operationId": "get_challenges_api_v1_live_challenges_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Challenges Api V1 Live Challenges Get" } } } } } } }, "/api/v1/live/challenges/me": { "get": { "tags": [ "live" ], "summary": "Get my challenge progress", "description": "Get active challenges with the current user's progress.", "operationId": "get_my_challenges_api_v1_live_challenges_me_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get My Challenges Api V1 Live Challenges Me Get" } } } } } } }, "/api/v1/live/creator/achievements": { "get": { "tags": [ "live" ], "summary": "Get creator achievements", "description": "Get all achievements with the current creator's progress.", "operationId": "get_achievements_api_v1_live_creator_achievements_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Achievements Api V1 Live Creator Achievements Get" } } } } } } }, "/api/v1/live/creator/streak": { "get": { "tags": [ "live" ], "summary": "Get creator streak", "description": "Get the current creator's streaming streak.", "operationId": "get_streak_api_v1_live_creator_streak_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Streak Api V1 Live Creator Streak Get" } } } } } } }, "/api/v1/live/events/create": { "post": { "tags": [ "live" ], "summary": "Create a scheduled live event", "description": "Create a new scheduled live event.", "operationId": "post_create_event_api_v1_live_events_create_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEventRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Post Create Event Api V1 Live Events Create Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/events/upcoming": { "get": { "tags": [ "live" ], "summary": "Get upcoming events", "description": "Get all upcoming scheduled events.", "operationId": "get_events_upcoming_api_v1_live_events_upcoming_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 20, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "event_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Event Type" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Events Upcoming Api V1 Live Events Upcoming Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/events/live": { "get": { "tags": [ "live" ], "summary": "Get currently live events", "description": "Get all currently live events.", "operationId": "get_events_live_api_v1_live_events_live_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Events Live Api V1 Live Events Live Get" } } } } } } }, "/api/v1/live/events/{event_id}/start": { "post": { "tags": [ "live" ], "summary": "Start a scheduled event", "description": "Mark a scheduled event as live.", "operationId": "post_start_event_api_v1_live_events__event_id__start_post", "parameters": [ { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Event Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Post Start Event Api V1 Live Events Event Id Start Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/events/{event_id}/complete": { "post": { "tags": [ "live" ], "summary": "Complete an event", "description": "Mark an event as completed.", "operationId": "post_complete_event_api_v1_live_events__event_id__complete_post", "parameters": [ { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Event Id" } }, { "name": "total_viewers", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Viewers" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Post Complete Event Api V1 Live Events Event Id Complete Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/live/maintenance/expire-battles": { "post": { "tags": [ "live" ], "summary": "Auto-expire timed-out battles", "description": "Auto-expire battles past their timer duration.", "operationId": "post_expire_battles_api_v1_live_maintenance_expire_battles_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Post Expire Battles Api V1 Live Maintenance Expire Battles Post" } } } } } } }, "/api/v1/analytics/views": { "get": { "tags": [ "analytics" ], "summary": "Get View Analytics", "description": "GET /api/v1/analytics/views \u2014 True view analytics across all posts.\n\nReturns actual unique viewers, watch time, drop-off points, VTR, scroll-by rate.\nNo inflation. Real numbers.", "operationId": "get_view_analytics_api_v1_analytics_views_get", "parameters": [ { "name": "creator_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Creator UUID", "default": "", "title": "Creator Id" }, "description": "Creator UUID" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "description": "Period: 1h, 24h, 7d, 30d, 90d", "default": "7d", "title": "Period" }, "description": "Period: 1h, 24h, 7d, 30d, 90d" }, { "name": "protocol", "in": "query", "required": false, "schema": { "type": "string", "description": "Filter by protocol", "default": "", "title": "Protocol" }, "description": "Filter by protocol" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ViewAnalyticsSummary" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/views/{post_id}": { "get": { "tags": [ "analytics" ], "summary": "Get Post View Analytics", "description": "GET /api/v1/analytics/views/:post_id \u2014 Per-post view analytics.", "operationId": "get_post_view_analytics_api_v1_analytics_views__post_id__get", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "description": "Period: 1h, 24h, 7d, 30d, 90d", "default": "7d", "title": "Period" }, "description": "Period: 1h, 24h, 7d, 30d, 90d" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ViewAnalyticsDetail" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/engagement": { "get": { "tags": [ "analytics" ], "summary": "Get Engagement Analytics", "description": "GET /api/v1/analytics/engagement \u2014 Engagement analytics across all posts.\n\nReturns real likes, comments with sentiment, reposts, tips, follower gains, CTR.", "operationId": "get_engagement_analytics_api_v1_analytics_engagement_get", "parameters": [ { "name": "creator_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Creator UUID", "default": "", "title": "Creator Id" }, "description": "Creator UUID" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "description": "Period: 1h, 24h, 7d, 30d, 90d", "default": "7d", "title": "Period" }, "description": "Period: 1h, 24h, 7d, 30d, 90d" }, { "name": "protocol", "in": "query", "required": false, "schema": { "type": "string", "description": "Filter by protocol", "default": "", "title": "Protocol" }, "description": "Filter by protocol" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EngagementAnalyticsSummary" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/engagement/{post_id}": { "get": { "tags": [ "analytics" ], "summary": "Get Post Engagement Analytics", "description": "GET /api/v1/analytics/engagement/:post_id \u2014 Per-post engagement analytics.", "operationId": "get_post_engagement_analytics_api_v1_analytics_engagement__post_id__get", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "default": "7d", "title": "Period" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EngagementAnalyticsDetail" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/cross-protocol": { "get": { "tags": [ "analytics" ], "summary": "Get Cross Protocol Analytics", "description": "GET /api/v1/analytics/cross-protocol \u2014 Compare content performance across ALL protocols.\n\nShows views, engagement, and tips per protocol so creators know\nwhere they get the best reach and engagement.", "operationId": "get_cross_protocol_analytics_api_v1_analytics_cross_protocol_get", "parameters": [ { "name": "creator_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Creator UUID", "default": "", "title": "Creator Id" }, "description": "Creator UUID" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "default": "7d", "title": "Period" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CrossProtocolSummary" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/cross-protocol/{post_id}": { "get": { "tags": [ "analytics" ], "summary": "Get Post Cross Protocol Analytics", "description": "GET /api/v1/analytics/cross-protocol/:post_id \u2014 Per-post cross-protocol analytics.", "operationId": "get_post_cross_protocol_analytics_api_v1_analytics_cross_protocol__post_id__get", "parameters": [ { "name": "post_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Post Id" } }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "default": "7d", "title": "Period" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CrossProtocolSummary" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/insights": { "get": { "tags": [ "analytics" ], "summary": "Get Content Insights", "description": "GET /api/v1/analytics/insights \u2014 AI-driven content improvement insights.\n\nReturns data-driven patterns like:\n- 'Your posts with images get 2.3x more engagement'\n- 'Posting at 2pm UTC gets 40% more views'\n- 'Your 60-second shorts perform 3x better than 30-second'", "operationId": "get_content_insights_api_v1_analytics_insights_get", "parameters": [ { "name": "creator_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Creator UUID", "default": "", "title": "Creator Id" }, "description": "Creator UUID" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContentInsightsResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/audience": { "get": { "tags": [ "analytics" ], "summary": "Get Audience Analytics", "description": "GET /api/v1/analytics/audience \u2014 Audience analytics overview.\n\nReturns follower growth, demographics, most engaged followers, top tippers,\nchurn rate, and protocol breakdown.", "operationId": "get_audience_analytics_api_v1_analytics_audience_get", "parameters": [ { "name": "creator_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Creator UUID", "default": "", "title": "Creator Id" }, "description": "Creator UUID" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "default": "30d", "title": "Period" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSummary" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/audience/growth": { "get": { "tags": [ "analytics" ], "summary": "Get Audience Growth", "description": "GET /api/v1/analytics/audience/growth \u2014 Audience growth over time.\n\nReturns daily, weekly, monthly growth trends and protocol-specific growth.", "operationId": "get_audience_growth_api_v1_analytics_audience_growth_get", "parameters": [ { "name": "creator_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Creator UUID", "default": "", "title": "Creator Id" }, "description": "Creator UUID" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "default": "30d", "title": "Period" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GrowthAnalytics" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/events/view": { "post": { "tags": [ "analytics" ], "summary": "Record View Event", "description": "POST /api/v1/analytics/events/view \u2014 Record a view event.\n\nIngests a view event into the analytics buffer for batch processing.\nDeduplication happens via session_id + viewer_fingerprint + post_id.", "operationId": "record_view_event_api_v1_analytics_events_view_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordViewRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/events/engagement": { "post": { "tags": [ "analytics" ], "summary": "Record Engagement Event", "description": "POST /api/v1/analytics/events/engagement \u2014 Record an engagement event.\n\nIngests likes, comments, reposts, tips, saves, clicks, and follows.", "operationId": "record_engagement_event_api_v1_analytics_events_engagement_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecordEngagementRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/analytics/overview": { "get": { "tags": [ "analytics" ], "summary": "Get Analytics Overview", "description": "GET /api/v1/analytics/overview \u2014 Complete analytics dashboard overview.\n\nReturns views, engagement, cross-protocol, audience, and insights\nin a single response for dashboard rendering.", "operationId": "get_analytics_overview_api_v1_analytics_overview_get", "parameters": [ { "name": "creator_id", "in": "query", "required": false, "schema": { "type": "string", "description": "Creator UUID", "default": "", "title": "Creator Id" }, "description": "Creator UUID" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "default": "7d", "title": "Period" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__domains__analytics__router__AnalyticsOverview" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/dm/create": { "post": { "tags": [ "chat-standard" ], "summary": "Create 1-on-1 DM with auto protocol resolution", "description": "Create a direct message between two users.\n\nAutomatically:\n1. Checks which protocols both users have\n2. Creates a Matrix E2E room as the canonical chat space\n3. Establishes Signal Protocol session (Double Ratchet + Kyber-1024)\n4. Bridges to each user's preferred protocol\n5. Returns safety numbers for verification", "operationId": "create_dm_api_v1_chat_dm_create_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDMRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Dm Api V1 Chat Dm Create Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/group/create": { "post": { "tags": [ "chat-standard" ], "summary": "Create encrypted group chat", "description": "Create an encrypted group chat using Megolm ratchet.", "operationId": "create_group_api_v1_chat_group_create_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateGroupRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Group Api V1 Chat Group Create Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/rooms": { "get": { "tags": [ "chat-standard" ], "summary": "List all rooms", "description": "List all rooms the user is a member of.", "operationId": "list_rooms_api_v1_chat_rooms_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Rooms Api V1 Chat Rooms Get" } } } } } } }, "/api/v1/chat/room/{room_id}": { "get": { "tags": [ "chat-standard" ], "summary": "Get room details", "description": "Get details for a specific room.", "operationId": "get_room_api_v1_chat_room__room_id__get", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "description": "Room ID", "title": "Room Id" }, "description": "Room ID" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Room Api V1 Chat Room Room Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/room/{room_id}/messages": { "get": { "tags": [ "chat-standard" ], "summary": "Get room messages", "description": "Get messages from a room with proper decryption handling.", "operationId": "get_messages_api_v1_chat_room__room_id__messages_get", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "description": "Room ID", "title": "Room Id" }, "description": "Room ID" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "description": "Max messages", "default": 50, "title": "Limit" }, "description": "Max messages" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Pagination offset", "default": 0, "title": "Offset" }, "description": "Pagination offset" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Messages Api V1 Chat Room Room Id Messages Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/room/{room_id}/send": { "post": { "tags": [ "chat-standard" ], "summary": "Send message to room", "description": "Send an encrypted message to a room.\n\nEncryption is automatic:\n- 1-on-1 DMs use Double Ratchet (Signal Protocol)\n- Group chats use Megolm (Matrix group ratchet)\n- Messages are bridged to all connected protocols automatically", "operationId": "send_message_api_v1_chat_room__room_id__send_post", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "description": "Room ID", "title": "Room Id" }, "description": "Room ID" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendMessageRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Send Message Api V1 Chat Room Room Id Send Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/room/{room_id}/invite": { "post": { "tags": [ "chat-standard" ], "summary": "Invite user to room", "description": "Invite a user to a room.", "operationId": "invite_user_api_v1_chat_room__room_id__invite_post", "parameters": [ { "name": "room_id", "in": "path", "required": true, "schema": { "type": "string", "description": "Room ID", "title": "Room Id" }, "description": "Room ID" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InviteRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Invite User Api V1 Chat Room Room Id Invite Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/keys/exchange": { "post": { "tags": [ "chat-standard" ], "summary": "Exchange encryption keys with peer", "description": "Perform X3DH + Kyber-1024 key exchange with a peer.\n\nEstablishes a Double Ratchet session for 1-on-1 E2E encryption.\nReturns safety numbers for out-of-band verification.", "operationId": "exchange_keys_api_v1_chat_keys_exchange_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyExchangeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Exchange Keys Api V1 Chat Keys Exchange Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/keys/rotate": { "post": { "tags": [ "chat-standard" ], "summary": "Rotate encryption keys", "description": "Rotate session keys for post-compromise security.", "operationId": "rotate_keys_api_v1_chat_keys_rotate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyRotateRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Rotate Keys Api V1 Chat Keys Rotate Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/keys/fingerprint": { "get": { "tags": [ "chat-standard" ], "summary": "Get safety numbers", "description": "Get safety numbers for verification.\n\nReturns both numeric fingerprint and QR code data for\nout-of-band verification (scan QR, compare digits).", "operationId": "get_fingerprint_api_v1_chat_keys_fingerprint_get", "parameters": [ { "name": "peer_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Peer user ID", "title": "Peer Id" }, "description": "Peer user ID" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Fingerprint Api V1 Chat Keys Fingerprint Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/keys/verify": { "post": { "tags": [ "chat-standard" ], "summary": "Verify peer's safety number", "description": "Verify a peer's safety number.\n\nCompare the numeric fingerprint out-of-band (in person, via\nanother secure channel, or by scanning QR code).", "operationId": "verify_fingerprint_api_v1_chat_keys_verify_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyVerifyRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Verify Fingerprint Api V1 Chat Keys Verify Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/bridge/enable": { "post": { "tags": [ "chat-standard" ], "summary": "Enable protocol bridge for a room", "description": "Enable a bridge for a protocol on a room.\n\nSupported protocols: nostr, farcaster, bluesky, activitypub,\nlens, xmtp, telegram, discord, irc, xmpp, signal, web3\n\nUser sends message on Nostr \u2192 appears in Matrix room \u2192\nbridges to all other connected protocols.", "operationId": "enable_bridge_api_v1_chat_bridge_enable_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BridgeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Enable Bridge Api V1 Chat Bridge Enable Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/bridge/disable": { "post": { "tags": [ "chat-standard" ], "summary": "Disable protocol bridge", "description": "Disable a bridge for a protocol.", "operationId": "disable_bridge_api_v1_chat_bridge_disable_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BridgeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Disable Bridge Api V1 Chat Bridge Disable Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/bridge/status": { "get": { "tags": [ "chat-standard" ], "summary": "Get bridge health status", "description": "Get health status of all bridges or a specific bridge.", "operationId": "bridge_status_api_v1_chat_bridge_status_get", "parameters": [ { "name": "protocol", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter by protocol", "title": "Protocol" }, "description": "Filter by protocol" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Bridge Status Api V1 Chat Bridge Status Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/user/register": { "post": { "tags": [ "chat-standard" ], "summary": "Register user in chat system", "description": "Register a user in the standardized chat system.\n\nCreates their Matrix identity, Signal Protocol key bundle,\nand configures cross-protocol identities.", "operationId": "register_user_api_v1_chat_user_register_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegisterUserRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Register User Api V1 Chat User Register Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/user/{user_id}": { "get": { "tags": [ "chat-standard" ], "summary": "Get user info", "description": "Get a user's chat profile.", "operationId": "get_user_api_v1_chat_user__user_id__get", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "description": "User ID", "title": "User Id" }, "description": "User ID" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get User Api V1 Chat User User Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chat/health": { "get": { "tags": [ "chat-standard" ], "summary": "Full system health check", "description": "Full health check of the standardized chat system.\n\nChecks:\n- Matrix (Conduit) homeserver connectivity\n- Key store status\n- All bridge health\n- Protocol support", "operationId": "chat_health_api_v1_chat_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Chat Health Api V1 Chat Health Get" } } } } } } }, "/api/v1/chat/check-protocols": { "post": { "tags": [ "chat-standard" ], "summary": "Check common protocols with another user", "description": "Check which protocols you have in common with another user.\n\nUseful before creating a DM to see what bridge plan would be used.", "operationId": "check_common_protocols_api_v1_chat_check_protocols_post", "parameters": [ { "name": "peer_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Peer user ID to check against", "title": "Peer Id" }, "description": "Peer user ID to check against" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Check Common Protocols Api V1 Chat Check Protocols Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter": { "post": { "tags": [ "newsletter" ], "summary": "Create Newsletter", "description": "Create a new newsletter campaign.", "operationId": "create_newsletter_api_v1_newsletter_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsletterCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsletterOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "newsletter" ], "summary": "List Newsletters", "description": "List newsletters for the authenticated creator.", "operationId": "list_newsletters_api_v1_newsletter_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter by status", "title": "Status" }, "description": "Filter by status" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 25, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsletterListResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/{newsletter_id}": { "get": { "tags": [ "newsletter" ], "summary": "Get Newsletter", "description": "Get a single newsletter by ID.", "operationId": "get_newsletter_api_v1_newsletter__newsletter_id__get", "parameters": [ { "name": "newsletter_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Newsletter Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsletterOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "newsletter" ], "summary": "Update Newsletter", "description": "Update a draft or scheduled newsletter.", "operationId": "update_newsletter_api_v1_newsletter__newsletter_id__put", "parameters": [ { "name": "newsletter_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Newsletter Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsletterUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsletterOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "newsletter" ], "summary": "Delete Newsletter", "description": "Delete a newsletter campaign.", "operationId": "delete_newsletter_api_v1_newsletter__newsletter_id__delete", "parameters": [ { "name": "newsletter_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Newsletter Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/send": { "post": { "tags": [ "newsletter" ], "summary": "Send Newsletter", "description": "Send a newsletter immediately.\n\nOptionally send a test to a single email first.", "operationId": "send_newsletter_api_v1_newsletter_send_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/schedule": { "post": { "tags": [ "newsletter" ], "summary": "Schedule Newsletter", "description": "Schedule a newsletter for future delivery.", "operationId": "schedule_newsletter_api_v1_newsletter_schedule_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScheduleRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/delivery-status": { "get": { "tags": [ "newsletter" ], "summary": "Delivery Status", "description": "Get delivery analytics for a newsletter.", "operationId": "delivery_status_api_v1_newsletter_delivery_status_get", "parameters": [ { "name": "newsletter_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Newsletter ID", "title": "Newsletter Id" }, "description": "Newsletter ID" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeliveryStatusOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/publish": { "post": { "tags": [ "newsletter" ], "summary": "Publish Newsletter", "description": "Publish a newsletter to all configured platforms simultaneously.", "operationId": "publish_newsletter_api_v1_newsletter_publish_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/subscribe": { "post": { "tags": [ "newsletter" ], "summary": "Subscribe", "description": "Subscribe to a newsletter (free or with crypto payment).\n\nFor paid tiers, include chain, tx_hash, token, and from_address.", "operationId": "subscribe_api_v1_newsletter_subscribe_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscribeRequest" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscriberOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/subscribe/crypto": { "post": { "tags": [ "newsletter" ], "summary": "Subscribe Crypto", "description": "Subscribe with a crypto payment. Verifies on-chain before activating.", "operationId": "subscribe_crypto_api_v1_newsletter_subscribe_crypto_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CryptoSubscribeRequest" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscriberOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/subscribers": { "get": { "tags": [ "newsletter" ], "summary": "List Subscribers", "description": "List subscribers with optional filters.", "operationId": "list_subscribers_api_v1_newsletter_subscribers_get", "parameters": [ { "name": "newsletter_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter by newsletter", "title": "Newsletter Id" }, "description": "Filter by newsletter" }, { "name": "tier", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter by tier", "title": "Tier" }, "description": "Filter by tier" }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter by status", "title": "Status" }, "description": "Filter by status" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 25, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscriberListResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/subscribers/import": { "post": { "tags": [ "newsletter" ], "summary": "Import Subscribers", "description": "Bulk import subscribers.", "operationId": "import_subscribers_api_v1_newsletter_subscribers_import_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscriberImportRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscriberImportResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/subscribers/export": { "get": { "tags": [ "newsletter" ], "summary": "Export Subscribers Csv", "description": "Export subscribers as CSV.", "operationId": "export_subscribers_csv_api_v1_newsletter_subscribers_export_get", "parameters": [ { "name": "newsletter_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Newsletter ID", "title": "Newsletter Id" }, "description": "Newsletter ID" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "string", "title": "Response Export Subscribers Csv Api V1 Newsletter Subscribers Export Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/newsletter/analytics": { "get": { "tags": [ "newsletter" ], "summary": "Get Analytics", "description": "Get analytics dashboard \u2014 per-creator or per-newsletter.", "operationId": "get_analytics_api_v1_newsletter_analytics_get", "parameters": [ { "name": "newsletter_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Per-newsletter analytics", "title": "Newsletter Id" }, "description": "Per-newsletter analytics" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewsletterAnalytics" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/platforms": { "get": { "tags": [ "postiz" ], "summary": "List all available platforms", "description": "Get all 30+ supported platforms grouped by category. Shows connection status for authenticated users.", "operationId": "list_platforms_api_v1_postiz_platforms_get", "parameters": [ { "name": "user_id", "in": "query", "required": false, "schema": { "type": "string", "description": "User ID to check connections for", "default": "", "title": "User Id" }, "description": "User ID to check connections for" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformListResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/platforms/connect": { "post": { "tags": [ "postiz" ], "summary": "Connect a platform", "description": "Connect a social/platform account via OAuth or API key. Returns the connection details.", "operationId": "connect_platform_endpoint_api_v1_postiz_platforms_connect_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformConnectRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectResponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/platforms/disconnect": { "post": { "tags": [ "postiz" ], "summary": "Disconnect a platform", "description": "Disconnect a previously connected platform by connection ID.", "operationId": "disconnect_platform_endpoint_api_v1_postiz_platforms_disconnect_post", "parameters": [ { "name": "connection_id", "in": "query", "required": true, "schema": { "type": "string", "description": "Connection UUID to disconnect", "title": "Connection Id" }, "description": "Connection UUID to disconnect" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Disconnect Platform Endpoint Api V1 Postiz Platforms Disconnect Post" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/schedule": { "post": { "tags": [ "postiz" ], "summary": "Schedule a post", "description": "Schedule a post for publishing on one or more platforms. Supports scheduling at a specific time, queueing, recurring patterns, and threads.", "operationId": "schedule_post_endpoint_api_v1_postiz_schedule_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SchedulePostRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScheduledPost" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/calendar": { "get": { "tags": [ "postiz" ], "summary": "Content calendar", "description": "Get a visual content calendar for a date range. Shows scheduled, published, and draft posts per day.", "operationId": "get_calendar_endpoint_api_v1_postiz_calendar_get", "parameters": [ { "name": "start_date", "in": "query", "required": true, "schema": { "type": "string", "description": "Start date (ISO format, e.g. 2026-01-01)", "title": "Start Date" }, "description": "Start date (ISO format, e.g. 2026-01-01)" }, { "name": "end_date", "in": "query", "required": true, "schema": { "type": "string", "description": "End date (ISO format, e.g. 2026-01-31)", "title": "End Date" }, "description": "End date (ISO format, e.g. 2026-01-31)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalendarResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/schedule/bulk": { "post": { "tags": [ "postiz" ], "summary": "Bulk schedule posts", "description": "Upload multiple posts at once via JSON or CSV. Supports up to 1000 entries per batch.", "operationId": "bulk_schedule_endpoint_api_v1_postiz_schedule_bulk_post", "requestBody": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/BulkScheduleEntry" }, "type": "array", "title": "Body" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkScheduleResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/schedule/queue": { "get": { "tags": [ "postiz" ], "summary": "View posting queue", "description": "View the auto-posting queue. Shows queued posts, estimated fill time, and optimal intervals.", "operationId": "get_queue_endpoint_api_v1_postiz_schedule_queue_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QueueResponse" } } } } } } }, "/api/v1/postiz/schedule/recurring": { "post": { "tags": [ "postiz" ], "summary": "Create recurring post", "description": "Create a recurring post schedule (daily, weekly, monthly, or custom cron). Auto-posts at the defined interval.", "operationId": "create_recurring_endpoint_api_v1_postiz_schedule_recurring_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecurringCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RecurringPost" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/schedule/gaps": { "get": { "tags": [ "postiz" ], "summary": "Posting gap analysis", "description": "Analyze posting frequency across all connected platforms. Shows days since last post per platform with warnings and recommendations.", "operationId": "get_gaps_endpoint_api_v1_postiz_schedule_gaps_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GapAnalysisResponse" } } } } } } }, "/api/v1/postiz/schedule/best-time": { "get": { "tags": [ "postiz" ], "summary": "Best posting times (all platforms)", "description": "AI-optimized best posting times for all supported platforms. Data-driven recommendations per platform.", "operationId": "get_best_times_endpoint_api_v1_postiz_schedule_best_time_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BestTimeResponse" } } } } } } }, "/api/v1/postiz/schedule/best-time/{platform_id}": { "get": { "tags": [ "postiz" ], "summary": "Best posting time (single platform)", "description": "Get the AI-optimized best posting time for a specific platform.", "operationId": "get_platform_best_time_endpoint_api_v1_postiz_schedule_best_time__platform_id__get", "parameters": [ { "name": "platform_id", "in": "path", "required": true, "schema": { "type": "string", "description": "Platform ID (e.g. 'farcaster', 'nostr')", "title": "Platform Id" }, "description": "Platform ID (e.g. 'farcaster', 'nostr')" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BestTimeResponse" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/analytics": { "get": { "tags": [ "postiz" ], "summary": "Analytics dashboard", "description": "Cross-platform analytics dashboard. Compare performance across all 30+ platforms with engagement rates, audience growth, and recommendations.", "operationId": "get_analytics_endpoint_api_v1_postiz_analytics_get", "parameters": [ { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "description": "Period: 7d, 30d, 90d, 1y", "default": "30d", "title": "Period" }, "description": "Period: 7d, 30d, 90d, 1y" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnalyticsDashboard" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/analytics/platform/{platform_id}": { "get": { "tags": [ "postiz" ], "summary": "Per-platform analytics", "description": "Detailed analytics for a single platform including posts, impressions, engagement, follower growth, and top performing posts.", "operationId": "get_platform_analytics_endpoint_api_v1_postiz_analytics_platform__platform_id__get", "parameters": [ { "name": "platform_id", "in": "path", "required": true, "schema": { "type": "string", "description": "Platform ID (e.g. 'twitter', 'nostr')", "title": "Platform Id" }, "description": "Platform ID (e.g. 'twitter', 'nostr')" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "description": "Period: 7d, 30d, 90d, 1y", "default": "30d", "title": "Period" }, "description": "Period: 7d, 30d, 90d, 1y" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlatformAnalytics" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/analytics/export": { "get": { "tags": [ "postiz" ], "summary": "Export analytics report", "description": "Export analytics data as PDF or CSV. Includes charts, platform breakdown, and performance insights.", "operationId": "export_analytics_endpoint_api_v1_postiz_analytics_export_get", "parameters": [ { "name": "export_format", "in": "query", "required": false, "schema": { "type": "string", "description": "pdf or csv", "default": "pdf", "title": "Export Format" }, "description": "pdf or csv" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "description": "7d, 30d, 90d, 1y", "default": "30d", "title": "Period" }, "description": "7d, 30d, 90d, 1y" }, { "name": "platforms", "in": "query", "required": false, "schema": { "type": "string", "description": "Comma-separated platform IDs to include", "default": "", "title": "Platforms" }, "description": "Comma-separated platform IDs to include" }, { "name": "include_charts", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Include charts in export", "default": true, "title": "Include Charts" }, "description": "Include charts in export" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/compose": { "post": { "tags": [ "postiz" ], "summary": "Compose a post with preview", "description": "Compose a post and see how it renders on each target platform. Includes character counts, media checks, and hashtag suggestions.", "operationId": "compose_post_endpoint_api_v1_postiz_compose_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ComposeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ComposeResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/preview": { "post": { "tags": [ "postiz" ], "summary": "Preview post on platforms", "description": "Preview how a post will appear on each selected platform. Shows character counts, warnings, and platform-specific formatting.", "operationId": "preview_post_endpoint_api_v1_postiz_preview_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ComposeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ComposePreview" }, "type": "array", "title": "Response Preview Post Endpoint Api V1 Postiz Preview Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/media/upload": { "post": { "tags": [ "postiz" ], "summary": "Upload media", "description": "Upload media (images, videos, documents) to the media library for use across all platforms.", "operationId": "upload_media_endpoint_api_v1_postiz_media_upload_post", "parameters": [ { "name": "filename", "in": "query", "required": true, "schema": { "type": "string", "description": "Filename with extension", "title": "Filename" }, "description": "Filename with extension" }, { "name": "media_type", "in": "query", "required": true, "schema": { "type": "string", "description": "image, video, document, audio", "title": "Media Type" }, "description": "image, video, document, audio" }, { "name": "mime_type", "in": "query", "required": false, "schema": { "type": "string", "description": "MIME type", "default": "application/octet-stream", "title": "Mime Type" }, "description": "MIME type" }, { "name": "size_bytes", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "File size in bytes", "default": 0, "title": "Size Bytes" }, "description": "File size in bytes" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MediaUploadResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/media": { "get": { "tags": [ "postiz" ], "summary": "Media library", "description": "Browse the media library with all uploaded images, videos, and documents. Filterable by media type.", "operationId": "get_media_library_endpoint_api_v1_postiz_media_get", "parameters": [ { "name": "media_type", "in": "query", "required": false, "schema": { "type": "string", "description": "Filter by media type (image, video, document, audio)", "default": "", "title": "Media Type" }, "description": "Filter by media type (image, video, document, audio)" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "description": "Results per page", "default": 50, "title": "Limit" }, "description": "Results per page" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page offset", "default": 0, "title": "Offset" }, "description": "Page offset" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MediaLibraryResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/postiz/templates": { "get": { "tags": [ "postiz" ], "summary": "List post templates", "description": "Get all saved post templates grouped by category.", "operationId": "list_templates_endpoint_api_v1_postiz_templates_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateListResponse" } } } } } }, "post": { "tags": [ "postiz" ], "summary": "Create post template", "description": "Save a post template for reuse. Templates can include variables like {{name}} for personalization.", "operationId": "create_template_endpoint_api_v1_postiz_templates_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateCreateRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PostTemplate" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scanner/webhooks": { "get": { "tags": [ "scanner-webhooks" ], "summary": "List Webhooks", "description": "List all webhook subscriptions (with optional owner_id filter).", "operationId": "list_webhooks_api_v1_scanner_webhooks_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Webhooks Api V1 Scanner Webhooks Get" } } } } } }, "post": { "tags": [ "scanner-webhooks" ], "summary": "Create Webhook", "description": "Create a new webhook subscription.\n\nValidates the URL format and event types before persisting.\nThe webhook engine will start delivering events within one poll cycle.", "operationId": "create_webhook_api_v1_scanner_webhooks_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/app__domains__scanner__webhooks__models__CreateWebhookRequest" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Webhook Api V1 Scanner Webhooks Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scanner/webhooks/{sub_id}": { "delete": { "tags": [ "scanner-webhooks" ], "summary": "Delete Webhook", "description": "Delete (unsubscribe) a webhook by ID.", "operationId": "delete_webhook_api_v1_scanner_webhooks__sub_id__delete", "parameters": [ { "name": "sub_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Sub Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Delete Webhook Api V1 Scanner Webhooks Sub Id Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "scanner-webhooks" ], "summary": "Get Webhook", "description": "Get a single webhook subscription by ID.", "operationId": "get_webhook_api_v1_scanner_webhooks__sub_id__get", "parameters": [ { "name": "sub_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Sub Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Webhook Api V1 Scanner Webhooks Sub Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "scanner-webhooks" ], "summary": "Update Webhook", "description": "Update an existing webhook subscription.\n\nSupports partial updates: only provided fields are patched. Set\n``active: false`` to pause delivery without deleting the subscription\n(mirrors Helius's toggle-webhook behaviour).", "operationId": "update_webhook_api_v1_scanner_webhooks__sub_id__patch", "parameters": [ { "name": "sub_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Sub Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWebhookRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Update Webhook Api V1 Scanner Webhooks Sub Id Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scanner/webhooks/{sub_id}/test": { "post": { "tags": [ "scanner-webhooks" ], "summary": "Test Webhook", "description": "Send a synthetic test event to the subscriber URL.\n\nUseful to verify an endpoint accepts our payload shape without waiting\nfor a real on-chain event. Uses the first event type on the subscription.", "operationId": "test_webhook_api_v1_scanner_webhooks__sub_id__test_post", "parameters": [ { "name": "sub_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Sub Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Test Webhook Api V1 Scanner Webhooks Sub Id Test Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scanner/webhooks/events": { "get": { "tags": [ "scanner-webhooks" ], "summary": "List Webhook Events", "description": "Return all available webhook event types with descriptions.\n\nThis endpoint does not require authentication \u2014 it's informational.", "operationId": "list_webhook_events_api_v1_scanner_webhooks_events_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Response List Webhook Events Api V1 Scanner Webhooks Events Get" } } } } } } }, "/api/v1/scanner/webhooks/telegram": { "post": { "tags": [ "scanner-webhooks" ], "summary": "Subscribe Telegram Alerts", "description": "Subscribe a bot user's chat to real events (no external URL needed).\n\nUsed by the RugMunchBot's /alert and /watch commands. Creates internal\n``internal://telegram/{user_id}`` subscriptions; the webhook engine\nroutes matching events to the bot's Redis alert queue instead of an\nHTTP POST, and the bot's ``deliver_pending_alerts`` job pushes them as\nformatted Telegram alerts.", "operationId": "subscribe_telegram_alerts_api_v1_scanner_webhooks_telegram_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TelegramAlertRequest" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Subscribe Telegram Alerts Api V1 Scanner Webhooks Telegram Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "scanner-webhooks" ], "summary": "Unsubscribe Telegram Alerts", "description": "Unsubscribe a bot user's chat from events for the given scope.", "operationId": "unsubscribe_telegram_alerts_api_v1_scanner_webhooks_telegram_delete", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TelegramAlertRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Unsubscribe Telegram Alerts Api V1 Scanner Webhooks Telegram Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bot/health": { "get": { "tags": [ "bot" ], "summary": "Bot Health", "description": "Health check for bot connectivity.", "operationId": "bot_health_api_v1_bot_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Bot Health Api V1 Bot Health Get" } } } } } } }, "/api/v1/bot/scan": { "post": { "tags": [ "bot" ], "summary": "Bot Scan", "description": "Fast token scan \u2014 reads Redis cache first, falls back to DexScreener.", "operationId": "bot_scan_api_v1_bot_scan_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BotScanRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Bot Scan Api V1 Bot Scan Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bot/ask": { "post": { "tags": [ "bot" ], "summary": "Bot Ask", "description": "AI Q&A \u2014 uses the free remote snappy model for fast, free answers.", "operationId": "bot_ask_api_v1_bot_ask_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BotAskRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Bot Ask Api V1 Bot Ask Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bot/pulse": { "get": { "tags": [ "bot" ], "summary": "Bot Pulse", "description": "Market pulse \u2014 quick crypto market overview for Telegram bot.", "operationId": "bot_pulse_api_v1_bot_pulse_get", "parameters": [ { "name": "refresh", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Refresh" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Bot Pulse Api V1 Bot Pulse Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/internal/news-feed": { "get": { "tags": [ "internal" ], "summary": "Get News Feed", "operationId": "get_news_feed_api_v1_internal_news_feed_get", "parameters": [ { "name": "channel", "in": "query", "required": false, "schema": { "type": "string", "default": "news", "title": "Channel" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 3, "title": "Limit" } }, { "name": "min_score", "in": "query", "required": false, "schema": { "type": "number", "default": 44.0, "title": "Min Score" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get News Feed Api V1 Internal News Feed Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/internal/news-fetch": { "post": { "tags": [ "internal" ], "summary": "Trigger Fetch", "operationId": "trigger_fetch_api_v1_internal_news_fetch_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Trigger Fetch Api V1 Internal News Fetch Post" } } } } } } }, "/api/v1/scoring/rate": { "post": { "tags": [ "scoring" ], "summary": "Rate Token", "description": "Rate a token using the multi-factor scoring algorithm.\n\nReturns a 0-100 safety score with full breakdown across 5 categories:\nContract Safety, Liquidity Safety, Holder Analysis, Deployer Reputation,\nand Trading Activity. Optionally enhanced by the cross-encoder reranker.\n\nAlso resolves the real deployer (bypassing factory addresses like\npump.fun) and returns wallet labels.", "operationId": "rate_token_api_v1_scoring_rate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateTokenRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateTokenResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scoring/deployer/{chain}/{address}": { "get": { "tags": [ "scoring" ], "summary": "Get Deployer", "description": "Get deployer profile for a wallet address.\n\nDetects if the address is a factory/launchpad (e.g. pump.fun) and,\nif so, attempts to resolve the real creator.", "operationId": "get_deployer_api_v1_scoring_deployer__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeployerProfileResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/scoring/wallet/{chain}/{address}": { "get": { "tags": [ "scoring" ], "summary": "Get Wallet", "description": "Get labels and profile for a wallet address.\n\nReturns all known labels (exchange, bot, sniper, whale, dev, rugger,\nMEV, etc.), scammer/good-actor status, and deployer profile if the\nwallet has deployed tokens.", "operationId": "get_wallet_api_v1_scoring_wallet__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WalletLabelsResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/tracing/decode": { "post": { "tags": [ "tracing" ], "summary": "Decode transaction tracing", "description": "Fetch receipt logs for a transaction, decode event signatures via the 4byte directory, sort by logIndex, map wallet-to-wallet hops, and build a cluster graph for RugMaps visualization.", "operationId": "trace_decode_api_v1_tracing_decode_post", "parameters": [ { "name": "include_trace", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Optionally attempt debug_traceTransaction internal calls", "default": false, "title": "Include Trace" }, "description": "Optionally attempt debug_traceTransaction internal calls" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TraceDecodeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Trace Decode Api V1 Tracing Decode Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/tracing/health": { "get": { "tags": [ "tracing" ], "summary": "Tracing health", "description": "Health check for the tracing pipeline.", "operationId": "tracing_health_api_v1_tracing_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Tracing Health Api V1 Tracing Health Get" } } } } } } }, "/api/v1/trades/{chain}/{address}": { "get": { "tags": [ "trades" ], "summary": "Get recent trades for a token", "description": "Get recent trades for a token.\n\n- **chain**: solana, ethereum, bsc, polygon, etc.\n- **address**: Token contract address\n- **limit**: Number of trades (1-100, default 20)\n- **min_amount**: Filter trades above this USD amount (whale filter)\n- **side**: Filter by trade side (buy/sell/all)\n\nReturns trades with whale flags, stats, and source info.", "operationId": "get_token_trades_api_v1_trades__chain___address__get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } }, { "name": "min_amount", "in": "query", "required": false, "schema": { "type": "number", "minimum": 0, "description": "Filter: minimum USD trade amount", "default": 0, "title": "Min Amount" }, "description": "Filter: minimum USD trade amount" }, { "name": "side", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^(buy|sell|all)$", "default": "all", "title": "Side" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Token Trades Api V1 Trades Chain Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/trades/{chain}/{address}/stats": { "get": { "tags": [ "trades" ], "summary": "Get trade statistics for a token", "description": "Get aggregated trade statistics: total trades, volume, buys/sells, whale activity.\nUses the same cache as the trades endpoint.", "operationId": "get_trade_stats_api_v1_trades__chain___address__stats_get", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string", "title": "Chain" } }, { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Trade Stats Api V1 Trades Chain Address Stats Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/trades/feed": { "get": { "tags": [ "trades" ], "summary": "Live trade feed for monitored tokens", "description": "Aggregated live trade feed across all monitored tokens.\n\nReturns the most recent trades across active tokens, highlighting whale trades.\nUseful for dashboards and real-time monitoring.", "operationId": "get_trade_feed_api_v1_trades_feed_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain to monitor", "default": "solana", "title": "Chain" }, "description": "Blockchain to monitor" }, { "name": "min_amount", "in": "query", "required": false, "schema": { "type": "number", "minimum": 0, "description": "Minimum USD trade to show", "default": 1000, "title": "Min Amount" }, "description": "Minimum USD trade to show" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Trade Feed Api V1 Trades Feed Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/launches/feed": { "get": { "tags": [ "launches" ], "summary": "Recent token launches", "description": "Get recently detected token launches with risk scores.\n\nReturns list of new token launches discovered by the detection system.\nIncludes risk scores from auto-scan, liquidity, age, and source.", "operationId": "get_launch_feed_api_v1_launches_feed_get", "parameters": [ { "name": "chain", "in": "query", "required": false, "schema": { "type": "string", "description": "Blockchain filter", "default": "solana", "title": "Chain" }, "description": "Blockchain filter" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "min_liquidity", "in": "query", "required": false, "schema": { "type": "number", "minimum": 0, "description": "Min liquidity filter", "default": 0, "title": "Min Liquidity" }, "description": "Min liquidity filter" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Launch Feed Api V1 Launches Feed Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/launches/alerts": { "get": { "tags": [ "launches" ], "summary": "High-risk launch alerts", "description": "Get recent high-risk launch alerts.\n\nTokens that scored above 70/100 on the auto-scan risk assessment.\nIncludes risk flags and metadata.", "operationId": "get_launch_alerts_api_v1_launches_alerts_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 20, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Launch Alerts Api V1 Launches Alerts Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/launches/scan/{address}": { "get": { "tags": [ "launches" ], "summary": "Get auto-scan result for a launch", "description": "Get the automated scan result for a recently launched token.\n\nReturns risk score, flags, liquidity data from the auto-scan pipeline.", "operationId": "get_launch_scan_api_v1_launches_scan__address__get", "parameters": [ { "name": "address", "in": "path", "required": true, "schema": { "type": "string", "title": "Address" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Launch Scan Api V1 Launches Scan Address Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/launches/stats": { "get": { "tags": [ "launches" ], "summary": "Launch activity statistics", "description": "Get statistics about recent token launch activity.\n\nTotal launches detected, high-risk count, average liquidity, etc.", "operationId": "get_launch_stats_api_v1_launches_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Launch Stats Api V1 Launches Stats Get" } } } } } } } }, "components": { "schemas": { "ActionResponse": { "properties": { "success": { "type": "boolean", "title": "Success", "default": true }, "message": { "type": "string", "title": "Message", "default": "" }, "data": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Data" } }, "type": "object", "title": "ActionResponse", "description": "Generic action response." }, "AddressDepthRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" }, "depth": { "type": "integer", "title": "Depth", "default": 2 } }, "type": "object", "required": [ "address" ], "title": "AddressDepthRequest" }, "AgentQuery": { "properties": { "query": { "type": "string", "maxLength": 2000, "minLength": 1, "title": "Query", "description": "User query for the agent fleet" }, "agent": { "type": "string", "enum": [ "auto", "scanner", "rag", "market" ], "title": "Agent", "description": "Force a specialist, or auto-route", "default": "auto" }, "chain": { "type": "string", "title": "Chain", "description": "Blockchain for scanner queries", "default": "ethereum" } }, "type": "object", "required": [ "query" ], "title": "AgentQuery", "description": "Request body for ``POST /api/v1/agent/analyze``." }, "AgentResponse": { "properties": { "query": { "type": "string", "title": "Query", "description": "Original user query" }, "agent": { "type": "string", "enum": [ "scanner", "rag", "market" ], "title": "Agent", "description": "Specialist that answered" }, "data": { "anyOf": [ { "$ref": "#/components/schemas/TokenRiskResult" }, { "$ref": "#/components/schemas/KnowledgeResult" }, { "$ref": "#/components/schemas/MarketResult" } ], "title": "Data", "description": "Typed specialist output" }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary", "description": "One-line summary of the result" } }, "type": "object", "required": [ "query", "agent", "data" ], "title": "AgentResponse", "description": "Unified typed response from the agent fleet." }, "AlertAckRequest": { "properties": { "alert_id": { "type": "string", "title": "Alert Id" } }, "type": "object", "required": [ "alert_id" ], "title": "AlertAckRequest" }, "AlertList": { "properties": { "count": { "type": "integer", "minimum": 0.0, "title": "Count" }, "items": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Items", "default": [] } }, "type": "object", "required": [ "count" ], "title": "AlertList", "description": "Response for GET /api/v1/alerts." }, "AlertRule": { "properties": { "name": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Name" }, "subject_type": { "type": "string", "maxLength": 20, "minLength": 1, "pattern": "^(token|wallet|deployer)$", "title": "Subject Type" }, "subject_id": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Subject Id" }, "trigger": { "type": "string", "maxLength": 30, "minLength": 1, "pattern": "^(risk_score_above|deployer_rug|news_mention)$", "title": "Trigger" }, "threshold": { "anyOf": [ { "type": "number", "minimum": 0.0 }, { "type": "null" } ], "title": "Threshold" }, "channels": { "items": { "type": "string" }, "type": "array", "title": "Channels", "default": [] } }, "type": "object", "required": [ "name", "subject_type", "subject_id", "trigger" ], "title": "AlertRule", "description": "Schema for an alert rule (creation/edit)." }, "AlertWebhookPayload": { "properties": { "source": { "type": "string", "title": "Source" }, "severity": { "type": "string", "title": "Severity" }, "title": { "type": "string", "title": "Title" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Labels", "default": {} } }, "type": "object", "required": [ "source", "severity", "title" ], "title": "AlertWebhookPayload", "description": "Generic webhook payload from external alert sources." }, "AnalyticsDashboard": { "properties": { "overview": { "$ref": "#/components/schemas/app__domains__postiz__models__AnalyticsOverview" }, "platforms": { "items": { "$ref": "#/components/schemas/PlatformAnalytics" }, "type": "array", "title": "Platforms" }, "best_performing": { "$ref": "#/components/schemas/BestPerformingContent" }, "audience_growth": { "$ref": "#/components/schemas/AudienceGrowth" }, "recommendations": { "items": { "type": "string" }, "type": "array", "title": "Recommendations" }, "generated_at": { "type": "string", "title": "Generated At", "description": "ISO timestamp" } }, "type": "object", "required": [ "generated_at" ], "title": "AnalyticsDashboard", "description": "Cross-platform analytics dashboard." }, "AnnouncementRequest": { "properties": { "title": { "type": "string", "title": "Title" }, "body": { "type": "string", "title": "Body" }, "active": { "type": "boolean", "title": "Active", "default": true } }, "type": "object", "required": [ "title", "body" ], "title": "AnnouncementRequest" }, "AnomalyReport": { "properties": { "pattern": { "type": "string", "title": "Pattern" }, "severity": { "type": "string", "title": "Severity" }, "description": { "type": "string", "title": "Description" }, "affected_wallets": { "items": { "type": "string" }, "type": "array", "title": "Affected Wallets" }, "confidence": { "type": "number", "title": "Confidence", "default": 0.0 } }, "type": "object", "required": [ "pattern", "severity", "description" ], "title": "AnomalyReport" }, "AskRequest": { "properties": { "query": { "type": "string", "maxLength": 2048, "minLength": 1, "title": "Query", "description": "Crypto research question." } }, "type": "object", "required": [ "query" ], "title": "AskRequest", "description": "Agentic RAG question." }, "AskResponse": { "properties": { "answer": { "type": "string", "title": "Answer" }, "query_type": { "type": "string", "title": "Query Type", "default": "general" }, "sources": { "items": { "type": "string" }, "type": "array", "title": "Sources" }, "tool_calls": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Tool Calls" }, "verified": { "type": "boolean", "title": "Verified", "default": true } }, "type": "object", "required": [ "answer" ], "title": "AskResponse", "description": "Agentic RAG answer." }, "AttachRagRequest": { "properties": { "chain": { "type": "string", "title": "Chain" }, "address": { "type": "string", "title": "Address" }, "qdrant_point_id": { "type": "string", "title": "Qdrant Point Id" } }, "type": "object", "required": [ "chain", "address", "qdrant_point_id" ], "title": "AttachRagRequest" }, "AudienceGrowth": { "properties": { "total": { "type": "integer", "title": "Total", "default": 0 }, "by_platform": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "By Platform" }, "daily_trend": { "items": { "$ref": "#/components/schemas/app__domains__postiz__models__DataPoint" }, "type": "array", "title": "Daily Trend" }, "weekly_trend": { "items": { "$ref": "#/components/schemas/app__domains__postiz__models__DataPoint" }, "type": "array", "title": "Weekly Trend" }, "monthly_trend": { "items": { "$ref": "#/components/schemas/app__domains__postiz__models__DataPoint" }, "type": "array", "title": "Monthly Trend" }, "growth_rate": { "type": "number", "title": "Growth Rate", "default": 0.0 }, "top_sources": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Top Sources" } }, "type": "object", "title": "AudienceGrowth", "description": "Audience growth analytics." }, "AudienceSummary": { "properties": { "total_followers": { "type": "integer", "title": "Total Followers", "default": 0 }, "followers_gained_30d": { "type": "integer", "title": "Followers Gained 30D", "default": 0 }, "followers_lost_30d": { "type": "integer", "title": "Followers Lost 30D", "default": 0 }, "net_growth_30d": { "type": "integer", "title": "Net Growth 30D", "default": 0 }, "churn_rate_30d": { "type": "number", "title": "Churn Rate 30D", "default": 0.0 }, "growth_rate_30d": { "type": "number", "title": "Growth Rate 30D", "default": 0.0 }, "protocol_breakdown": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "Protocol Breakdown", "description": "Followers per protocol" }, "top_interests": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Top Interests" }, "top_chains": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Top Chains" }, "most_engaged_followers": { "items": { "$ref": "#/components/schemas/FollowerSummary" }, "type": "array", "title": "Most Engaged Followers" }, "top_tippers": { "items": { "$ref": "#/components/schemas/FollowerSummary" }, "type": "array", "title": "Top Tippers" }, "growth_trend": { "items": { "$ref": "#/components/schemas/app__domains__analytics__models__DataPoint" }, "type": "array", "title": "Growth Trend" }, "top_acquisition_sources": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Top Acquisition Sources" } }, "type": "object", "title": "AudienceSummary", "description": "Audience analytics overview." }, "AuditRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "address" ], "title": "AuditRequest" }, "AwardXPRequest": { "properties": { "source": { "type": "string", "pattern": "^(watch|chat|gift|share)$", "title": "Source" }, "amount": { "type": "integer", "maximum": 1000.0, "minimum": 1.0, "title": "Amount", "default": 1 }, "reference_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reference Id" } }, "type": "object", "required": [ "source" ], "title": "AwardXPRequest" }, "BanUserRequest": { "properties": { "reason": { "type": "string", "title": "Reason", "default": "" } }, "type": "object", "title": "BanUserRequest" }, "BatchContractRequest": { "properties": { "addresses": { "items": { "type": "string" }, "type": "array", "maxItems": 50, "minItems": 1, "title": "Addresses" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" }, "deep": { "type": "boolean", "title": "Deep", "default": false } }, "type": "object", "required": [ "addresses" ], "title": "BatchContractRequest" }, "BatchResponse": { "properties": { "ok": { "type": "boolean", "title": "Ok", "default": true }, "accepted": { "type": "integer", "title": "Accepted" } }, "type": "object", "required": [ "accepted" ], "title": "BatchResponse", "description": "Response for batch sync operations." }, "BattleAccept": { "properties": { "battle_id": { "type": "string", "title": "Battle Id" } }, "type": "object", "required": [ "battle_id" ], "title": "BattleAccept" }, "BattleGiftSend": { "properties": { "battle_id": { "type": "string", "title": "Battle Id" }, "recipient_id": { "type": "string", "title": "Recipient Id" }, "gift_type": { "type": "string", "title": "Gift Type", "default": "standard" }, "value_cents": { "type": "integer", "minimum": 1.0, "title": "Value Cents", "default": 100 } }, "type": "object", "required": [ "battle_id", "recipient_id" ], "title": "BattleGiftSend" }, "BattleRequest": { "properties": { "opponent_id": { "type": "string", "title": "Opponent Id" }, "duration_seconds": { "type": "integer", "maximum": 600.0, "minimum": 60.0, "title": "Duration Seconds", "default": 180 } }, "type": "object", "required": [ "opponent_id" ], "title": "BattleRequest" }, "BestPerformingContent": { "properties": { "by_platform": { "additionalProperties": { "items": { "$ref": "#/components/schemas/PostPerformance" }, "type": "array" }, "type": "object", "title": "By Platform" }, "by_content_type": { "additionalProperties": { "type": "number" }, "type": "object", "title": "By Content Type" }, "by_time_of_day": { "additionalProperties": { "type": "number" }, "type": "object", "title": "By Time Of Day" }, "top_overall": { "items": { "$ref": "#/components/schemas/PostPerformance" }, "type": "array", "title": "Top Overall" }, "insights": { "items": { "type": "string" }, "type": "array", "title": "Insights" } }, "type": "object", "title": "BestPerformingContent", "description": "Best performing content analysis." }, "BestTimeResponse": { "properties": { "platform_times": { "additionalProperties": { "$ref": "#/components/schemas/PlatformBestTime" }, "type": "object", "title": "Platform Times" }, "overall_recommendation": { "type": "string", "title": "Overall Recommendation", "default": "" }, "generated_at": { "type": "string", "title": "Generated At", "description": "ISO timestamp" } }, "type": "object", "required": [ "generated_at" ], "title": "BestTimeResponse", "description": "AI-optimized best posting times per platform." }, "BlockIPRequest": { "properties": { "ip": { "type": "string", "title": "Ip" }, "reason": { "type": "string", "title": "Reason", "default": "" }, "duration_hours": { "type": "integer", "title": "Duration Hours", "default": 24 } }, "type": "object", "required": [ "ip" ], "title": "BlockIPRequest" }, "Body_flows_analyze_api_v1_security_flows_analyze_post": { "properties": { "entity_addresses": { "items": { "type": "string" }, "type": "array", "title": "Entity Addresses" }, "transactions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Transactions" } }, "type": "object", "required": [ "entity_addresses", "transactions" ], "title": "Body_flows_analyze_api_v1_security_flows_analyze_post" }, "Body_flows_compare_api_v1_security_flows_compare_post": { "properties": { "entity_a": { "additionalProperties": true, "type": "object", "title": "Entity A" }, "entity_b": { "additionalProperties": true, "type": "object", "title": "Entity B" }, "transactions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Transactions" } }, "type": "object", "required": [ "entity_a", "entity_b", "transactions" ], "title": "Body_flows_compare_api_v1_security_flows_compare_post" }, "BookmarkCreate": { "properties": { "address": { "type": "string", "maxLength": 255, "minLength": 1, "title": "Address" }, "post_id": { "type": "string", "maxLength": 255, "minLength": 1, "title": "Post Id" } }, "type": "object", "required": [ "address", "post_id" ], "title": "BookmarkCreate", "description": "Body for POST /bookmarks." }, "BookmarkOut": { "properties": { "id": { "type": "string", "title": "Id" }, "address": { "type": "string", "title": "Address" }, "post_id": { "type": "string", "title": "Post Id" }, "created_at": { "type": "string", "title": "Created At" } }, "type": "object", "required": [ "id", "address", "post_id", "created_at" ], "title": "BookmarkOut", "description": "A stored bookmark." }, "BookmarkResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/BookmarkOut" }, "type": "array", "title": "Items" } }, "type": "object", "title": "BookmarkResponse", "description": "List of bookmarks for an address." }, "BotAskRequest": { "properties": { "query": { "type": "string", "maxLength": 500, "minLength": 1, "title": "Query", "description": "Crypto question" }, "user_id": { "type": "string", "title": "User Id", "description": "Telegram user ID for rate limiting", "default": "telegram" } }, "type": "object", "required": [ "query" ], "title": "BotAskRequest" }, "BotScanRequest": { "properties": { "address": { "type": "string", "maxLength": 64, "minLength": 32, "title": "Address", "description": "Token contract address" }, "chain": { "type": "string", "title": "Chain", "description": "Blockchain (solana, ethereum, bsc, polygon)", "default": "solana" } }, "type": "object", "required": [ "address" ], "title": "BotScanRequest" }, "BridgeHealthRequest": { "properties": { "bridge": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Bridge", "description": "Optional bridge key to scan a single bridge only (e.g., 'stargate', 'wormhole', 'layerzero'). If omitted, scans all 12 bridges." }, "wallet": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet", "description": "Wallet address for payment tracking" } }, "type": "object", "title": "BridgeHealthRequest" }, "BridgeRequest": { "properties": { "room_id": { "type": "string", "title": "Room Id", "description": "Matrix room ID" }, "protocol": { "$ref": "#/components/schemas/Protocol", "description": "Protocol to bridge" } }, "type": "object", "required": [ "room_id", "protocol" ], "title": "BridgeRequest" }, "BulkAlertRequest": { "properties": { "tokens": { "items": { "type": "string" }, "type": "array", "maxItems": 50, "minItems": 1, "title": "Tokens" }, "alert_types": { "items": { "type": "string" }, "type": "array", "minItems": 1, "title": "Alert Types" }, "webhook_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Webhook Url" }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Email" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" } }, "type": "object", "required": [ "tokens", "alert_types" ], "title": "BulkAlertRequest", "description": "Bulk alert creation request." }, "BulkIngestRequest": { "properties": { "collection": { "type": "string", "title": "Collection", "default": "scam_intel" }, "items": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Items" } }, "type": "object", "title": "BulkIngestRequest" }, "BulkScheduleEntry": { "properties": { "text": { "type": "string", "maxLength": 64000, "minLength": 1, "title": "Text" }, "platforms": { "items": { "type": "string" }, "type": "array", "title": "Platforms" }, "scheduled_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scheduled At" }, "media_urls": { "items": { "type": "string" }, "type": "array", "title": "Media Urls" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "content_category": { "type": "string", "title": "Content Category", "default": "general" } }, "type": "object", "required": [ "text", "platforms" ], "title": "BulkScheduleEntry", "description": "A single entry in a bulk upload." }, "BulkScheduleResponse": { "properties": { "total": { "type": "integer", "title": "Total", "default": 0 }, "scheduled": { "type": "integer", "title": "Scheduled", "default": 0 }, "failed": { "type": "integer", "title": "Failed", "default": 0 }, "errors": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Errors" }, "posts": { "items": { "$ref": "#/components/schemas/ScheduledPost" }, "type": "array", "title": "Posts" } }, "type": "object", "title": "BulkScheduleResponse", "description": "Response from a bulk schedule operation." }, "BundleRequest": { "properties": { "address": { "type": "string", "title": "Address", "default": "" }, "token": { "type": "string", "title": "Token", "default": "" }, "wallet": { "type": "string", "title": "Wallet", "default": "" }, "chain": { "type": "string", "title": "Chain", "default": "base" }, "url": { "type": "string", "title": "Url", "default": "" } }, "type": "object", "title": "BundleRequest" }, "CachePutRequest": { "properties": { "value": { "type": "string", "title": "Value", "description": "Raw string value to store" }, "ttl": { "type": "integer", "maximum": 2592000.0, "minimum": 1.0, "title": "Ttl", "description": "TTL in seconds (1s - 30d)", "default": 300 } }, "type": "object", "required": [ "value" ], "title": "CachePutRequest", "description": "Body for PUT /cache/{key} \u2014 Redis SETEX." }, "CalendarDay": { "properties": { "date": { "type": "string", "title": "Date", "description": "ISO date string" }, "posts": { "items": { "$ref": "#/components/schemas/ScheduledPost" }, "type": "array", "title": "Posts" }, "post_count": { "type": "integer", "title": "Post Count", "default": 0 }, "has_gap": { "type": "boolean", "title": "Has Gap", "default": false }, "gap_days": { "type": "integer", "title": "Gap Days", "default": 0 } }, "type": "object", "required": [ "date" ], "title": "CalendarDay", "description": "A single day in the content calendar." }, "CalendarResponse": { "properties": { "start_date": { "type": "string", "title": "Start Date" }, "end_date": { "type": "string", "title": "End Date" }, "days": { "items": { "$ref": "#/components/schemas/CalendarDay" }, "type": "array", "title": "Days" }, "total_scheduled": { "type": "integer", "title": "Total Scheduled", "default": 0 }, "total_published": { "type": "integer", "title": "Total Published", "default": 0 }, "total_drafts": { "type": "integer", "title": "Total Drafts", "default": 0 }, "gaps": { "items": { "$ref": "#/components/schemas/CalendarDay" }, "type": "array", "title": "Gaps", "description": "Days with no posts scheduled" }, "platform_breakdown": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "Platform Breakdown" } }, "type": "object", "required": [ "start_date", "end_date" ], "title": "CalendarResponse", "description": "Content calendar for a date range." }, "CatalogResponse": { "properties": { "server": { "type": "string", "title": "Server", "default": "rugmunch-intelligence" }, "version": { "type": "string", "title": "Version", "default": "4.0" }, "tools": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Tools" }, "payment_protocol": { "type": "string", "title": "Payment Protocol", "default": "x402" } }, "type": "object", "title": "CatalogResponse" }, "ChartAnalysisRequest": { "properties": { "chain": { "type": "string", "maxLength": 32, "title": "Chain", "description": "Blockchain (solana, ethereum, base, bsc, etc.)", "default": "solana" }, "pair": { "type": "string", "maxLength": 128, "title": "Pair", "description": "Token pair address or contract address", "default": "" }, "symbol": { "type": "string", "maxLength": 64, "title": "Symbol", "description": "Token symbol (e.g. BONK)", "default": "" }, "name": { "type": "string", "maxLength": 256, "title": "Name", "description": "Token name", "default": "" }, "timeframe": { "type": "string", "maxLength": 8, "title": "Timeframe", "description": "Candle timeframe (1h, 4h, 1d, 7d)", "default": "1d" }, "current_price": { "type": "number", "title": "Current Price", "description": "Current/last price", "default": 0.0 }, "price_change_24h": { "type": "number", "title": "Price Change 24H", "description": "24h price change percentage", "default": 0.0 }, "volume_24h": { "type": "number", "title": "Volume 24H", "description": "24h volume USD", "default": 0.0 }, "liquidity_usd": { "type": "number", "title": "Liquidity Usd", "description": "Liquidity in USD", "default": 0.0 }, "fdv": { "type": "number", "title": "Fdv", "description": "Fully diluted valuation", "default": 0.0 }, "buys_24h": { "type": "integer", "title": "Buys 24H", "description": "24h buy transactions", "default": 0 }, "sells_24h": { "type": "integer", "title": "Sells 24H", "description": "24h sell transactions", "default": 0 }, "candles": { "items": { "$ref": "#/components/schemas/OHLCVCandle" }, "type": "array", "maxItems": 1500, "title": "Candles", "description": "OHLCV candle data for the timeframe" } }, "type": "object", "title": "ChartAnalysisRequest" }, "ChartAnalysisResponse": { "properties": { "success": { "type": "boolean", "title": "Success", "default": true }, "trend": { "type": "string", "title": "Trend", "default": "" }, "trend_strength": { "type": "integer", "title": "Trend Strength", "default": 0 }, "confidence": { "type": "integer", "title": "Confidence", "default": 0 }, "summary": { "type": "string", "title": "Summary", "default": "" }, "key_levels": { "items": { "$ref": "#/components/schemas/KeyLevel" }, "type": "array", "title": "Key Levels" }, "patterns_detected": { "items": { "type": "string" }, "type": "array", "title": "Patterns Detected" }, "risk_assessment": { "type": "string", "title": "Risk Assessment", "default": "" }, "trade_signal": { "type": "string", "title": "Trade Signal", "default": "" }, "detailed_analysis": { "type": "string", "title": "Detailed Analysis", "default": "" }, "indicators": { "additionalProperties": true, "type": "object", "title": "Indicators" }, "provider": { "type": "string", "title": "Provider", "default": "" } }, "type": "object", "title": "ChartAnalysisResponse" }, "ChatHistoryResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/ChatMessageOut" }, "type": "array", "title": "Items" } }, "type": "object", "title": "ChatHistoryResponse", "description": "List of chat messages for a room." }, "ChatMessageCreate": { "properties": { "room_id": { "type": "string", "maxLength": 255, "minLength": 1, "title": "Room Id" }, "sender": { "type": "string", "maxLength": 255, "minLength": 1, "title": "Sender" }, "content": { "type": "string", "maxLength": 100000, "minLength": 1, "title": "Content" } }, "type": "object", "required": [ "room_id", "sender", "content" ], "title": "ChatMessageCreate", "description": "Body for POST /chat-history." }, "ChatMessageOut": { "properties": { "id": { "type": "string", "title": "Id" }, "room_id": { "type": "string", "title": "Room Id" }, "sender": { "type": "string", "title": "Sender" }, "content": { "type": "string", "title": "Content" }, "created_at": { "type": "string", "title": "Created At" } }, "type": "object", "required": [ "id", "room_id", "sender", "content", "created_at" ], "title": "ChatMessageOut", "description": "A stored chat message." }, "ChatRequest": { "properties": { "message": { "type": "string", "maxLength": 2000, "minLength": 1, "title": "Message" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model", "description": "Specific model to use" }, "tier": { "type": "string", "pattern": "^(T0|T1|T2|T3|T4)$", "title": "Tier", "description": "AI model tier", "default": "T2" }, "temperature": { "type": "number", "maximum": 2.0, "minimum": 0.0, "title": "Temperature", "default": 0.7 }, "max_tokens": { "type": "integer", "maximum": 8192.0, "minimum": 64.0, "title": "Max Tokens", "default": 320 }, "context_override": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Context Override", "description": "Custom context injection. `system_context` (str) is appended to the system prompt." }, "history": { "anyOf": [ { "items": { "additionalProperties": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "title": "History", "description": "Explicit conversation history (user/assistant messages). When provided it OVERRIDES the DB-loaded history for this request (used by trusted server-side callers such as the Telegram bot, which must not read the shared anonymous history bucket)." } }, "type": "object", "required": [ "message" ], "title": "ChatRequest" }, "CheckoutRequest": { "properties": { "package": { "type": "string", "title": "Package", "default": "" }, "tier": { "type": "string", "title": "Tier", "default": "" }, "success_url": { "type": "string", "title": "Success Url", "default": "" }, "cancel_url": { "type": "string", "title": "Cancel Url", "default": "" }, "api_key": { "type": "string", "title": "Api Key", "default": "" }, "email": { "type": "string", "title": "Email", "default": "" } }, "type": "object", "title": "CheckoutRequest" }, "CommentCreate": { "properties": { "body": { "type": "string", "maxLength": 2000, "minLength": 1, "title": "Body" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Id" } }, "type": "object", "required": [ "body" ], "title": "CommentCreate" }, "CommentListResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/CommentOut" }, "type": "array", "title": "Items" }, "total": { "type": "integer", "title": "Total" } }, "type": "object", "required": [ "items", "total" ], "title": "CommentListResponse" }, "CommentOut": { "properties": { "id": { "type": "string", "title": "Id" }, "news_id": { "type": "string", "title": "News Id" }, "user_id": { "type": "string", "title": "User Id" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Id" }, "body": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Body" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "edited_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Edited At" }, "deleted": { "type": "boolean", "title": "Deleted", "default": false }, "like_count": { "type": "integer", "title": "Like Count", "default": 0 }, "dislike_count": { "type": "integer", "title": "Dislike Count", "default": 0 }, "my_reaction": { "anyOf": [ { "type": "string", "enum": [ "like", "dislike" ] }, { "type": "null" } ], "title": "My Reaction" }, "is_mine": { "type": "boolean", "title": "Is Mine", "default": false } }, "type": "object", "required": [ "id", "news_id", "user_id", "created_at" ], "title": "CommentOut" }, "CommentReactionResponse": { "properties": { "comment_id": { "type": "string", "title": "Comment Id" }, "like_count": { "type": "integer", "title": "Like Count", "default": 0 }, "dislike_count": { "type": "integer", "title": "Dislike Count", "default": 0 }, "my_reaction": { "anyOf": [ { "type": "string", "enum": [ "like", "dislike" ] }, { "type": "null" } ], "title": "My Reaction" } }, "type": "object", "required": [ "comment_id" ], "title": "CommentReactionResponse" }, "CommentRequest": { "properties": { "article_id": { "type": "string", "title": "Article Id" }, "author": { "type": "string", "title": "Author", "default": "anon" }, "content": { "type": "string", "title": "Content" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Id" } }, "type": "object", "required": [ "article_id", "content" ], "title": "CommentRequest" }, "CommentResponse": { "properties": { "id": { "type": "string", "title": "Id" }, "article_id": { "type": "string", "title": "Article Id" }, "author": { "type": "string", "title": "Author" }, "content": { "type": "string", "title": "Content" }, "created_at": { "type": "string", "title": "Created At" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Id" }, "likes": { "type": "integer", "title": "Likes", "default": 0 } }, "type": "object", "required": [ "id", "article_id", "author", "content", "created_at" ], "title": "CommentResponse" }, "ComposePreview": { "properties": { "platform_id": { "type": "string", "title": "Platform Id" }, "platform_name": { "type": "string", "title": "Platform Name" }, "icon": { "type": "string", "title": "Icon", "default": "\ud83c\udf10" }, "formatted_text": { "type": "string", "title": "Formatted Text", "default": "" }, "character_count": { "type": "integer", "title": "Character Count", "default": 0 }, "max_length": { "type": "integer", "title": "Max Length", "default": 280 }, "within_limit": { "type": "boolean", "title": "Within Limit", "default": true }, "media_count": { "type": "integer", "title": "Media Count", "default": 0 }, "media_accepted": { "type": "boolean", "title": "Media Accepted", "default": true }, "warnings": { "items": { "type": "string" }, "type": "array", "title": "Warnings" }, "preview_html": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Preview Html" } }, "type": "object", "required": [ "platform_id", "platform_name" ], "title": "ComposePreview", "description": "Preview of how a post appears on each target platform." }, "ComposeRequest": { "properties": { "text": { "type": "string", "maxLength": 64000, "minLength": 1, "title": "Text" }, "platforms": { "items": { "type": "string" }, "type": "array", "maxItems": 30, "minItems": 1, "title": "Platforms" }, "media_ids": { "items": { "type": "string" }, "type": "array", "title": "Media Ids", "description": "Media library IDs" }, "media_urls": { "items": { "type": "string" }, "type": "array", "title": "Media Urls" }, "tags": { "items": { "type": "string" }, "type": "array", "maxItems": 30, "title": "Tags" }, "content_category": { "type": "string", "title": "Content Category", "default": "general" }, "thread": { "items": { "type": "string" }, "type": "array", "title": "Thread" }, "link": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Link", "description": "Link to attach" }, "link_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Link Title" }, "link_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Link Description" }, "link_image": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Link Image" }, "poll_options": { "items": { "type": "string" }, "type": "array", "maxItems": 4, "title": "Poll Options" }, "poll_duration_hours": { "type": "integer", "maximum": 168.0, "minimum": 1.0, "title": "Poll Duration Hours", "default": 24 } }, "type": "object", "required": [ "text", "platforms" ], "title": "ComposeRequest", "description": "Request to compose a post across platforms." }, "ComposeResponse": { "properties": { "previews": { "items": { "$ref": "#/components/schemas/ComposePreview" }, "type": "array", "title": "Previews" }, "all_within_limits": { "type": "boolean", "title": "All Within Limits", "default": true }, "warnings": { "items": { "type": "string" }, "type": "array", "title": "Warnings" }, "suggestions": { "anyOf": [ { "$ref": "#/components/schemas/HashtagSuggestions" }, { "type": "null" } ] } }, "type": "object", "title": "ComposeResponse", "description": "Response from composing/previewing a post." }, "ConnectResponse": { "properties": { "success": { "type": "boolean", "title": "Success", "default": true }, "connection": { "$ref": "#/components/schemas/PlatformConnection" }, "message": { "type": "string", "title": "Message", "default": "Platform connected successfully" }, "onboarding_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Onboarding Url" } }, "type": "object", "required": [ "connection" ], "title": "ConnectResponse", "description": "Response after connecting a platform." }, "ConnectWalletRequest": { "properties": { "address": { "type": "string", "title": "Address", "description": "Wallet address" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" }, "signature": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Signature", "description": "Signed message for verification" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message", "description": "Message that was signed" }, "wallet_type": { "type": "string", "title": "Wallet Type", "description": "wallet type: metamask, phantom, rainbow, walletconnect, okx", "default": "evm" } }, "type": "object", "required": [ "address" ], "title": "ConnectWalletRequest" }, "ContentInsight": { "properties": { "category": { "type": "string", "title": "Category", "description": "media_type, video_length, posting_time, content_category, protocol_timing, recommendation", "default": "" }, "insight": { "type": "string", "title": "Insight", "description": "Human-readable insight like \"Your posts with images get 2.3x more engagement\"", "default": "" }, "metric": { "type": "string", "title": "Metric", "description": "The measured metric", "default": "" }, "improvement_factor": { "type": "number", "title": "Improvement Factor", "description": "Multiplier vs baseline (e.g. 2.3 means 2.3x)", "default": 0.0 }, "confidence": { "type": "number", "title": "Confidence", "description": "Statistical confidence 0-1", "default": 0.0 }, "sample_size": { "type": "integer", "title": "Sample Size", "description": "Number of data points", "default": 0 } }, "type": "object", "title": "ContentInsight", "description": "A single data-driven insight about content performance." }, "ContentInsightsResponse": { "properties": { "insights": { "items": { "$ref": "#/components/schemas/ContentInsight" }, "type": "array", "title": "Insights" }, "top_recommendations": { "items": { "type": "string" }, "type": "array", "title": "Top Recommendations" }, "generated_at": { "type": "string", "title": "Generated At", "default": "" } }, "type": "object", "title": "ContentInsightsResponse", "description": "AI-driven content improvement insights." }, "ContractAnalysisRequest": { "properties": { "chain": { "type": "string", "title": "Chain", "description": "Blockchain (solana, ethereum, bsc, base, etc.)" }, "address": { "type": "string", "title": "Address", "description": "Token contract address" }, "holder_data": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Holder Data", "description": "Holder distribution data" }, "scanner_data": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Scanner Data", "description": "Scanner results (risk scores, LP analysis)" } }, "type": "object", "required": [ "chain", "address" ], "title": "ContractAnalysisRequest" }, "ContractAnalysisResponse": { "properties": { "token_address": { "type": "string", "title": "Token Address" }, "chain": { "type": "string", "title": "Chain" }, "risk_score": { "type": "integer", "title": "Risk Score" }, "risk_level": { "type": "string", "title": "Risk Level" }, "ai_summary": { "type": "string", "title": "Ai Summary" }, "anomalies": { "items": { "$ref": "#/components/schemas/AnomalyReport" }, "type": "array", "title": "Anomalies" }, "identified_clusters": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Identified Clusters" }, "recommendations": { "items": { "type": "string" }, "type": "array", "title": "Recommendations" }, "analysis_source": { "type": "string", "title": "Analysis Source", "default": "rule-based" }, "ai_model": { "type": "string", "title": "Ai Model", "default": "" } }, "type": "object", "required": [ "token_address", "chain", "risk_score", "risk_level", "ai_summary" ], "title": "ContractAnalysisResponse" }, "ContractAnomalyRequest": { "properties": { "chain": { "type": "string", "title": "Chain" }, "address": { "type": "string", "title": "Address" }, "holder_data": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Holder Data" }, "scanner_data": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Scanner Data" } }, "type": "object", "required": [ "chain", "address" ], "title": "ContractAnomalyRequest" }, "ContractScanRequest": { "properties": { "contract_address": { "type": "string", "title": "Contract Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" }, "detect_clusters": { "type": "boolean", "title": "Detect Clusters", "default": true }, "detect_bundles": { "type": "boolean", "title": "Detect Bundles", "default": true } }, "type": "object", "required": [ "contract_address" ], "title": "ContractScanRequest" }, "CorrelationRequest": { "properties": { "addresses": { "items": { "type": "string" }, "type": "array", "maxItems": 20, "minItems": 1, "title": "Addresses" } }, "type": "object", "required": [ "addresses" ], "title": "CorrelationRequest" }, "CreateAPIKeyRequest": { "properties": { "name": { "type": "string", "title": "Name" }, "scopes": { "items": { "type": "string" }, "type": "array", "title": "Scopes" }, "expires_days": { "type": "integer", "title": "Expires Days", "default": 30 } }, "type": "object", "required": [ "name" ], "title": "CreateAPIKeyRequest" }, "CreateAdminRequest": { "properties": { "email": { "type": "string", "title": "Email" }, "password": { "type": "string", "title": "Password" }, "role": { "type": "string", "title": "Role", "default": "viewer" } }, "type": "object", "required": [ "email", "password" ], "title": "CreateAdminRequest" }, "CreateDMRequest": { "properties": { "recipient_id": { "type": "string", "title": "Recipient Id", "description": "User ID of the recipient" }, "room_name": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Room Name", "description": "Optional room name" } }, "type": "object", "required": [ "recipient_id" ], "title": "CreateDMRequest" }, "CreateEventRequest": { "properties": { "title": { "type": "string", "maxLength": 255, "minLength": 1, "title": "Title" }, "description": { "type": "string", "maxLength": 5000, "minLength": 1, "title": "Description" }, "event_type": { "type": "string", "pattern": "^(ama|music|trading|interview|other)$", "title": "Event Type" }, "scheduled_at": { "type": "string", "title": "Scheduled At" }, "duration_minutes": { "type": "integer", "maximum": 480.0, "minimum": 15.0, "title": "Duration Minutes", "default": 60 }, "hashtag": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "title": "Hashtag" }, "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumbnail Url" }, "max_viewers": { "anyOf": [ { "type": "integer", "maximum": 100000.0, "minimum": 1.0 }, { "type": "null" } ], "title": "Max Viewers" } }, "type": "object", "required": [ "title", "description", "event_type", "scheduled_at" ], "title": "CreateEventRequest" }, "CreateGroupRequest": { "properties": { "name": { "type": "string", "maxLength": 200, "minLength": 1, "title": "Name", "description": "Group chat name" }, "member_ids": { "items": { "type": "string" }, "type": "array", "maxItems": 100, "minItems": 1, "title": "Member Ids", "description": "Initial members" }, "topic": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ], "title": "Topic", "description": "Group topic" } }, "type": "object", "required": [ "name", "member_ids" ], "title": "CreateGroupRequest" }, "CreateKeyRequest": { "properties": { "email": { "type": "string", "title": "Email" }, "name": { "type": "string", "title": "Name", "default": "" }, "tier": { "type": "string", "title": "Tier", "default": "free" }, "wallet_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Address" } }, "type": "object", "required": [ "email" ], "title": "CreateKeyRequest" }, "CrossChainRequest": { "properties": { "fingerprints": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "minItems": 2, "title": "Fingerprints", "description": "Chain fingerprints" }, "chains": { "items": { "type": "string" }, "type": "array", "title": "Chains", "default": [ "ethereum", "base", "solana" ] } }, "type": "object", "required": [ "fingerprints" ], "title": "CrossChainRequest" }, "CrossProtocolSummary": { "properties": { "comparisons": { "items": { "$ref": "#/components/schemas/ProtocolComparison" }, "type": "array", "title": "Comparisons" }, "best_protocol_for_reach": { "type": "string", "title": "Best Protocol For Reach", "default": "" }, "best_protocol_for_engagement": { "type": "string", "title": "Best Protocol For Engagement", "default": "" }, "best_protocol_for_tips": { "type": "string", "title": "Best Protocol For Tips", "default": "" }, "total_cross_protocol_views": { "type": "integer", "title": "Total Cross Protocol Views", "default": 0 }, "total_unique_viewers": { "type": "integer", "title": "Total Unique Viewers", "default": 0 }, "period": { "type": "string", "title": "Period", "default": "7d" } }, "type": "object", "title": "CrossProtocolSummary", "description": "Cross-protocol analytics comparing all protocols." }, "CrosspostOut": { "properties": { "id": { "type": "string", "title": "Id" }, "newsletter_id": { "type": "string", "title": "Newsletter Id" }, "platform": { "type": "string", "title": "Platform" }, "platform_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Platform Url" }, "platform_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Platform Id" }, "status": { "type": "string", "title": "Status", "default": "pending" }, "error_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error Message" }, "published_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Published At" } }, "type": "object", "required": [ "id", "newsletter_id", "platform" ], "title": "CrosspostOut", "description": "Response body for a cross-platform publication record." }, "CryptoSubscribeRequest": { "properties": { "newsletter_id": { "type": "string", "title": "Newsletter Id", "description": "Newsletter ID to subscribe to" }, "email": { "anyOf": [ { "type": "string", "maxLength": 320 }, { "type": "null" } ], "title": "Email", "description": "Email address" }, "wallet_address": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ], "title": "Wallet Address", "description": "Crypto wallet address" }, "protocol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Protocol", "description": "nostr | farcaster | bluesky | mastodon | lens" }, "protocol_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Protocol Id", "description": "Decentralized identity (npub, FID, DID, handle)" }, "tier": { "type": "string", "title": "Tier", "description": "free | monthly | annual | founding", "default": "free" }, "interests": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Interests" }, "referrer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Referrer" }, "chain": { "type": "string", "title": "Chain", "description": "eth | sol | base | polygon | lightning" }, "token": { "type": "string", "title": "Token", "description": "ETH | USDC | SOL | USDT | BTC" }, "tx_hash": { "type": "string", "minLength": 10, "title": "Tx Hash", "description": "On-chain transaction hash" }, "from_address": { "type": "string", "minLength": 10, "title": "From Address", "description": "Sender wallet address" } }, "additionalProperties": false, "type": "object", "required": [ "newsletter_id", "chain", "token", "tx_hash", "from_address" ], "title": "CryptoSubscribeRequest", "description": "Request body for subscribing with a crypto payment." }, "DeliveryStatusOut": { "properties": { "newsletter_id": { "type": "string", "title": "Newsletter Id" }, "total_sent": { "type": "integer", "title": "Total Sent", "default": 0 }, "total_delivered": { "type": "integer", "title": "Total Delivered", "default": 0 }, "total_opened": { "type": "integer", "title": "Total Opened", "default": 0 }, "total_clicked": { "type": "integer", "title": "Total Clicked", "default": 0 }, "total_bounced": { "type": "integer", "title": "Total Bounced", "default": 0 }, "total_failed": { "type": "integer", "title": "Total Failed", "default": 0 }, "open_rate": { "type": "number", "title": "Open Rate", "default": 0.0 }, "click_rate": { "type": "number", "title": "Click Rate", "default": 0.0 }, "delivery_rate": { "type": "number", "title": "Delivery Rate", "default": 0.0 } }, "type": "object", "required": [ "newsletter_id" ], "title": "DeliveryStatusOut", "description": "Delivery stats for a newsletter." }, "DeployerProfileResponse": { "properties": { "success": { "type": "boolean", "title": "Success", "default": true }, "profile": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Profile" }, "is_factory": { "type": "boolean", "title": "Is Factory", "default": false }, "real_deployer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Real Deployer" } }, "type": "object", "title": "DeployerProfileResponse", "description": "Deployer profile response." }, "DequeueResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/QueueItem" }, "type": "array", "title": "Items" } }, "type": "object", "title": "DequeueResponse", "description": "Up to N dequeued jobs." }, "DifyChatRequest": { "properties": { "query": { "type": "string", "title": "Query" }, "conversation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Conversation Id" } }, "type": "object", "required": [ "query" ], "title": "DifyChatRequest" }, "DropOffPoint": { "properties": { "second": { "type": "number", "title": "Second", "description": "Timestamp in seconds", "default": 0.0 }, "percentage": { "type": "number", "title": "Percentage", "description": "% through content", "default": 0.0 }, "viewers_lost": { "type": "integer", "title": "Viewers Lost", "description": "Viewers who dropped at this point", "default": 0 }, "drop_pct": { "type": "number", "title": "Drop Pct", "description": "% of total viewers who dropped here", "default": 0.0 } }, "type": "object", "title": "DropOffPoint", "description": "Where viewers stopped watching." }, "EmailLoginRequest": { "properties": { "email": { "type": "string", "title": "Email" }, "password": { "type": "string", "title": "Password" } }, "type": "object", "required": [ "email", "password" ], "title": "EmailLoginRequest" }, "EmailRegisterRequest": { "properties": { "email": { "type": "string", "title": "Email" }, "password": { "type": "string", "title": "Password" }, "display_name": { "type": "string", "title": "Display Name" }, "wallet_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Address" }, "wallet_chain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Chain" } }, "type": "object", "required": [ "email", "password", "display_name" ], "title": "EmailRegisterRequest" }, "EngagementAnalyticsDetail": { "properties": { "post_id": { "type": "string", "title": "Post Id", "default": "" }, "post_title": { "type": "string", "title": "Post Title", "default": "" }, "content_type": { "type": "string", "title": "Content Type", "default": "" }, "summary": { "$ref": "#/components/schemas/EngagementAnalyticsSummary" }, "protocol_breakdown": { "additionalProperties": { "$ref": "#/components/schemas/EngagementAnalyticsSummary" }, "type": "object", "title": "Protocol Breakdown" }, "top_comments": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Top Comments" } }, "type": "object", "title": "EngagementAnalyticsDetail", "description": "Detailed per-post engagement analytics." }, "EngagementAnalyticsSummary": { "properties": { "total_engagements": { "type": "integer", "title": "Total Engagements", "description": "Total engagement actions", "default": 0 }, "unique_engagers": { "type": "integer", "title": "Unique Engagers", "description": "Unique people who engaged", "default": 0 }, "likes": { "type": "integer", "title": "Likes", "description": "Unique likes", "default": 0 }, "unique_likers": { "type": "integer", "title": "Unique Likers", "description": "Unique people who liked", "default": 0 }, "comments": { "type": "integer", "title": "Comments", "description": "Total comments", "default": 0 }, "unique_commenters": { "type": "integer", "title": "Unique Commenters", "description": "Unique people who commented", "default": 0 }, "comment_sentiment_positive": { "type": "integer", "title": "Comment Sentiment Positive", "description": "Positive comments", "default": 0 }, "comment_sentiment_neutral": { "type": "integer", "title": "Comment Sentiment Neutral", "description": "Neutral comments", "default": 0 }, "comment_sentiment_negative": { "type": "integer", "title": "Comment Sentiment Negative", "description": "Negative comments", "default": 0 }, "average_sentiment_score": { "type": "number", "title": "Average Sentiment Score", "description": "-1.0 to 1.0", "default": 0.0 }, "reposts": { "type": "integer", "title": "Reposts", "description": "Total reposts/shares across protocols", "default": 0 }, "total_tips_usd": { "type": "number", "title": "Total Tips Usd", "description": "Total tips in USD", "default": 0.0 }, "total_tips_token": { "type": "number", "title": "Total Tips Token", "description": "Total tips in token amounts", "default": 0.0 }, "average_tip_usd": { "type": "number", "title": "Average Tip Usd", "description": "Average tip amount in USD", "default": 0.0 }, "tip_count": { "type": "integer", "title": "Tip Count", "description": "Number of tips", "default": 0 }, "tip_velocity": { "type": "number", "title": "Tip Velocity", "description": "Tips per day", "default": 0.0 }, "top_tip_token": { "type": "string", "title": "Top Tip Token", "description": "Most used tip token", "default": "" }, "followers_gained": { "type": "integer", "title": "Followers Gained", "description": "Followers gained from this content", "default": 0 }, "click_through_rate": { "type": "number", "title": "Click Through Rate", "description": "CTR as % (0-100)", "default": 0.0 }, "total_clicks": { "type": "integer", "title": "Total Clicks", "description": "Total link clicks", "default": 0 }, "saves": { "type": "integer", "title": "Saves", "description": "Save/bookmark count", "default": 0 }, "save_rate": { "type": "number", "title": "Save Rate", "description": "Save rate as % of viewers", "default": 0.0 }, "average_read_time_seconds": { "type": "number", "title": "Average Read Time Seconds", "description": "Average time spent reading", "default": 0.0 }, "read_completion_rate": { "type": "number", "title": "Read Completion Rate", "description": "% who finished reading", "default": 0.0 }, "period": { "type": "string", "title": "Period", "default": "7d" } }, "type": "object", "title": "EngagementAnalyticsSummary", "description": "Engagement metrics for a creator or post." }, "EnqueueRequest": { "properties": { "queue": { "type": "string", "enum": [ "sync", "offline", "premium", "scheduled", "bridgy:users", "bridgy:config" ], "title": "Queue" }, "key": { "type": "string", "maxLength": 512, "minLength": 1, "title": "Key" }, "payload": { "additionalProperties": true, "type": "object", "title": "Payload" } }, "type": "object", "required": [ "queue", "key" ], "title": "EnqueueRequest", "description": "Body for POST /queue/enqueue." }, "EnqueueResponse": { "properties": { "ok": { "type": "boolean", "title": "Ok" }, "id": { "type": "string", "title": "Id" } }, "type": "object", "required": [ "ok", "id" ], "title": "EnqueueResponse", "description": "Acknowledged enqueue with the generated job id." }, "ErrorResponse": { "properties": { "error": { "type": "string", "title": "Error" }, "detail": { "type": "string", "title": "Detail" } }, "type": "object", "required": [ "error", "detail" ], "title": "ErrorResponse" }, "EvaluateRequest": { "properties": { "test_set": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "title": "Test Set", "description": "Custom test set: [{question, ground_truth}]. Defaults to the RugBrain golden set." }, "collection": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Collection", "description": "Collection to evaluate against (default: threat_intel_v2)." } }, "type": "object", "title": "EvaluateRequest", "description": "Ragas evaluation request for the RAG pipeline." }, "EventResponse": { "properties": { "accepted": { "type": "boolean", "title": "Accepted", "default": true }, "message": { "type": "string", "title": "Message", "default": "Event recorded" } }, "type": "object", "title": "EventResponse", "description": "Response for event ingestion." }, "ExamSubmit": { "properties": { "answers": { "items": { "$ref": "#/components/schemas/QuizAnswer" }, "type": "array", "title": "Answers" }, "time_spent_seconds": { "type": "integer", "title": "Time Spent Seconds", "default": 0 } }, "type": "object", "required": [ "answers" ], "title": "ExamSubmit" }, "ExportResponse": { "properties": { "download_url": { "type": "string", "title": "Download Url", "default": "" }, "format": { "type": "string", "title": "Format", "default": "" }, "generated_at": { "type": "string", "title": "Generated At", "default": "" }, "size_bytes": { "type": "integer", "title": "Size Bytes", "default": 0 }, "expires_at": { "type": "string", "title": "Expires At", "default": "" } }, "type": "object", "title": "ExportResponse", "description": "Analytics export response." }, "ExtractRequest": { "properties": { "url": { "type": "string", "title": "Url", "description": "The URL to extract from" }, "json_schema": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "title": "Json Schema", "description": "Structured extraction schema" }, "timeout": { "type": "integer", "maximum": 120.0, "minimum": 5.0, "title": "Timeout", "description": "Extraction timeout in seconds", "default": 30 }, "bypass_cloudflare": { "type": "boolean", "title": "Bypass Cloudflare", "description": "Auto-bypass Cloudflare", "default": true }, "js_render": { "type": "boolean", "title": "Js Render", "description": "Render JavaScript before extraction", "default": false } }, "type": "object", "required": [ "url" ], "title": "ExtractRequest", "description": "Request body for POST /api/v1/extract." }, "FearIndexResponse": { "properties": { "overall_risk": { "type": "number", "title": "Overall Risk" }, "exploit_risk": { "type": "number", "title": "Exploit Risk" }, "regulatory_risk": { "type": "number", "title": "Regulatory Risk" }, "stablecoin_risk": { "type": "number", "title": "Stablecoin Risk" }, "exchange_risk": { "type": "number", "title": "Exchange Risk" }, "generated_at": { "type": "string", "title": "Generated At" } }, "type": "object", "required": [ "overall_risk", "exploit_risk", "regulatory_risk", "stablecoin_risk", "exchange_risk", "generated_at" ], "title": "FearIndexResponse" }, "FeedResponse": { "properties": { "protocol": { "type": "string", "title": "Protocol" }, "page": { "type": "integer", "title": "Page" }, "has_more": { "type": "boolean", "title": "Has More", "default": false }, "posts": { "items": { "$ref": "#/components/schemas/PostResponse" }, "type": "array", "title": "Posts" }, "cached": { "type": "boolean", "title": "Cached", "default": false } }, "type": "object", "required": [ "protocol", "page" ], "title": "FeedResponse", "description": "Paginated feed response." }, "FeedbackRecord": { "properties": { "token_address": { "type": "string", "title": "Token Address" }, "chain": { "type": "string", "title": "Chain", "default": "" }, "risk_score": { "type": "number", "title": "Risk Score", "default": 0.0 }, "risk_flags": { "items": { "type": "string" }, "type": "array", "title": "Risk Flags" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "token_address" ], "title": "FeedbackRecord", "description": "Scanner feedback record \u2014 ingests known scam data." }, "FindRiskyTokensRequest": { "properties": { "min_rug_count": { "type": "integer", "minimum": 1.0, "title": "Min Rug Count", "default": 1 }, "chain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Chain" }, "limit": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "title": "Limit", "default": 50 } }, "type": "object", "title": "FindRiskyTokensRequest" }, "FollowerSummary": { "properties": { "follower_handle": { "type": "string", "title": "Follower Handle", "default": "" }, "follower_wallet": { "type": "string", "title": "Follower Wallet", "default": "" }, "protocol": { "type": "string", "title": "Protocol", "default": "" }, "engagement_score": { "type": "number", "title": "Engagement Score", "default": 0.0 }, "total_views": { "type": "integer", "title": "Total Views", "default": 0 }, "total_tips_usd": { "type": "number", "title": "Total Tips Usd", "default": 0.0 }, "total_engagements": { "type": "integer", "title": "Total Engagements", "default": 0 }, "followed_since": { "type": "string", "title": "Followed Since", "default": "" } }, "type": "object", "title": "FollowerSummary", "description": "Summary of a single follower's engagement." }, "FundingPathRequest": { "properties": { "source": { "type": "string", "title": "Source" }, "target": { "type": "string", "title": "Target" }, "max_depth": { "type": "integer", "title": "Max Depth", "default": 5 } }, "type": "object", "required": [ "source", "target" ], "title": "FundingPathRequest" }, "GapAnalysisResponse": { "properties": { "gaps": { "items": { "$ref": "#/components/schemas/GapEntry" }, "type": "array", "title": "Gaps" }, "platform_summary": { "additionalProperties": { "$ref": "#/components/schemas/GapSummary" }, "type": "object", "title": "Platform Summary" }, "overall_health": { "type": "string", "title": "Overall Health", "description": "good, warning, critical", "default": "good" }, "recommendations": { "items": { "type": "string" }, "type": "array", "title": "Recommendations" } }, "type": "object", "title": "GapAnalysisResponse", "description": "Content gap analysis across platforms." }, "GapEntry": { "properties": { "platform_id": { "type": "string", "title": "Platform Id" }, "platform_name": { "type": "string", "title": "Platform Name" }, "days_since_last_post": { "type": "integer", "title": "Days Since Last Post" }, "status": { "type": "string", "title": "Status", "description": "ok, warning, critical", "default": "ok" }, "recommended_action": { "type": "string", "title": "Recommended Action", "default": "" } }, "type": "object", "required": [ "platform_id", "platform_name", "days_since_last_post" ], "title": "GapEntry", "description": "A gap in posting for a specific platform." }, "GapSummary": { "properties": { "last_post": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Post" }, "days_since_last": { "type": "integer", "title": "Days Since Last", "default": 0 }, "posts_this_week": { "type": "integer", "title": "Posts This Week", "default": 0 }, "posts_this_month": { "type": "integer", "title": "Posts This Month", "default": 0 }, "avg_posts_per_week": { "type": "number", "title": "Avg Posts Per Week", "default": 0.0 }, "gap_status": { "type": "string", "title": "Gap Status", "default": "ok" } }, "type": "object", "title": "GapSummary", "description": "Posting gap summary for a platform." }, "GenerateRequest": { "properties": { "subject_type": { "type": "string", "pattern": "^(token|wallet)$", "title": "Subject Type" }, "subject_id": { "type": "string", "title": "Subject Id", "description": "\"chain:address\"" }, "model": { "type": "string", "title": "Model", "default": "deepseek-v3" }, "save": { "type": "boolean", "title": "Save", "default": true } }, "type": "object", "required": [ "subject_type", "subject_id" ], "title": "GenerateRequest" }, "GenerateResponse": { "properties": { "report_id": { "type": "string", "title": "Report Id" }, "subject_type": { "type": "string", "title": "Subject Type" }, "subject_id": { "type": "string", "title": "Subject Id" }, "risk_score": { "type": "integer", "title": "Risk Score" }, "risk_tier": { "type": "string", "title": "Risk Tier" }, "risk_factors": { "items": { "type": "string" }, "type": "array", "title": "Risk Factors" }, "generated_by_model": { "type": "string", "title": "Generated By Model" }, "generated_at": { "type": "string", "title": "Generated At" }, "sections": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Sections" }, "markdown": { "type": "string", "title": "Markdown" }, "paid_via_x402": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Paid Via X402" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" } }, "type": "object", "required": [ "report_id", "subject_type", "subject_id", "risk_score", "risk_tier", "generated_by_model", "generated_at", "markdown" ], "title": "GenerateResponse" }, "GenericDataRequest": { "properties": { "data_type": { "type": "string", "title": "Data Type" }, "address": { "type": "string", "title": "Address", "default": "" }, "mint": { "type": "string", "title": "Mint", "default": "" }, "chain": { "type": "string", "title": "Chain", "default": "solana" }, "query": { "type": "string", "title": "Query", "default": "" }, "category": { "type": "string", "title": "Category", "default": "" }, "chain_id": { "type": "string", "title": "Chain Id", "default": "1" }, "admin_key": { "type": "string", "title": "Admin Key", "default": "" }, "force_fresh": { "type": "boolean", "title": "Force Fresh", "default": false } }, "type": "object", "required": [ "data_type" ], "title": "GenericDataRequest" }, "GenericRequest": { "properties": { "address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" }, "token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Token" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Query" }, "hours": { "type": "integer", "title": "Hours", "default": 24 }, "threshold": { "type": "number", "title": "Threshold", "default": 10000.0 }, "limit": { "type": "integer", "title": "Limit", "default": 20 } }, "type": "object", "title": "GenericRequest" }, "GlitchtipTestRequest": { "properties": { "type": { "type": "string", "title": "Type", "default": "error" }, "message": { "type": "string", "title": "Message", "default": "test event from RMI" }, "secret": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Secret" } }, "type": "object", "title": "GlitchtipTestRequest" }, "GraphAnalyzeRequest": { "properties": { "transactions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "maxItems": 1000, "minItems": 2, "title": "Transactions" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" }, "analysis_types": { "items": { "type": "string" }, "type": "array", "title": "Analysis Types", "default": [ "clusters", "flows", "anomalies" ] } }, "type": "object", "required": [ "transactions" ], "title": "GraphAnalyzeRequest" }, "GraphVerifyRequest": { "properties": { "report_id": { "type": "string", "minLength": 1, "title": "Report Id" }, "graph_data": { "additionalProperties": true, "type": "object", "title": "Graph Data" } }, "type": "object", "required": [ "report_id" ], "title": "GraphVerifyRequest" }, "GrowthAnalytics": { "properties": { "daily_growth": { "items": { "$ref": "#/components/schemas/app__domains__analytics__models__DataPoint" }, "type": "array", "title": "Daily Growth" }, "weekly_growth": { "items": { "$ref": "#/components/schemas/app__domains__analytics__models__DataPoint" }, "type": "array", "title": "Weekly Growth" }, "monthly_growth": { "items": { "$ref": "#/components/schemas/app__domains__analytics__models__DataPoint" }, "type": "array", "title": "Monthly Growth" }, "protocol_growth": { "additionalProperties": { "items": { "$ref": "#/components/schemas/app__domains__analytics__models__DataPoint" }, "type": "array" }, "type": "object", "title": "Protocol Growth" }, "acquisition_channels": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Acquisition Channels" } }, "type": "object", "title": "GrowthAnalytics", "description": "Audience growth over time." }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "HashtagSuggestions": { "properties": { "platform_suggestions": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "type": "object", "title": "Platform Suggestions" }, "trending_tags": { "items": { "type": "string" }, "type": "array", "title": "Trending Tags" }, "recommended": { "items": { "type": "string" }, "type": "array", "title": "Recommended" } }, "type": "object", "title": "HashtagSuggestions", "description": "AI-generated hashtag suggestions per platform." }, "HistoryRequest": { "properties": { "address": { "type": "string", "title": "Address", "description": "Token or wallet address" }, "chain": { "type": "string", "title": "Chain", "default": "base" }, "hours": { "type": "integer", "maximum": 168.0, "minimum": 1.0, "title": "Hours", "description": "Lookback window in hours (max 168)", "default": 24 } }, "type": "object", "required": [ "address" ], "title": "HistoryRequest", "description": "Historical data request with lookback window." }, "HolderClusterRequest": { "properties": { "token_address": { "type": "string", "title": "Token Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" }, "holders": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "title": "Holders" } }, "type": "object", "required": [ "token_address" ], "title": "HolderClusterRequest" }, "HomeResponse": { "properties": { "service": { "type": "string", "title": "Service" }, "version": { "type": "string", "title": "Version" }, "docs": { "type": "string", "title": "Docs", "default": "/docs" }, "openapi": { "type": "string", "title": "Openapi", "default": "/openapi.json" }, "health": { "type": "string", "title": "Health", "default": "/health" }, "metrics": { "type": "string", "title": "Metrics", "default": "/metrics" } }, "type": "object", "required": [ "service", "version" ], "title": "HomeResponse", "description": "Landing page response." }, "IdentityPut": { "properties": { "address": { "type": "string", "maxLength": 255, "minLength": 1, "title": "Address" }, "data": { "additionalProperties": true, "type": "object", "title": "Data" } }, "type": "object", "required": [ "address" ], "title": "IdentityPut", "description": "Body for POST /identities \u2014 upsert address \u2192 JSON blob." }, "IncidentReport": { "properties": { "service": { "type": "string", "title": "Service" }, "severity": { "type": "string", "title": "Severity", "default": "minor" }, "message": { "type": "string", "title": "Message" }, "resolved": { "type": "boolean", "title": "Resolved", "default": false } }, "type": "object", "required": [ "service", "message" ], "title": "IncidentReport" }, "IngestNewsRequest": { "properties": { "title": { "type": "string", "maxLength": 1024, "minLength": 1, "title": "Title", "description": "Article title" }, "body": { "type": "string", "minLength": 1, "title": "Body", "description": "Article body / content" }, "source_url": { "type": "string", "title": "Source Url", "description": "Original article URL" }, "source_name": { "type": "string", "title": "Source Name", "description": "Source publication name", "default": "" }, "published_at": { "type": "string", "title": "Published At", "description": "ISO-8601 publish timestamp", "default": "" }, "categories": { "items": { "type": "string" }, "type": "array", "title": "Categories", "description": "Topic categories" }, "sentiment": { "type": "number", "maximum": 1.0, "minimum": -1.0, "title": "Sentiment", "description": "Sentiment score -1..1", "default": 0.0 } }, "type": "object", "required": [ "title", "body", "source_url" ], "title": "IngestNewsRequest", "description": "Request body for POST /api/v1/rag/ingest-news." }, "IngestRequest": { "properties": { "collection": { "type": "string", "title": "Collection", "default": "scam_intel" }, "doc_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Doc Id" }, "content": { "type": "string", "minLength": 1, "title": "Content" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "content" ], "title": "IngestRequest", "description": "RAG ingest request." }, "IngestResult": { "properties": { "doc_id": { "type": "string", "title": "Doc Id", "default": "" }, "collection": { "type": "string", "title": "Collection", "default": "" }, "status": { "type": "string", "title": "Status", "default": "" }, "error": { "type": "string", "title": "Error", "default": "" } }, "type": "object", "title": "IngestResult", "description": "Result of an ingest operation." }, "InsiderRequest": { "properties": { "creator_address": { "type": "string", "title": "Creator Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "creator_address" ], "title": "InsiderRequest" }, "IntelSignalResponse": { "properties": { "signal_type": { "type": "string", "title": "Signal Type" }, "severity": { "type": "string", "title": "Severity" }, "headline": { "type": "string", "title": "Headline" }, "insight": { "type": "string", "title": "Insight" }, "action": { "type": "string", "title": "Action" }, "confidence": { "type": "number", "title": "Confidence" }, "generated_at": { "type": "string", "title": "Generated At" } }, "type": "object", "required": [ "signal_type", "severity", "headline", "insight", "action", "confidence", "generated_at" ], "title": "IntelSignalResponse" }, "IntelligenceFeedResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/IntelligenceItem" }, "type": "array", "title": "Items" }, "count": { "type": "integer", "title": "Count" }, "timestamp": { "type": "string", "title": "Timestamp" } }, "type": "object", "required": [ "items", "count", "timestamp" ], "title": "IntelligenceFeedResponse" }, "IntelligenceItem": { "properties": { "id": { "type": "string", "title": "Id" }, "title": { "type": "string", "title": "Title" }, "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url" }, "source": { "type": "string", "title": "Source" }, "published_at": { "type": "string", "title": "Published At" }, "category": { "type": "string", "title": "Category" }, "kind": { "type": "string", "title": "Kind" }, "highlight": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Highlight", "default": false }, "severity": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" } }, "type": "object", "required": [ "id", "title", "source", "published_at", "category", "kind" ], "title": "IntelligenceItem" }, "InvestigationRequest": { "properties": { "address": { "type": "string", "title": "Address", "description": "Target address, token, or wallet" }, "chain": { "type": "string", "title": "Chain", "default": "base" }, "depth": { "type": "string", "title": "Depth", "description": "standard | deep | forensic", "default": "standard" } }, "type": "object", "required": [ "address" ], "title": "InvestigationRequest" }, "InviteRequest": { "properties": { "user_id": { "type": "string", "title": "User Id", "description": "User ID to invite" } }, "type": "object", "required": [ "user_id" ], "title": "InviteRequest" }, "JsonRpcRequest": { "properties": { "jsonrpc": { "type": "string", "title": "Jsonrpc", "default": "2.0" }, "method": { "type": "string", "title": "Method" }, "params": { "additionalProperties": true, "type": "object", "title": "Params", "default": {} }, "id": { "anyOf": [ { "type": "integer" }, { "type": "string" }, { "type": "null" } ], "title": "Id" } }, "type": "object", "required": [ "method" ], "title": "JsonRpcRequest" }, "KeyExchangeRequest": { "properties": { "peer_id": { "type": "string", "title": "Peer Id", "description": "Peer user ID for key exchange" } }, "type": "object", "required": [ "peer_id" ], "title": "KeyExchangeRequest" }, "KeyLevel": { "properties": { "price": { "type": "number", "title": "Price" }, "label": { "type": "string", "title": "Label" }, "strength": { "type": "string", "title": "Strength", "default": "medium" } }, "type": "object", "required": [ "price", "label" ], "title": "KeyLevel" }, "KeyRotateRequest": { "properties": { "peer_id": { "type": "string", "title": "Peer Id", "description": "Peer user ID for key rotation" } }, "type": "object", "required": [ "peer_id" ], "title": "KeyRotateRequest" }, "KeyVerifyRequest": { "properties": { "peer_id": { "type": "string", "title": "Peer Id", "description": "Peer user ID" }, "fingerprint": { "type": "string", "title": "Fingerprint", "description": "Safety number fingerprint from peer" } }, "type": "object", "required": [ "peer_id", "fingerprint" ], "title": "KeyVerifyRequest" }, "KnowledgeResult": { "properties": { "answer": { "type": "string", "title": "Answer", "description": "Direct answer to the user query" }, "sources": { "items": { "type": "string" }, "type": "array", "title": "Sources", "description": "RAG source identifiers" }, "confidence": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Confidence", "description": "Model confidence in the answer" }, "related_exploits": { "items": { "type": "string" }, "type": "array", "title": "Related Exploits", "description": "Related known exploit patterns" } }, "type": "object", "required": [ "answer", "confidence" ], "title": "KnowledgeResult", "description": "Structured knowledge-grounded answer from the RAG Agent." }, "KvPutRequest": { "properties": { "value": { "type": "string", "title": "Value", "description": "Raw string value to store" } }, "type": "object", "required": [ "value" ], "title": "KvPutRequest", "description": "Body for PUT /kv/{namespace}/{key} \u2014 Postgres upsert." }, "LabelLookupRequest": { "properties": { "addresses": { "items": { "type": "string" }, "type": "array", "maxItems": 10, "minItems": 1, "title": "Addresses" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" } }, "type": "object", "required": [ "addresses" ], "title": "LabelLookupRequest" }, "LessonComplete": { "properties": { "lesson_id": { "type": "string", "title": "Lesson Id" }, "course_id": { "type": "string", "title": "Course Id" }, "score": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Score" }, "time_spent_seconds": { "type": "integer", "title": "Time Spent Seconds", "default": 0 }, "answers": { "anyOf": [ { "items": { "$ref": "#/components/schemas/QuizAnswer" }, "type": "array" }, { "type": "null" } ], "title": "Answers" } }, "type": "object", "required": [ "lesson_id", "course_id" ], "title": "LessonComplete" }, "LivenessResponse": { "properties": { "status": { "type": "string", "title": "Status", "default": "alive" } }, "type": "object", "title": "LivenessResponse" }, "LocalChatRequest": { "properties": { "message": { "type": "string", "maxLength": 2000, "title": "Message" }, "history": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "History" }, "mode": { "type": "string", "enum": [ "quick", "deep" ], "title": "Mode", "default": "quick" }, "max_tokens": { "type": "integer", "maximum": 4096.0, "minimum": 64.0, "title": "Max Tokens", "default": 1024 } }, "type": "object", "required": [ "message" ], "title": "LocalChatRequest" }, "LocalChatResponse": { "properties": { "message": { "type": "string", "title": "Message" }, "model": { "type": "string", "title": "Model" }, "provider": { "type": "string", "title": "Provider" }, "mode": { "type": "string", "title": "Mode" }, "latency_ms": { "type": "integer", "title": "Latency Ms" } }, "type": "object", "required": [ "message", "model", "provider", "mode", "latency_ms" ], "title": "LocalChatResponse" }, "LoginRequest": { "properties": { "email": { "type": "string", "title": "Email" }, "password": { "type": "string", "title": "Password" }, "totp_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Totp Code" } }, "type": "object", "required": [ "email", "password" ], "title": "LoginRequest" }, "MarketResult": { "properties": { "fear_index": { "type": "integer", "maximum": 100.0, "minimum": 0.0, "title": "Fear Index", "description": "Fear & Greed index, 0=fear 100=greed" }, "market_sentiment": { "type": "string", "title": "Market Sentiment", "description": "Overall market sentiment label" }, "trending_tokens": { "items": { "type": "string" }, "type": "array", "title": "Trending Tokens", "description": "Trending token symbols" }, "recent_exploits": { "items": { "type": "string" }, "type": "array", "title": "Recent Exploits", "description": "Recent exploit headlines" }, "top_movers_24h": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Top Movers 24H", "description": "Top 24h movers, e.g. [{symbol, change_pct}]" }, "summary": { "type": "string", "title": "Summary", "description": "One-paragraph market summary" } }, "type": "object", "required": [ "fear_index", "market_sentiment", "summary" ], "title": "MarketResult", "description": "Structured market snapshot from the Market Agent." }, "MarketUpdate": { "properties": { "workflow": { "type": "string", "title": "Workflow" }, "data": { "additionalProperties": true, "type": "object", "title": "Data" } }, "type": "object", "required": [ "workflow", "data" ], "title": "MarketUpdate", "description": "Market intelligence update from n8n." }, "MediaItem": { "properties": { "id": { "type": "string", "title": "Id", "description": "Media UUID" }, "filename": { "type": "string", "title": "Filename" }, "url": { "type": "string", "title": "Url" }, "thumbnail_url": { "type": "string", "title": "Thumbnail Url", "default": "" }, "media_type": { "type": "string", "title": "Media Type", "description": "image, video, document, audio" }, "mime_type": { "type": "string", "title": "Mime Type", "default": "" }, "size_bytes": { "type": "integer", "title": "Size Bytes", "default": 0 }, "width": { "type": "integer", "title": "Width", "default": 0 }, "height": { "type": "integer", "title": "Height", "default": 0 }, "duration_seconds": { "type": "number", "title": "Duration Seconds", "default": 0.0 }, "alt_text": { "type": "string", "title": "Alt Text", "default": "" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "created_at": { "type": "string", "title": "Created At", "description": "ISO timestamp" }, "used_in_posts": { "type": "integer", "title": "Used In Posts", "default": 0 } }, "type": "object", "required": [ "id", "filename", "url", "media_type", "created_at" ], "title": "MediaItem", "description": "A media item in the library." }, "MediaLibraryResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/MediaItem" }, "type": "array", "title": "Items" }, "total": { "type": "integer", "title": "Total", "default": 0 }, "total_size_bytes": { "type": "integer", "title": "Total Size Bytes", "default": 0 }, "by_type": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "By Type" } }, "type": "object", "title": "MediaLibraryResponse", "description": "Media library contents." }, "MediaUploadResponse": { "properties": { "media": { "$ref": "#/components/schemas/MediaItem" }, "upload_url": { "type": "string", "title": "Upload Url", "default": "" }, "upload_expires_at": { "type": "string", "title": "Upload Expires At", "default": "" } }, "type": "object", "required": [ "media" ], "title": "MediaUploadResponse", "description": "Response from media upload." }, "MemeVibeRequest": { "properties": { "token": { "type": "string", "title": "Token" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "token" ], "title": "MemeVibeRequest" }, "MintRequest": { "properties": { "mint": { "type": "string", "title": "Mint" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "mint" ], "title": "MintRequest" }, "MultiTokenRequest": { "properties": { "addresses": { "items": { "type": "string" }, "type": "array", "title": "Addresses" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "addresses" ], "title": "MultiTokenRequest" }, "NFTGateRequest": { "properties": { "contract_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Contract Address", "description": "NFT contract address (any = any NFT)" }, "collection_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Collection Name", "description": "Collection name for Solana/verification" }, "creator_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Creator Address", "description": "NFT creator address" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" } }, "type": "object", "title": "NFTGateRequest" }, "NarrativeRequest": { "properties": { "token": { "type": "string", "title": "Token", "description": "Token symbol or address" }, "chain": { "type": "string", "title": "Chain", "default": "all" } }, "type": "object", "required": [ "token" ], "title": "NarrativeRequest", "description": "Narrative/sentiment analysis request." }, "NewsAnalysisResponse": { "properties": { "news_id": { "type": "string", "title": "News Id" }, "analysis": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Analysis" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" } }, "type": "object", "required": [ "news_id", "analysis" ], "title": "NewsAnalysisResponse" }, "NewsArticle": { "properties": { "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "title": { "type": "string", "title": "Title", "default": "" }, "url": { "type": "string", "title": "Url", "default": "" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "source": { "type": "string", "title": "Source", "default": "" }, "published_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Published At" }, "image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Image Url" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" }, "sentiment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sentiment" }, "kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" }, "tier": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tier" }, "reddit_score": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Reddit Score" }, "reddit_comments": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Reddit Comments" }, "risk_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Risk Score" }, "token_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Token Address" }, "chain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Chain" }, "comment_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Comment Count", "default": 0 }, "bias": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Bias" }, "sentiment_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Sentiment Score" }, "sentiment_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sentiment Label" }, "factual_rating": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Factual Rating" }, "rating_confidence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Rating Confidence" }, "source_tier": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Source Tier" }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary" }, "factuality": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Factuality" }, "source_reputation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Reputation" }, "market_impact": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Market Impact" }, "tokens_mentioned": { "items": { "type": "string" }, "type": "array", "title": "Tokens Mentioned" }, "group_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Group Id" }, "cluster_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cluster Id" }, "source_count": { "type": "integer", "title": "Source Count", "default": 0 }, "corroborating_sources": { "type": "integer", "title": "Corroborating Sources", "default": 0 } }, "type": "object", "title": "NewsArticle" }, "NewsFeedResponse": { "properties": { "status": { "type": "string", "title": "Status", "default": "success" }, "articles": { "items": { "$ref": "#/components/schemas/NewsArticle" }, "type": "array", "title": "Articles", "default": [] }, "total": { "type": "integer", "title": "Total", "default": 0 }, "sources": { "items": { "type": "string" }, "type": "array", "title": "Sources", "default": [] }, "source_count": { "type": "integer", "title": "Source Count", "default": 0 }, "sentiment_summary": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "Sentiment Summary", "default": {} }, "tiers": { "items": { "type": "string" }, "type": "array", "title": "Tiers", "default": [] }, "cached": { "type": "boolean", "title": "Cached", "default": false }, "fetched_at": { "type": "string", "title": "Fetched At", "default": "" } }, "type": "object", "title": "NewsFeedResponse" }, "NewsItemOut": { "properties": { "news_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "News Id" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Title" }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary", "default": "" }, "image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Image Url" }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source", "default": "unknown" }, "published_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Published At" }, "chains_mentioned": { "items": { "type": "string" }, "type": "array", "title": "Chains Mentioned" }, "tokens_mentioned": { "items": { "type": "string" }, "type": "array", "title": "Tokens Mentioned" }, "sentiment_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Sentiment Score" }, "bias": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Bias" }, "sentiment_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sentiment Label" }, "factual_rating": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Factual Rating" }, "source_tier": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Source Tier" }, "rating_confidence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Rating Confidence" }, "source_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Source Count" }, "bias_distribution": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "Bias Distribution" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Score" }, "upvotes": { "type": "integer", "title": "Upvotes", "default": 0 }, "downvotes": { "type": "integer", "title": "Downvotes", "default": 0 }, "comment_count": { "type": "integer", "title": "Comment Count", "default": 0 } }, "type": "object", "title": "NewsItemOut" }, "NewsListResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/NewsItemOut" }, "type": "array", "title": "Items" }, "total": { "type": "integer", "title": "Total" }, "offset": { "type": "integer", "title": "Offset" } }, "type": "object", "required": [ "items", "total", "offset" ], "title": "NewsListResponse" }, "NewsResponse": { "properties": { "articles": { "items": { "$ref": "#/components/schemas/NewsArticle" }, "type": "array", "title": "Articles", "default": [] }, "total": { "type": "integer", "title": "Total", "default": 0 }, "page": { "type": "integer", "title": "Page", "default": 1 }, "categories": { "items": { "type": "string" }, "type": "array", "title": "Categories", "default": [] }, "sentiment_breakdown": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "Sentiment Breakdown", "default": {} } }, "type": "object", "title": "NewsResponse", "description": "Ground News-style rated article listing (Qdrant news_v2)." }, "NewsletterAnalytics": { "properties": { "total_newsletters": { "type": "integer", "title": "Total Newsletters", "default": 0 }, "total_subscribers": { "type": "integer", "title": "Total Subscribers", "default": 0 }, "paid_subscribers": { "type": "integer", "title": "Paid Subscribers", "default": 0 }, "total_revenue": { "type": "number", "title": "Total Revenue", "default": 0.0 }, "platform_fees": { "type": "number", "title": "Platform Fees", "default": 0.0 }, "creator_earnings": { "type": "number", "title": "Creator Earnings", "default": 0.0 }, "avg_open_rate": { "type": "number", "title": "Avg Open Rate", "default": 0.0 }, "avg_click_rate": { "type": "number", "title": "Avg Click Rate", "default": 0.0 }, "subscriber_growth_7d": { "type": "integer", "title": "Subscriber Growth 7D", "default": 0 }, "subscriber_growth_30d": { "type": "integer", "title": "Subscriber Growth 30D", "default": 0 }, "best_performing_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Best Performing Title" }, "best_performing_open_rate": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Best Performing Open Rate" } }, "type": "object", "title": "NewsletterAnalytics", "description": "Aggregate analytics for a newsletter or creator." }, "NewsletterCreate": { "properties": { "title": { "type": "string", "maxLength": 512, "minLength": 1, "title": "Title", "description": "Newsletter title" }, "content_html": { "type": "string", "minLength": 1, "title": "Content Html", "description": "HTML body" }, "content_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content Text", "description": "Plain text fallback" }, "excerpt": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ], "title": "Excerpt", "description": "Short preview" }, "cover_image": { "anyOf": [ { "type": "string", "maxLength": 1024 }, { "type": "null" } ], "title": "Cover Image", "description": "Cover image URL" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Tags", "description": "Content tags" }, "subject_line": { "anyOf": [ { "type": "string", "maxLength": 256 }, { "type": "null" } ], "title": "Subject Line", "description": "Email subject" }, "preheader_text": { "anyOf": [ { "type": "string", "maxLength": 256 }, { "type": "null" } ], "title": "Preheader Text", "description": "Email preheader" }, "segment": { "type": "string", "title": "Segment", "description": "Audience segment: all | paid_only | free_only | by_interest", "default": "all" }, "publish_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Publish At", "description": "Scheduled publish time; null = immediate" }, "recurrence": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recurrence", "description": "daily | weekly | monthly | null = one-off" } }, "additionalProperties": false, "type": "object", "required": [ "title", "content_html" ], "title": "NewsletterCreate", "description": "Request body for creating/sending a newsletter." }, "NewsletterListResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/NewsletterOut" }, "type": "array", "title": "Items" }, "total": { "type": "integer", "title": "Total" }, "offset": { "type": "integer", "title": "Offset" }, "limit": { "type": "integer", "title": "Limit" } }, "type": "object", "required": [ "items", "total", "offset", "limit" ], "title": "NewsletterListResponse", "description": "Paginated newsletter list." }, "NewsletterOut": { "properties": { "id": { "type": "string", "title": "Id" }, "creator_id": { "type": "string", "title": "Creator Id" }, "title": { "type": "string", "title": "Title" }, "slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Slug" }, "content_html": { "type": "string", "title": "Content Html" }, "content_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content Text" }, "excerpt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Excerpt" }, "cover_image": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cover Image" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "status": { "type": "string", "title": "Status", "default": "draft" }, "publish_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Publish At" }, "sent_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Sent At" }, "segment": { "type": "string", "title": "Segment", "default": "all" }, "subject_line": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Subject Line" }, "preheader_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Preheader Text" }, "recurrence": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recurrence" }, "total_recipients": { "type": "integer", "title": "Total Recipients", "default": 0 }, "total_opened": { "type": "integer", "title": "Total Opened", "default": 0 }, "total_clicked": { "type": "integer", "title": "Total Clicked", "default": 0 }, "total_revenue": { "type": "number", "title": "Total Revenue", "default": 0.0 }, "ghost_post_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ghost Post Id" }, "created_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Created At" }, "updated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Updated At" } }, "type": "object", "required": [ "id", "creator_id", "title", "content_html" ], "title": "NewsletterOut", "description": "Response body for a newsletter." }, "NewsletterUpdate": { "properties": { "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Title" }, "content_html": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content Html" }, "content_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content Text" }, "excerpt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Excerpt" }, "cover_image": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cover Image" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Tags" }, "subject_line": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Subject Line" }, "preheader_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Preheader Text" }, "segment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Segment" }, "publish_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Publish At" }, "recurrence": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recurrence" } }, "additionalProperties": false, "type": "object", "title": "NewsletterUpdate", "description": "Request body for updating a newsletter draft." }, "OHLCVCandle": { "properties": { "time": { "type": "integer", "title": "Time", "description": "Unix timestamp in seconds" }, "open": { "type": "number", "title": "Open" }, "high": { "type": "number", "title": "High" }, "low": { "type": "number", "title": "Low" }, "close": { "type": "number", "title": "Close" }, "volume": { "type": "number", "title": "Volume", "default": 0.0 } }, "type": "object", "required": [ "time", "open", "high", "low", "close" ], "title": "OHLCVCandle" }, "OkResponse": { "properties": { "ok": { "type": "boolean", "title": "Ok", "default": true } }, "type": "object", "title": "OkResponse", "description": "Generic write acknowledgement." }, "PayRequest": { "properties": { "recipient": { "type": "string", "title": "Recipient", "description": "Recipient username or wallet address" }, "amount": { "type": "string", "title": "Amount", "description": "Amount to send" }, "token": { "type": "string", "title": "Token", "description": "Token symbol: ETH, SOL, USDC, USDT, DAI, BTC", "default": "ETH" }, "chain": { "type": "string", "title": "Chain", "description": "Blockchain: ethereum, solana, base, polygon, optimism, arbitrum, lightning", "default": "ethereum" }, "room_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Room Id", "description": "Room context for the payment" }, "message": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Message", "description": "Optional payment message" }, "wallet_address": { "type": "string", "title": "Wallet Address", "description": "Sender wallet address" } }, "type": "object", "required": [ "recipient", "amount", "wallet_address" ], "title": "PayRequest" }, "PaymentInitResponse": { "properties": { "invoice_id": { "type": "string", "title": "Invoice Id" }, "tool": { "type": "string", "title": "Tool" }, "agent_id": { "type": "string", "title": "Agent Id" }, "amount_usd": { "type": "number", "title": "Amount Usd" }, "amount_wei": { "type": "integer", "title": "Amount Wei", "default": 0 }, "pay_to": { "type": "string", "title": "Pay To" }, "chain": { "type": "string", "title": "Chain" }, "expires_at": { "type": "number", "title": "Expires At" }, "payment_url": { "type": "string", "title": "Payment Url" }, "signature": { "type": "string", "title": "Signature" }, "instructions": { "type": "string", "title": "Instructions", "default": "Pay the exact amount in USDC to the address above on the specified chain. After payment, call POST /api/v1/x402/verify with the tx_hash, or include it as X-Payment header on your next API call." } }, "type": "object", "required": [ "invoice_id", "tool", "agent_id", "amount_usd", "pay_to", "chain", "expires_at", "payment_url", "signature" ], "title": "PaymentInitResponse", "description": "Response to a payment initiation request \u2014 invoice + payment instructions." }, "PlatformAnalytics": { "properties": { "platform_id": { "type": "string", "title": "Platform Id" }, "platform_name": { "type": "string", "title": "Platform Name" }, "icon": { "type": "string", "title": "Icon", "default": "\ud83c\udf10" }, "posts": { "type": "integer", "title": "Posts", "default": 0 }, "impressions": { "type": "integer", "title": "Impressions", "default": 0 }, "engagements": { "type": "integer", "title": "Engagements", "default": 0 }, "likes": { "type": "integer", "title": "Likes", "default": 0 }, "comments": { "type": "integer", "title": "Comments", "default": 0 }, "shares": { "type": "integer", "title": "Shares", "default": 0 }, "followers": { "type": "integer", "title": "Followers", "default": 0 }, "followers_gained": { "type": "integer", "title": "Followers Gained", "default": 0 }, "engagement_rate": { "type": "number", "title": "Engagement Rate", "default": 0.0 }, "avg_engagement_rate": { "type": "number", "title": "Avg Engagement Rate", "default": 0.0 }, "reach": { "type": "integer", "title": "Reach", "default": 0 }, "best_posting_time": { "type": "string", "title": "Best Posting Time", "default": "" }, "growth_trend": { "items": { "$ref": "#/components/schemas/app__domains__postiz__models__DataPoint" }, "type": "array", "title": "Growth Trend" }, "top_posts": { "items": { "$ref": "#/components/schemas/PostPerformance" }, "type": "array", "title": "Top Posts" } }, "type": "object", "required": [ "platform_id", "platform_name" ], "title": "PlatformAnalytics", "description": "Per-platform analytics." }, "PlatformBestTime": { "properties": { "platform_id": { "type": "string", "title": "Platform Id" }, "platform_name": { "type": "string", "title": "Platform Name" }, "best_time_utc": { "type": "string", "title": "Best Time Utc", "description": "e.g. \"14:00 UTC\"" }, "best_day": { "type": "string", "title": "Best Day", "description": "e.g. \"Wednesday\"" }, "confidence": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Confidence", "default": 0.0 }, "second_best_time": { "type": "string", "title": "Second Best Time", "default": "" }, "worst_time": { "type": "string", "title": "Worst Time", "default": "" }, "peak_hours": { "items": { "type": "integer" }, "type": "array", "title": "Peak Hours" }, "reasoning": { "type": "string", "title": "Reasoning", "default": "" } }, "type": "object", "required": [ "platform_id", "platform_name", "best_time_utc", "best_day" ], "title": "PlatformBestTime", "description": "Best posting times for a single platform." }, "PlatformConnectRequest": { "properties": { "platform_id": { "type": "string", "maxLength": 50, "minLength": 1, "title": "Platform Id", "description": "Platform slug (e.g. 'twitter', 'nostr')" }, "oauth_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Oauth Code", "description": "OAuth authorization code" }, "api_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Api Key", "description": "API key (for platforms without OAuth)" }, "api_secret": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Api Secret", "description": "API secret" }, "access_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Access Token", "description": "Pre-existing access token" }, "instance_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Instance Url", "description": "Instance URL (for federated platforms like Mastodon)" }, "webhook_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Webhook Url", "description": "Webhook URL (for Discord, Slack)" }, "label": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ], "title": "Label", "description": "Human label for this connection" } }, "type": "object", "required": [ "platform_id" ], "title": "PlatformConnectRequest", "description": "Request to connect a platform account." }, "PlatformConnection": { "properties": { "id": { "type": "string", "title": "Id", "description": "Connection UUID" }, "platform_id": { "type": "string", "title": "Platform Id", "description": "Platform slug" }, "platform_name": { "type": "string", "title": "Platform Name", "description": "Platform display name" }, "account_name": { "type": "string", "title": "Account Name", "description": "Connected account name/handle" }, "account_id": { "type": "string", "title": "Account Id", "description": "Platform-specific account ID", "default": "" }, "avatar_url": { "type": "string", "title": "Avatar Url", "description": "Account avatar", "default": "" }, "connected_at": { "type": "string", "title": "Connected At", "description": "ISO timestamp" }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expires At", "description": "Token expiry" }, "label": { "type": "string", "title": "Label", "description": "User-defined label", "default": "" }, "status": { "type": "string", "title": "Status", "description": "active, expired, revoked", "default": "active" }, "rate_limit_remaining": { "type": "integer", "title": "Rate Limit Remaining", "description": "API calls remaining this window", "default": 0 }, "rate_limit_reset": { "type": "string", "title": "Rate Limit Reset", "description": "Rate limit reset timestamp", "default": "" } }, "type": "object", "required": [ "id", "platform_id", "platform_name", "account_name", "connected_at" ], "title": "PlatformConnection", "description": "A connected platform account." }, "PlatformInfo": { "properties": { "id": { "type": "string", "title": "Id" }, "name": { "type": "string", "title": "Name" }, "category": { "type": "string", "title": "Category" }, "max_length": { "type": "integer", "title": "Max Length" }, "media_types": { "items": { "type": "string" }, "type": "array", "title": "Media Types" }, "decentralized": { "type": "boolean", "title": "Decentralized", "default": false }, "icon": { "type": "string", "title": "Icon", "default": "\ud83c\udf10" }, "status": { "type": "string", "title": "Status", "default": "active" }, "connected": { "type": "boolean", "title": "Connected", "default": false }, "connection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Connection Id" }, "account_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Account Name" } }, "type": "object", "required": [ "id", "name", "category", "max_length", "media_types" ], "title": "PlatformInfo", "description": "Public platform info with optional connection status." }, "PlatformListResponse": { "properties": { "platforms": { "items": { "$ref": "#/components/schemas/PlatformInfo" }, "type": "array", "title": "Platforms" }, "total": { "type": "integer", "title": "Total", "default": 0 }, "connected_count": { "type": "integer", "title": "Connected Count", "default": 0 }, "decentralized_count": { "type": "integer", "title": "Decentralized Count", "default": 0 }, "categories": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "Categories" } }, "type": "object", "title": "PlatformListResponse", "description": "List of all available platforms with connection status." }, "PostPerformance": { "properties": { "post_id": { "type": "string", "title": "Post Id" }, "text_preview": { "type": "string", "title": "Text Preview", "default": "" }, "platform": { "type": "string", "title": "Platform" }, "published_at": { "type": "string", "title": "Published At", "default": "" }, "impressions": { "type": "integer", "title": "Impressions", "default": 0 }, "engagements": { "type": "integer", "title": "Engagements", "default": 0 }, "likes": { "type": "integer", "title": "Likes", "default": 0 }, "comments": { "type": "integer", "title": "Comments", "default": 0 }, "shares": { "type": "integer", "title": "Shares", "default": 0 }, "clicks": { "type": "integer", "title": "Clicks", "default": 0 }, "engagement_rate": { "type": "number", "title": "Engagement Rate", "default": 0.0 }, "content_category": { "type": "string", "title": "Content Category", "default": "" } }, "type": "object", "required": [ "post_id", "platform" ], "title": "PostPerformance", "description": "Single post performance metrics." }, "PostResponse": { "properties": { "id": { "type": "string", "title": "Id" }, "protocol": { "type": "string", "title": "Protocol" }, "author": { "$ref": "#/components/schemas/app__routers__degenfeed_proxy__IdentityResponse" }, "text": { "type": "string", "title": "Text" }, "created_at": { "type": "string", "title": "Created At" }, "likes": { "type": "integer", "title": "Likes", "default": 0 }, "shares": { "type": "integer", "title": "Shares", "default": 0 }, "replies": { "type": "integer", "title": "Replies", "default": 0 }, "media_urls": { "items": { "type": "string" }, "type": "array", "title": "Media Urls" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" } }, "additionalProperties": true, "type": "object", "required": [ "id", "protocol", "author", "text", "created_at" ], "title": "PostResponse", "description": "A post/status update from any protocol." }, "PostStatus": { "type": "string", "enum": [ "draft", "scheduled", "queued", "publishing", "published", "failed", "cancelled" ], "title": "PostStatus" }, "PostTemplate": { "properties": { "id": { "type": "string", "title": "Id", "description": "Template UUID" }, "name": { "type": "string", "title": "Name", "description": "Template name" }, "description": { "type": "string", "title": "Description", "default": "" }, "text": { "type": "string", "title": "Text", "default": "" }, "platforms": { "items": { "type": "string" }, "type": "array", "title": "Platforms" }, "media_ids": { "items": { "type": "string" }, "type": "array", "title": "Media Ids" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "content_category": { "type": "string", "title": "Content Category", "default": "general" }, "variables": { "items": { "type": "string" }, "type": "array", "title": "Variables", "description": "Template variables like {{name}}" }, "usage_count": { "type": "integer", "title": "Usage Count", "default": 0 }, "created_at": { "type": "string", "title": "Created At", "description": "ISO timestamp" }, "updated_at": { "type": "string", "title": "Updated At", "description": "ISO timestamp" } }, "type": "object", "required": [ "id", "name", "created_at", "updated_at" ], "title": "PostTemplate", "description": "A saved post template." }, "PricingResponse": { "properties": { "tiers": { "additionalProperties": true, "type": "object", "title": "Tiers" }, "accepted_chains": { "items": { "type": "string" }, "type": "array", "title": "Accepted Chains" }, "accepted_tokens": { "items": { "type": "string" }, "type": "array", "title": "Accepted Tokens" }, "payment_protocol": { "type": "string", "title": "Payment Protocol", "default": "x402" } }, "type": "object", "title": "PricingResponse", "description": "Tier pricing summary \u2014 what each tier costs and includes." }, "ProtectionResponse": { "properties": { "safe": { "type": "boolean", "title": "Safe" }, "risk": { "type": "string", "title": "Risk", "default": "low" }, "reason": { "type": "string", "title": "Reason", "default": "" }, "source": { "type": "string", "title": "Source", "default": "" }, "risk_score": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Risk Score" }, "flags": { "items": { "type": "string" }, "type": "array", "title": "Flags", "default": [] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" } }, "type": "object", "required": [ "safe" ], "title": "ProtectionResponse" }, "Protocol": { "type": "string", "enum": [ "matrix", "nostr", "farcaster", "bluesky", "activitypub", "lens", "xmtp", "telegram", "discord", "irc", "xmpp", "signal", "web3" ], "title": "Protocol", "description": "Supported chat protocols. Matrix is the canonical fabric." }, "ProtocolComparison": { "properties": { "protocol": { "type": "string", "title": "Protocol", "default": "" }, "views": { "type": "integer", "title": "Views", "default": 0 }, "unique_viewers": { "type": "integer", "title": "Unique Viewers", "default": 0 }, "total_watch_time_minutes": { "type": "number", "title": "Total Watch Time Minutes", "default": 0.0 }, "average_view_duration_seconds": { "type": "number", "title": "Average View Duration Seconds", "default": 0.0 }, "engagements": { "type": "integer", "title": "Engagements", "default": 0 }, "likes": { "type": "integer", "title": "Likes", "default": 0 }, "comments": { "type": "integer", "title": "Comments", "default": 0 }, "reposts": { "type": "integer", "title": "Reposts", "default": 0 }, "tips_usd": { "type": "number", "title": "Tips Usd", "default": 0.0 }, "followers_gained": { "type": "integer", "title": "Followers Gained", "default": 0 }, "engagement_rate": { "type": "number", "title": "Engagement Rate", "default": 0.0 }, "best_posting_time": { "type": "string", "title": "Best Posting Time", "default": "" }, "best_content_type": { "type": "string", "title": "Best Content Type", "default": "" }, "reach_score": { "type": "number", "title": "Reach Score", "default": 0.0 }, "engagement_score": { "type": "number", "title": "Engagement Score", "default": 0.0 } }, "type": "object", "title": "ProtocolComparison", "description": "Performance comparison for a single protocol." }, "ProtocolListResponse": { "properties": { "protocols": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Protocols" }, "count": { "type": "integer", "title": "Count" } }, "type": "object", "required": [ "protocols", "count" ], "title": "ProtocolListResponse", "description": "List of supported protocols." }, "PublicPostRequest": { "properties": { "title": { "type": "string", "maxLength": 200, "title": "Title", "default": "" }, "content": { "type": "string", "maxLength": 5000, "minLength": 1, "title": "Content" }, "author_name": { "type": "string", "maxLength": 100, "title": "Author Name", "default": "Community Member" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" } }, "type": "object", "required": [ "content" ], "title": "PublicPostRequest", "description": "Lightweight model for public discussion posts (no auth required)." }, "PublishRequest": { "properties": { "newsletter_id": { "type": "string", "title": "Newsletter Id" }, "platforms": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Platforms", "description": "Platform list; null = all enabled platforms" }, "platforms_extra": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Platforms Extra", "description": "Platform-specific overrides (e.g. ghost_tags, medium_canonical)" } }, "additionalProperties": false, "type": "object", "required": [ "newsletter_id" ], "title": "PublishRequest", "description": "Request body for cross-platform publishing." }, "PublishResponse": { "properties": { "results": { "items": { "$ref": "#/components/schemas/CrosspostOut" }, "type": "array", "title": "Results" }, "total": { "type": "integer", "title": "Total" }, "succeeded": { "type": "integer", "title": "Succeeded" }, "failed": { "type": "integer", "title": "Failed" } }, "type": "object", "required": [ "results", "total", "succeeded", "failed" ], "title": "PublishResponse", "description": "Response from cross-platform publish." }, "QueryRequest": { "properties": { "query": { "type": "string", "title": "Query", "default": "" }, "chain": { "type": "string", "title": "Chain", "default": "solana" }, "category": { "type": "string", "title": "Category", "default": "" } }, "type": "object", "title": "QueryRequest" }, "QueueItem": { "properties": { "id": { "type": "string", "title": "Id" }, "queue": { "type": "string", "title": "Queue" }, "key": { "type": "string", "title": "Key" }, "payload": { "additionalProperties": true, "type": "object", "title": "Payload" }, "created_at": { "type": "string", "title": "Created At" } }, "type": "object", "required": [ "id", "queue", "key", "created_at" ], "title": "QueueItem", "description": "A dequeued job." }, "QueueResponse": { "properties": { "posts": { "items": { "$ref": "#/components/schemas/ScheduledPost" }, "type": "array", "title": "Posts" }, "total": { "type": "integer", "title": "Total", "default": 0 }, "estimated_fill_days": { "type": "number", "title": "Estimated Fill Days", "default": 0.0 }, "optimal_interval_minutes": { "type": "number", "title": "Optimal Interval Minutes", "default": 0.0 }, "platform_queue": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "Platform Queue" } }, "type": "object", "title": "QueueResponse", "description": "Content queue overview." }, "QuizAnswer": { "properties": { "question_index": { "type": "integer", "title": "Question Index" }, "answer": { "type": "integer", "title": "Answer" } }, "type": "object", "required": [ "question_index", "answer" ], "title": "QuizAnswer" }, "RagIngestRequest": { "properties": { "content": { "type": "string", "minLength": 1, "title": "Content" }, "collection": { "type": "string", "title": "Collection", "default": "scam_intel" }, "doc_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Doc Id" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "content" ], "title": "RagIngestRequest" }, "RagSearchRequest": { "properties": { "query": { "type": "string", "minLength": 1, "title": "Query" }, "collection": { "type": "string", "title": "Collection", "default": "scam_intel" }, "top_k": { "type": "integer", "maximum": 50.0, "minimum": 1.0, "title": "Top K", "default": 5 } }, "type": "object", "required": [ "query" ], "title": "RagSearchRequest" }, "RateLimitBatchRequest": { "properties": { "source": { "type": "string", "maxLength": 128, "minLength": 1, "title": "Source", "default": "degenfeed-worker" }, "entries": { "items": { "$ref": "#/components/schemas/RateLimitEntry" }, "type": "array", "title": "Entries" } }, "type": "object", "required": [ "entries" ], "title": "RateLimitBatchRequest", "description": "Batch sync payload from worker isolates." }, "RateLimitEntry": { "properties": { "ip": { "type": "string", "maxLength": 64, "minLength": 1, "title": "Ip" }, "path": { "type": "string", "maxLength": 512, "minLength": 1, "title": "Path" }, "count": { "type": "integer", "minimum": 0.0, "title": "Count" }, "max": { "type": "integer", "minimum": 1.0, "title": "Max" }, "window_ms": { "type": "integer", "maximum": 86400000.0, "minimum": 1.0, "title": "Window Ms", "default": 5000 } }, "type": "object", "required": [ "ip", "path", "count", "max" ], "title": "RateLimitEntry", "description": "A single rate limit entry in a batch sync payload." }, "RateLimitReport": { "properties": { "ip": { "type": "string", "maxLength": 64, "minLength": 1, "title": "Ip" }, "path": { "type": "string", "maxLength": 512, "minLength": 1, "title": "Path" }, "count": { "type": "integer", "minimum": 0.0, "title": "Count" }, "max": { "type": "integer", "minimum": 1.0, "title": "Max" }, "window_ms": { "type": "integer", "maximum": 86400000.0, "minimum": 1.0, "title": "Window Ms" } }, "type": "object", "required": [ "ip", "path", "count", "max", "window_ms" ], "title": "RateLimitReport", "description": "Cross-isolate rate limit report \u2014 an IP+path is near its limit." }, "RateLimitStatus": { "properties": { "count": { "type": "integer", "title": "Count", "default": 0 }, "blocked": { "type": "boolean", "title": "Blocked", "default": false } }, "type": "object", "title": "RateLimitStatus", "description": "Current rate limit status for an ip+path." }, "RateTokenRequest": { "properties": { "address": { "type": "string", "maxLength": 64, "minLength": 20, "title": "Address", "description": "Token contract/mint address", "examples": [ "0x1234567890abcdef1234567890abcdef12345678" ] }, "chain": { "type": "string", "title": "Chain", "description": "Blockchain (solana, ethereum, bsc, base, polygon, arbitrum, optimism)", "default": "solana", "examples": [ "solana" ] }, "use_reranker": { "type": "boolean", "title": "Use Reranker", "description": "Use cross-encoder reranker for enhanced scoring accuracy", "default": true }, "token_data": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Token Data", "description": "Optional pre-gathered token data for scoring" } }, "type": "object", "required": [ "address" ], "title": "RateTokenRequest", "description": "Request to rate a token." }, "RateTokenResponse": { "properties": { "success": { "type": "boolean", "title": "Success", "default": true }, "rating": { "additionalProperties": true, "type": "object", "title": "Rating" }, "deployer_info": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Deployer Info" }, "wallet_labels": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "title": "Wallet Labels" } }, "type": "object", "required": [ "rating" ], "title": "RateTokenResponse", "description": "Response with full rating breakdown." }, "ReactionRequest": { "properties": { "reaction": { "type": "string", "enum": [ "like", "dislike" ], "title": "Reaction" } }, "type": "object", "required": [ "reaction" ], "title": "ReactionRequest" }, "ReactionsSummary": { "properties": { "news_id": { "type": "string", "title": "News Id" }, "like_count": { "type": "integer", "title": "Like Count", "default": 0 }, "dislike_count": { "type": "integer", "title": "Dislike Count", "default": 0 }, "my_reaction": { "anyOf": [ { "type": "string", "enum": [ "like", "dislike" ] }, { "type": "null" } ], "title": "My Reaction" } }, "type": "object", "required": [ "news_id" ], "title": "ReactionsSummary" }, "ReadinessResponse": { "properties": { "status": { "type": "string", "title": "Status" }, "checks": { "additionalProperties": { "type": "boolean" }, "type": "object", "title": "Checks" } }, "type": "object", "required": [ "status", "checks" ], "title": "ReadinessResponse" }, "ReceiptResponse": { "properties": { "tx_hash": { "type": "string", "title": "Tx Hash" }, "tool": { "type": "string", "title": "Tool" }, "agent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" }, "amount_usd": { "type": "number", "title": "Amount Usd" }, "chain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Chain" }, "paid_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Paid At" }, "tier": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tier" } }, "type": "object", "required": [ "tx_hash", "tool", "amount_usd" ], "title": "ReceiptResponse" }, "RecordEngagementRequest": { "properties": { "post_id": { "type": "string", "title": "Post Id", "description": "Post UUID" }, "creator_id": { "type": "string", "title": "Creator Id", "description": "Creator UUID" }, "viewer_fingerprint": { "type": "string", "title": "Viewer Fingerprint", "description": "Hashed viewer identifier" }, "engagement_type": { "type": "string", "title": "Engagement Type", "description": "like, comment, repost, tip, save, bookmark, click, follow" }, "protocol": { "type": "string", "title": "Protocol", "default": "nostr" }, "tip_amount_usd": { "type": "number", "title": "Tip Amount Usd", "default": 0.0 }, "tip_token": { "type": "string", "title": "Tip Token", "default": "" }, "tip_amount_token": { "type": "number", "title": "Tip Amount Token", "default": 0.0 }, "comment_text": { "type": "string", "title": "Comment Text", "default": "" }, "comment_sentiment": { "type": "string", "title": "Comment Sentiment", "default": "neutral" }, "sentiment_score": { "type": "number", "title": "Sentiment Score", "default": 0.0 }, "clicked_url": { "type": "string", "title": "Clicked Url", "default": "" }, "followed_after": { "type": "boolean", "title": "Followed After", "default": false } }, "type": "object", "required": [ "post_id", "creator_id", "viewer_fingerprint", "engagement_type" ], "title": "RecordEngagementRequest", "description": "Submit an engagement event for recording." }, "RecordViewRequest": { "properties": { "post_id": { "type": "string", "title": "Post Id", "description": "Post UUID" }, "creator_id": { "type": "string", "title": "Creator Id", "description": "Creator UUID" }, "viewer_fingerprint": { "type": "string", "title": "Viewer Fingerprint", "description": "Hashed viewer identifier" }, "protocol": { "type": "string", "title": "Protocol", "description": "Protocol: nostr, farcaster, bluesky, mastodon", "default": "nostr" }, "watch_time_seconds": { "type": "number", "title": "Watch Time Seconds", "default": 0.0 }, "total_duration": { "type": "number", "title": "Total Duration", "default": 0.0 }, "dropped_at_seconds": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Dropped At Seconds" }, "scrolled_past": { "type": "boolean", "title": "Scrolled Past", "default": false }, "scroll_depth": { "type": "number", "title": "Scroll Depth", "default": 0.0 }, "is_live": { "type": "boolean", "title": "Is Live", "default": false }, "is_replay": { "type": "boolean", "title": "Is Replay", "default": false }, "session_id": { "type": "string", "title": "Session Id", "default": "" }, "viewer_wallet": { "type": "string", "title": "Viewer Wallet", "default": "" }, "referrer": { "type": "string", "title": "Referrer", "default": "" } }, "type": "object", "required": [ "post_id", "creator_id", "viewer_fingerprint" ], "title": "RecordViewRequest", "description": "Submit a view event for recording." }, "RecurrencePattern": { "type": "string", "enum": [ "daily", "weekly", "monthly", "custom_cron" ], "title": "RecurrencePattern" }, "RecurringCreateRequest": { "properties": { "text": { "type": "string", "maxLength": 64000, "minLength": 1, "title": "Text", "description": "Post content" }, "platforms": { "items": { "type": "string" }, "type": "array", "maxItems": 30, "minItems": 1, "title": "Platforms", "description": "Target platform IDs" }, "pattern": { "$ref": "#/components/schemas/RecurrencePattern", "description": "Recurrence pattern", "default": "weekly" }, "recurring_cron": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recurring Cron", "description": "Custom cron expression" }, "recurring_end": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recurring End", "description": "Recurrence end date ISO" }, "media_urls": { "items": { "type": "string" }, "type": "array", "maxItems": 20, "title": "Media Urls" }, "tags": { "items": { "type": "string" }, "type": "array", "maxItems": 30, "title": "Tags" }, "content_category": { "type": "string", "title": "Content Category", "default": "general" } }, "type": "object", "required": [ "text", "platforms" ], "title": "RecurringCreateRequest", "description": "Request to create a recurring post." }, "RecurringPost": { "properties": { "id": { "type": "string", "title": "Id", "description": "Recurring post UUID" }, "text": { "type": "string", "title": "Text" }, "platforms": { "items": { "type": "string" }, "type": "array", "title": "Platforms" }, "pattern": { "$ref": "#/components/schemas/RecurrencePattern" }, "cron_expression": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cron Expression", "description": "Cron expression for custom patterns" }, "media_urls": { "items": { "type": "string" }, "type": "array", "title": "Media Urls" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "content_category": { "type": "string", "title": "Content Category", "default": "general" }, "start_date": { "type": "string", "title": "Start Date", "description": "ISO date" }, "end_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "End Date", "description": "End date for recurrence" }, "last_posted": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Posted" }, "next_post": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Next Post" }, "times_posted": { "type": "integer", "title": "Times Posted", "default": 0 }, "status": { "type": "string", "title": "Status", "default": "active" }, "created_at": { "type": "string", "title": "Created At", "description": "ISO timestamp" } }, "type": "object", "required": [ "id", "text", "platforms", "pattern", "start_date", "created_at" ], "title": "RecurringPost", "description": "A recurring post template." }, "RegisterRequest": { "properties": { "email": { "type": "string", "maxLength": 255, "minLength": 3, "title": "Email" }, "tier": { "type": "string", "title": "Tier", "default": "free" }, "wallet_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Address" } }, "type": "object", "required": [ "email" ], "title": "RegisterRequest" }, "RegisterUserRequest": { "properties": { "user_id": { "type": "string", "maxLength": 100, "minLength": 1, "title": "User Id", "description": "User's unique ID" }, "display_name": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ], "title": "Display Name" }, "protocols": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "title": "Protocols", "description": "Extra protocol identities: {\"nostr\": \"npub1...\", \"farcaster\": \"fid:...\"}" } }, "type": "object", "required": [ "user_id" ], "title": "RegisterUserRequest" }, "ReportRequest": { "properties": { "subject_type": { "type": "string", "enum": [ "token", "wallet", "entity" ], "title": "Subject Type" }, "subject_id": { "type": "string", "title": "Subject Id" }, "sections": { "items": { "type": "string", "enum": [ "risk", "holders", "transactions", "news", "technical" ] }, "type": "array", "minItems": 1, "title": "Sections" }, "format": { "type": "string", "enum": [ "json", "markdown" ], "title": "Format", "default": "json" } }, "type": "object", "required": [ "subject_type", "subject_id", "sections" ], "title": "ReportRequest", "description": "Custom report generation request." }, "ReportSubmit": { "properties": { "title": { "type": "string", "maxLength": 200, "minLength": 3, "title": "Title" }, "description": { "type": "string", "maxLength": 5000, "minLength": 10, "title": "Description" }, "category": { "type": "string", "pattern": "^(scam|exploit|phishing|rugpull|other)$", "title": "Category", "default": "scam" }, "addresses": { "items": { "type": "string" }, "type": "array", "maxItems": 20, "title": "Addresses" }, "graph_data": { "additionalProperties": true, "type": "object", "title": "Graph Data" }, "author": { "type": "string", "maxLength": 100, "title": "Author", "default": "anonymous" } }, "type": "object", "required": [ "title", "description" ], "title": "ReportSubmit" }, "RequestPayment": { "properties": { "recipient": { "type": "string", "title": "Recipient", "description": "User to request payment from" }, "amount": { "type": "string", "title": "Amount", "description": "Amount to request" }, "token": { "type": "string", "title": "Token", "default": "ETH" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" }, "reason": { "anyOf": [ { "type": "string", "maxLength": 300 }, { "type": "null" } ], "title": "Reason", "description": "Reason for payment request" }, "room_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Room Id" } }, "type": "object", "required": [ "recipient", "amount" ], "title": "RequestPayment" }, "ResolveEntityRequest": { "properties": { "wallet_id": { "type": "string", "title": "Wallet Id" }, "max_chains": { "type": "integer", "maximum": 20.0, "minimum": 1.0, "title": "Max Chains", "default": 5 } }, "type": "object", "required": [ "wallet_id" ], "title": "ResolveEntityRequest" }, "RugMapRequest": { "properties": { "center_wallet": { "type": "string", "title": "Center Wallet" }, "depth": { "type": "integer", "title": "Depth", "default": 2 }, "max_wallets": { "type": "integer", "title": "Max Wallets", "default": 250 }, "ai_deep_dive": { "type": "boolean", "title": "Ai Deep Dive", "default": false } }, "type": "object", "required": [ "center_wallet" ], "title": "RugMapRequest" }, "RugMapsRequest": { "properties": { "center_wallet": { "type": "string", "title": "Center Wallet" }, "depth": { "type": "integer", "title": "Depth", "default": 2 }, "min_strength": { "type": "number", "title": "Min Strength", "default": 0.1 } }, "type": "object", "required": [ "center_wallet" ], "title": "RugMapsRequest" }, "SchedulePostRequest": { "properties": { "text": { "type": "string", "maxLength": 64000, "minLength": 1, "title": "Text", "description": "Post content" }, "platforms": { "items": { "type": "string" }, "type": "array", "maxItems": 30, "minItems": 1, "title": "Platforms", "description": "Target platform IDs" }, "media_urls": { "items": { "type": "string" }, "type": "array", "maxItems": 20, "title": "Media Urls", "description": "Media URLs" }, "tags": { "items": { "type": "string" }, "type": "array", "maxItems": 30, "title": "Tags", "description": "Hashtags/tags" }, "content_category": { "type": "string", "title": "Content Category", "description": "Content category for rotation", "default": "general" }, "scheduled_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scheduled At", "description": "ISO timestamp for scheduled posting" }, "timezone": { "type": "string", "title": "Timezone", "description": "Timezone for scheduled time", "default": "UTC" }, "recurring": { "anyOf": [ { "$ref": "#/components/schemas/RecurrencePattern" }, { "type": "null" } ], "description": "Recurrence pattern" }, "recurring_cron": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recurring Cron", "description": "Custom cron expression" }, "recurring_end": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recurring End", "description": "Recurrence end date ISO" }, "queue_position": { "anyOf": [ { "type": "integer", "minimum": 1.0 }, { "type": "null" } ], "title": "Queue Position", "description": "Position in queue (if not scheduling)" }, "thread": { "items": { "type": "string" }, "type": "array", "title": "Thread", "description": "Thread continuation posts" }, "cross_post_to": { "items": { "type": "string" }, "type": "array", "maxItems": 10, "title": "Cross Post To", "description": "Additional platforms" } }, "type": "object", "required": [ "text", "platforms" ], "title": "SchedulePostRequest", "description": "Request to schedule a post." }, "ScheduleRequest": { "properties": { "newsletter_id": { "type": "string", "title": "Newsletter Id" }, "publish_at": { "type": "string", "format": "date-time", "title": "Publish At", "description": "ISO 8601 scheduled time" }, "recurrence": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recurrence" } }, "additionalProperties": false, "type": "object", "required": [ "newsletter_id", "publish_at" ], "title": "ScheduleRequest", "description": "Request body for scheduling a newsletter." }, "ScheduledPost": { "properties": { "id": { "type": "string", "title": "Id", "description": "Post UUID" }, "text": { "type": "string", "title": "Text" }, "platforms": { "items": { "type": "string" }, "type": "array", "title": "Platforms" }, "platform_names": { "items": { "type": "string" }, "type": "array", "title": "Platform Names" }, "media_urls": { "items": { "type": "string" }, "type": "array", "title": "Media Urls" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "content_category": { "type": "string", "title": "Content Category", "default": "general" }, "status": { "$ref": "#/components/schemas/PostStatus", "default": "draft" }, "scheduled_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scheduled At" }, "published_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Published At" }, "created_at": { "type": "string", "title": "Created At", "description": "ISO timestamp" }, "updated_at": { "type": "string", "title": "Updated At", "description": "ISO timestamp" }, "timezone": { "type": "string", "title": "Timezone", "default": "UTC" }, "thread": { "items": { "type": "string" }, "type": "array", "title": "Thread" }, "results": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Results", "description": "Platform \u2192 post ID mapping" }, "failures": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Failures", "description": "Platform \u2192 error message" }, "queue_position": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Queue Position" } }, "type": "object", "required": [ "id", "text", "platforms", "created_at", "updated_at" ], "title": "ScheduledPost", "description": "A scheduled or queued post." }, "ScrapeRequest": { "properties": { "url": { "type": "string", "title": "Url", "description": "The URL to scrape" }, "formats": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Formats", "description": "Desired output formats" }, "only_main_content": { "type": "boolean", "title": "Only Main Content", "description": "Extract only the main content", "default": true }, "timeout": { "type": "integer", "maximum": 120.0, "minimum": 5.0, "title": "Timeout", "description": "Scrape timeout in seconds", "default": 30 }, "bypass_cloudflare": { "type": "boolean", "title": "Bypass Cloudflare", "description": "Auto-bypass Cloudflare", "default": true }, "js_render": { "type": "boolean", "title": "Js Render", "description": "Render JavaScript before scrape", "default": false } }, "type": "object", "required": [ "url" ], "title": "ScrapeRequest", "description": "Request body for POST /api/v1/scrape." }, "ScrapeResponse": { "properties": { "success": { "type": "boolean", "title": "Success" }, "data": { "additionalProperties": true, "type": "object", "title": "Data" }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" }, "timing_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Timing Ms" }, "job_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Id" } }, "type": "object", "required": [ "success" ], "title": "ScrapeResponse", "description": "Standardised scrape/extract response." }, "SearchHit": { "properties": { "content": { "type": "string", "title": "Content" }, "score": { "type": "number", "title": "Score", "default": 0.0 }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" }, "collection": { "type": "string", "title": "Collection", "default": "" }, "doc_id": { "type": "string", "title": "Doc Id", "default": "" } }, "type": "object", "required": [ "content" ], "title": "SearchHit", "description": "A single search result." }, "SearchRequest": { "properties": { "query": { "type": "string", "maxLength": 2048, "minLength": 1, "title": "Query" }, "collection": { "type": "string", "title": "Collection", "default": "scam_intel" }, "top_k": { "type": "integer", "maximum": 50.0, "minimum": 1.0, "title": "Top K", "default": 5 } }, "type": "object", "required": [ "query" ], "title": "SearchRequest", "description": "RAG search request." }, "SearchResponse": { "properties": { "query": { "type": "string", "title": "Query" }, "hits": { "items": { "$ref": "#/components/schemas/SearchHit" }, "type": "array", "title": "Hits" }, "took_ms": { "type": "number", "title": "Took Ms", "default": 0.0 }, "collections_searched": { "items": { "type": "string" }, "type": "array", "title": "Collections Searched" } }, "type": "object", "required": [ "query" ], "title": "SearchResponse", "description": "RAG search response." }, "SendMessageRequest": { "properties": { "content": { "type": "string", "maxLength": 65536, "minLength": 1, "title": "Content", "description": "Message content" } }, "type": "object", "required": [ "content" ], "title": "SendMessageRequest" }, "SendRequest": { "properties": { "newsletter_id": { "type": "string", "title": "Newsletter Id", "description": "ID of the newsletter to send" }, "test_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Test Email", "description": "Send test to a single email first" } }, "additionalProperties": false, "type": "object", "required": [ "newsletter_id" ], "title": "SendRequest", "description": "Request body for sending a newsletter." }, "SentimentRequest": { "properties": { "token": { "type": "string", "title": "Token" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "token" ], "title": "SentimentRequest" }, "SentinelModuleRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" }, "dev_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dev Address" } }, "type": "object", "required": [ "address" ], "title": "SentinelModuleRequest", "description": "Single SENTINEL module request." }, "SentinelScanRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" }, "dev_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dev Address" } }, "type": "object", "required": [ "address" ], "title": "SentinelScanRequest", "description": "Full 9-module SENTINEL deep scan." }, "ServiceIngestRequest": { "properties": { "source": { "type": "string", "maxLength": 64, "minLength": 1, "title": "Source", "description": "Service identifier, e.g. rugmaps" }, "data_type": { "type": "string", "maxLength": 64, "minLength": 1, "title": "Data Type", "description": "e.g. scraped_intel, scam_report, threat_intel, blockchain_data, entity_profile, wallet_cluster" }, "content": { "additionalProperties": true, "type": "object", "title": "Content", "description": "The intelligence payload as a JSON object" }, "url": { "type": "string", "maxLength": 4096, "title": "Url", "description": "Source URL the data was scraped from", "default": "" }, "token_address": { "type": "string", "maxLength": 128, "title": "Token Address", "description": "Token/entity address the data relates to", "default": "" }, "chain": { "type": "string", "maxLength": 32, "title": "Chain", "description": "Blockchain chain identifier", "default": "" }, "scraped_at": { "type": "string", "title": "Scraped At", "description": "ISO-8601 timestamp of when the data was produced", "default": "" } }, "type": "object", "required": [ "source", "data_type", "content" ], "title": "ServiceIngestRequest", "description": "Payload from internal services (rugmaps, pryscraper, bots, ...)." }, "SessionPutRequest": { "properties": { "session_id": { "anyOf": [ { "type": "string", "maxLength": 255, "minLength": 1 }, { "type": "null" } ], "title": "Session Id", "description": "Client-supplied session id; generated when omitted" }, "data": { "additionalProperties": true, "type": "object", "title": "Data" }, "ttl": { "type": "integer", "maximum": 2592000.0, "minimum": 1.0, "title": "Ttl", "description": "TTL in seconds (1s - 30d)", "default": 86400 } }, "type": "object", "title": "SessionPutRequest", "description": "Body for POST /sessions \u2014 create or upsert a session." }, "SessionResponse": { "properties": { "session_id": { "type": "string", "title": "Session Id" }, "data": { "additionalProperties": true, "type": "object", "title": "Data" }, "ttl": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Ttl" } }, "type": "object", "required": [ "session_id" ], "title": "SessionResponse", "description": "A stored session." }, "SmartMoneyAlphaRequest": { "properties": { "wallet": { "type": "string", "title": "Wallet" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "wallet" ], "title": "SmartMoneyAlphaRequest" }, "SplitRequest": { "properties": { "recipients": { "items": { "type": "string" }, "type": "array", "maxItems": 50, "minItems": 1, "title": "Recipients", "description": "Recipient usernames" }, "total_amount": { "type": "string", "title": "Total Amount", "description": "Total amount to split" }, "token": { "type": "string", "title": "Token", "default": "ETH" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" }, "room_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Room Id" } }, "type": "object", "required": [ "recipients", "total_amount" ], "title": "SplitRequest" }, "StorySourcesResponse": { "properties": { "cluster_id": { "type": "string", "title": "Cluster Id" }, "representative_title": { "type": "string", "title": "Representative Title", "default": "" }, "first_seen": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "First Seen" }, "last_updated": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Updated" }, "item_count": { "type": "integer", "title": "Item Count", "default": 0 }, "sentiment_avg": { "type": "number", "title": "Sentiment Avg", "default": 0.0 }, "source_count": { "type": "integer", "title": "Source Count", "default": 0 }, "sources": { "items": { "type": "string" }, "type": "array", "title": "Sources" }, "source_urls": { "items": { "type": "string" }, "type": "array", "title": "Source Urls" }, "bias_distribution": { "additionalProperties": { "type": "integer" }, "type": "object", "title": "Bias Distribution" }, "item_ids": { "items": { "type": "string" }, "type": "array", "title": "Item Ids" } }, "type": "object", "required": [ "cluster_id" ], "title": "StorySourcesResponse", "description": "Per-story source distribution for the bias-spectrum panel." }, "SubscribeRequest": { "properties": { "newsletter_id": { "type": "string", "title": "Newsletter Id", "description": "Newsletter ID to subscribe to" }, "email": { "anyOf": [ { "type": "string", "maxLength": 320 }, { "type": "null" } ], "title": "Email", "description": "Email address" }, "wallet_address": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ], "title": "Wallet Address", "description": "Crypto wallet address" }, "protocol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Protocol", "description": "nostr | farcaster | bluesky | mastodon | lens" }, "protocol_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Protocol Id", "description": "Decentralized identity (npub, FID, DID, handle)" }, "tier": { "type": "string", "title": "Tier", "description": "free | monthly | annual | founding", "default": "free" }, "interests": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Interests" }, "referrer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Referrer" } }, "additionalProperties": false, "type": "object", "required": [ "newsletter_id" ], "title": "SubscribeRequest", "description": "Request body for subscribing to a newsletter." }, "SubscriberImportRequest": { "properties": { "newsletter_id": { "type": "string", "title": "Newsletter Id" }, "subscribers": { "items": { "$ref": "#/components/schemas/SubscriberImportRow" }, "type": "array", "maxItems": 10000, "minItems": 1, "title": "Subscribers" }, "source": { "type": "string", "title": "Source", "default": "import" } }, "additionalProperties": false, "type": "object", "required": [ "newsletter_id", "subscribers" ], "title": "SubscriberImportRequest", "description": "Request body for importing subscribers." }, "SubscriberImportResponse": { "properties": { "imported": { "type": "integer", "title": "Imported" }, "skipped": { "type": "integer", "title": "Skipped" }, "errors": { "items": { "additionalProperties": { "type": "string" }, "type": "object" }, "type": "array", "title": "Errors" } }, "type": "object", "required": [ "imported", "skipped" ], "title": "SubscriberImportResponse", "description": "Response from subscriber import." }, "SubscriberImportRow": { "properties": { "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Email" }, "wallet_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Address" }, "protocol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Protocol" }, "protocol_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Protocol Id" }, "tier": { "type": "string", "title": "Tier", "default": "free" }, "interests": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Interests" } }, "additionalProperties": false, "type": "object", "title": "SubscriberImportRow", "description": "A single row in a subscriber import." }, "SubscriberListResponse": { "properties": { "items": { "items": { "$ref": "#/components/schemas/SubscriberOut" }, "type": "array", "title": "Items" }, "total": { "type": "integer", "title": "Total" }, "offset": { "type": "integer", "title": "Offset" }, "limit": { "type": "integer", "title": "Limit" } }, "type": "object", "required": [ "items", "total", "offset", "limit" ], "title": "SubscriberListResponse", "description": "Paginated subscriber list." }, "SubscriberOut": { "properties": { "id": { "type": "string", "title": "Id" }, "newsletter_id": { "type": "string", "title": "Newsletter Id" }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Email" }, "wallet_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Address" }, "protocol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Protocol" }, "protocol_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Protocol Id" }, "tier": { "type": "string", "title": "Tier", "default": "free" }, "status": { "type": "string", "title": "Status", "default": "active" }, "subscription_tx_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Subscription Tx Hash" }, "subscription_expires_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Subscription Expires At" }, "token_gate_holdings": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Token Gate Holdings" }, "interests": { "items": { "type": "string" }, "type": "array", "title": "Interests" }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" }, "created_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Created At" } }, "type": "object", "required": [ "id", "newsletter_id" ], "title": "SubscriberOut", "description": "Response body for a subscriber." }, "SubscriptionCreateRequest": { "properties": { "tier": { "type": "string", "title": "Tier", "default": "STARTER" }, "period": { "type": "string", "title": "Period", "default": "monthly" }, "payment_method": { "type": "string", "title": "Payment Method", "default": "card" }, "crypto_chain": { "type": "string", "title": "Crypto Chain", "default": "" }, "email": { "type": "string", "title": "Email", "default": "" }, "api_key": { "type": "string", "title": "Api Key", "default": "" } }, "type": "object", "title": "SubscriptionCreateRequest" }, "SwapQuoteRequest": { "properties": { "from_token": { "type": "string", "title": "From Token", "description": "Token to swap from" }, "to_token": { "type": "string", "title": "To Token", "description": "Token to swap to" }, "amount": { "type": "string", "title": "Amount", "description": "Amount to swap" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" }, "wallet_address": { "type": "string", "title": "Wallet Address", "description": "Wallet address for quote" } }, "type": "object", "required": [ "from_token", "to_token", "amount", "wallet_address" ], "title": "SwapQuoteRequest" }, "TelegramAlertRequest": { "properties": { "user_id": { "type": "integer", "exclusiveMinimum": 0.0, "title": "User Id", "description": "Telegram user_id to deliver alerts to" }, "event_types": { "items": { "$ref": "#/components/schemas/WebhookEventType" }, "type": "array", "minItems": 1, "title": "Event Types" }, "token_addresses": { "items": { "type": "string" }, "type": "array", "title": "Token Addresses" }, "chains": { "items": { "type": "string" }, "type": "array", "title": "Chains" }, "price_change_pct": { "anyOf": [ { "type": "number", "maximum": 100.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Price Change Pct" }, "min_value_usd": { "anyOf": [ { "type": "number", "minimum": 0.0 }, { "type": "null" } ], "title": "Min Value Usd" } }, "type": "object", "required": [ "user_id", "event_types" ], "title": "TelegramAlertRequest", "description": "API request to subscribe a bot user's chat to real events.\n\nUsed by the RugMunchBot (POST /api/v1/scanner/webhooks/telegram) so\n/alert and /watch can register a user for push alerts (whale moves,\nprice swings, liquidity changes) on a token without an external URL." }, "TelegramAuthRequest": { "properties": { "id": { "type": "integer", "title": "Id" }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "First Name" }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Name" }, "username": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Username" }, "photo_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Photo Url" }, "auth_date": { "type": "integer", "title": "Auth Date" }, "hash": { "type": "string", "title": "Hash" } }, "type": "object", "required": [ "id", "auth_date", "hash" ], "title": "TelegramAuthRequest" }, "TelegramBroadcastRequest": { "properties": { "message": { "type": "string", "title": "Message" } }, "type": "object", "required": [ "message" ], "title": "TelegramBroadcastRequest" }, "TelegramSendRequest": { "properties": { "chat_id": { "type": "string", "title": "Chat Id" }, "message": { "type": "string", "title": "Message" } }, "type": "object", "required": [ "chat_id", "message" ], "title": "TelegramSendRequest" }, "TemplateCreateRequest": { "properties": { "name": { "type": "string", "maxLength": 200, "minLength": 1, "title": "Name" }, "description": { "type": "string", "maxLength": 1000, "title": "Description", "default": "" }, "text": { "type": "string", "maxLength": 64000, "minLength": 1, "title": "Text" }, "platforms": { "items": { "type": "string" }, "type": "array", "title": "Platforms" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "content_category": { "type": "string", "title": "Content Category", "default": "general" } }, "type": "object", "required": [ "name", "text" ], "title": "TemplateCreateRequest", "description": "Request to create a post template." }, "TemplateListResponse": { "properties": { "templates": { "items": { "$ref": "#/components/schemas/PostTemplate" }, "type": "array", "title": "Templates" }, "total": { "type": "integer", "title": "Total", "default": 0 }, "categories": { "items": { "type": "string" }, "type": "array", "title": "Categories" } }, "type": "object", "title": "TemplateListResponse", "description": "List of post templates." }, "ThreatBatchRequest": { "properties": { "addresses": { "items": { "type": "string" }, "type": "array", "maxItems": 100, "minItems": 1, "title": "Addresses" }, "chain": { "type": "string", "title": "Chain", "default": "evm" } }, "type": "object", "required": [ "addresses" ], "title": "ThreatBatchRequest" }, "TipRequest": { "properties": { "recipient": { "type": "string", "title": "Recipient", "description": "Recipient username" }, "amount": { "type": "string", "title": "Amount", "description": "Tip amount" }, "token": { "type": "string", "title": "Token", "default": "ETH" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" }, "room_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Room Id" }, "message": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Message" } }, "type": "object", "required": [ "recipient", "amount" ], "title": "TipRequest" }, "TokenCheckRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain" } }, "type": "object", "required": [ "address", "chain" ], "title": "TokenCheckRequest" }, "TokenGateRequest": { "properties": { "token_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Token Address", "description": "Token contract/mint address" }, "token_symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Token Symbol", "description": "Token symbol (e.g., $TICKER)" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" }, "min_amount": { "type": "string", "title": "Min Amount", "description": "Minimum token amount required" }, "enabled": { "type": "boolean", "title": "Enabled", "default": true } }, "type": "object", "required": [ "min_amount" ], "title": "TokenGateRequest" }, "TokenMetricRequest": { "properties": { "token": { "type": "string", "title": "Token" }, "metrics": { "additionalProperties": { "type": "number" }, "type": "object", "title": "Metrics", "description": "Current metric values" } }, "type": "object", "required": [ "token", "metrics" ], "title": "TokenMetricRequest" }, "TokenRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "address" ], "title": "TokenRequest" }, "TokenRisk": { "properties": { "address": { "type": "string", "maxLength": 44, "minLength": 26, "pattern": "^0x[a-fA-F0-9]{40}$", "title": "Address" }, "chain": { "type": "string", "maxLength": 50, "minLength": 1, "pattern": "^(ethereum|bsc|polygon|arbitrum|base|optimism|avalanche|solana)$", "title": "Chain" }, "risk_score": { "type": "integer", "maximum": 100.0, "minimum": 0.0, "title": "Risk Score" }, "risk_tier": { "type": "string", "maxLength": 20, "minLength": 1, "title": "Risk Tier" }, "factors": { "items": { "type": "string" }, "type": "array", "title": "Factors", "default": [] } }, "type": "object", "required": [ "address", "chain", "risk_score", "risk_tier" ], "title": "TokenRisk", "description": "Token risk assessment." }, "TokenRiskResult": { "properties": { "risk_score": { "type": "integer", "maximum": 100.0, "minimum": 0.0, "title": "Risk Score", "description": "Risk score, 0=clean 100=definitely a rug" }, "risk_level": { "type": "string", "title": "Risk Level", "description": "One of \"low\", \"medium\", \"high\", \"critical\"" }, "is_honeypot": { "type": "boolean", "title": "Is Honeypot", "description": "True when the token can be bought but not sold" }, "is_rugpull": { "type": "boolean", "title": "Is Rugpull", "description": "True when the project shows rug-pull indicators" }, "warnings": { "items": { "type": "string" }, "type": "array", "title": "Warnings", "description": "Human-readable risk warnings" }, "deployer_risk": { "type": "string", "title": "Deployer Risk", "description": "Deployer reputation assessment" }, "liquidity_analysis": { "type": "string", "title": "Liquidity Analysis", "description": "Liquidity lock/burn/removal analysis" }, "recommendation": { "type": "string", "title": "Recommendation", "description": "One of \"safe\", \"caution\", \"avoid\"" } }, "type": "object", "required": [ "risk_score", "risk_level", "is_honeypot", "is_rugpull", "deployer_risk", "liquidity_analysis", "recommendation" ], "title": "TokenRiskResult", "description": "Structured token risk assessment from the Scanner Agent." }, "TokenScanRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "address" ], "title": "TokenScanRequest" }, "TraceDecodeRequest": { "properties": { "tx_hash": { "type": "string", "title": "Tx Hash", "description": "0x-prefixed transaction hash (64 hex chars)" }, "chain": { "type": "string", "title": "Chain", "description": "EVM chain name (ethereum, base, polygon, ...)", "default": "ethereum" } }, "type": "object", "required": [ "tx_hash" ], "title": "TraceDecodeRequest", "description": "Request contract for POST /api/v1/tracing/decode." }, "TwoFAEnableRequest": { "properties": { "code": { "type": "string", "maxLength": 6, "minLength": 6, "pattern": "^\\d{6}$", "title": "Code" } }, "type": "object", "required": [ "code" ], "title": "TwoFAEnableRequest" }, "TwoFALoginRequest": { "properties": { "email": { "type": "string", "title": "Email" }, "password": { "type": "string", "title": "Password" }, "code": { "type": "string", "maxLength": 10, "minLength": 6, "title": "Code" } }, "type": "object", "required": [ "email", "password", "code" ], "title": "TwoFALoginRequest" }, "TwoFAStatusResponse": { "properties": { "enabled": { "type": "boolean", "title": "Enabled" }, "method": { "type": "string", "title": "Method", "default": "totp" }, "created_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Created At" }, "last_used": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Used" } }, "type": "object", "required": [ "enabled" ], "title": "TwoFAStatusResponse" }, "TwoFAVerifyRequest": { "properties": { "code": { "type": "string", "maxLength": 6, "minLength": 6, "pattern": "^\\d{6}$", "title": "Code" } }, "type": "object", "required": [ "code" ], "title": "TwoFAVerifyRequest" }, "URLCheckRequest": { "properties": { "url": { "type": "string", "title": "Url" } }, "type": "object", "required": [ "url" ], "title": "URLCheckRequest" }, "URLRequest": { "properties": { "url": { "type": "string", "title": "Url" } }, "type": "object", "required": [ "url" ], "title": "URLRequest" }, "UnblockIPRequest": { "properties": { "ip": { "type": "string", "title": "Ip" } }, "type": "object", "required": [ "ip" ], "title": "UnblockIPRequest" }, "UpdatePostRequest": { "properties": { "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Title" }, "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Priority" }, "target_audience": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Target Audience" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "featured_image": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Featured Image" }, "attachments": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "title": "Attachments" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Tags" }, "scheduled_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scheduled At" }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expires At" }, "pinned": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Pinned" }, "allow_comments": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Allow Comments" }, "meta_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Meta Title" }, "meta_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Meta Description" }, "og_image": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Og Image" } }, "type": "object", "title": "UpdatePostRequest" }, "UpdateWebhookRequest": { "properties": { "url": { "anyOf": [ { "type": "string", "maxLength": 2048, "minLength": 1 }, { "type": "null" } ], "title": "Url" }, "event_types": { "anyOf": [ { "items": { "$ref": "#/components/schemas/WebhookEventType" }, "type": "array", "minItems": 1 }, { "type": "null" } ], "title": "Event Types" }, "filters": { "anyOf": [ { "$ref": "#/components/schemas/WebhookFilters" }, { "type": "null" } ] }, "active": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Active" } }, "type": "object", "title": "UpdateWebhookRequest", "description": "API request to update an existing webhook subscription.\n\nEvery field is optional \u2014 only provided fields are patched. ``active=False``\npauses delivery while keeping the subscription for later re-enable." }, "UsageRequest": { "properties": { "api_key": { "type": "string", "title": "Api Key" } }, "type": "object", "required": [ "api_key" ], "title": "UsageRequest" }, "UsageResponse": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "daily_calls": { "type": "integer", "title": "Daily Calls" }, "free_limit": { "type": "integer", "title": "Free Limit" }, "paid_calls": { "type": "integer", "title": "Paid Calls" }, "total_usd": { "type": "number", "title": "Total Usd" }, "recent_receipts": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Recent Receipts" } }, "type": "object", "required": [ "agent_id", "daily_calls", "free_limit", "paid_calls", "total_usd" ], "title": "UsageResponse" }, "UserResponse": { "properties": { "id": { "type": "string", "title": "Id" }, "email": { "type": "string", "title": "Email" }, "display_name": { "type": "string", "title": "Display Name" }, "wallet_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Address" }, "wallet_chain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Wallet Chain" }, "tier": { "type": "string", "title": "Tier" }, "role": { "type": "string", "title": "Role" }, "created_at": { "type": "string", "title": "Created At" }, "xp": { "type": "integer", "title": "Xp", "default": 0 }, "level": { "type": "integer", "title": "Level", "default": 1 }, "badges": { "items": { "type": "string" }, "type": "array", "title": "Badges", "default": [] } }, "type": "object", "required": [ "id", "email", "display_name", "wallet_address", "wallet_chain", "tier", "role", "created_at" ], "title": "UserResponse" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" }, "VerifyGateRequest": { "properties": { "address": { "type": "string", "title": "Address", "description": "Wallet address to verify" }, "chain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Chain" } }, "type": "object", "required": [ "address" ], "title": "VerifyGateRequest" }, "VerifyRequest": { "properties": { "api_key": { "type": "string", "title": "Api Key" } }, "type": "object", "required": [ "api_key" ], "title": "VerifyRequest" }, "VerifySignatureRequest": { "properties": { "address": { "type": "string", "maxLength": 44, "minLength": 26, "title": "Address" }, "chain": { "type": "string", "pattern": "^(ethereum|bsc|polygon|arbitrum|base|optimism|avalanche|solana)$", "title": "Chain", "default": "solana" }, "message": { "type": "string", "maxLength": 2000, "minLength": 1, "title": "Message" }, "signature": { "type": "string", "maxLength": 2000, "minLength": 1, "title": "Signature" } }, "type": "object", "required": [ "address", "message", "signature" ], "title": "VerifySignatureRequest", "description": "Request to verify a wallet signature (cross-app auth)." }, "VersionResponse": { "properties": { "version": { "type": "string", "title": "Version" }, "title": { "type": "string", "title": "Title" }, "description": { "type": "string", "title": "Description" }, "status": { "type": "string", "title": "Status", "default": "operational" } }, "type": "object", "required": [ "version", "title", "description" ], "title": "VersionResponse", "description": "Backend version info." }, "ViewAnalyticsDetail": { "properties": { "post_id": { "type": "string", "title": "Post Id", "default": "" }, "post_title": { "type": "string", "title": "Post Title", "default": "" }, "content_type": { "type": "string", "title": "Content Type", "default": "" }, "published_at": { "type": "string", "title": "Published At", "default": "" }, "summary": { "$ref": "#/components/schemas/ViewAnalyticsSummary" }, "protocol_breakdown": { "additionalProperties": { "$ref": "#/components/schemas/ViewAnalyticsSummary" }, "type": "object", "title": "Protocol Breakdown", "description": "Breakdown by protocol (nostr, farcaster, bluesky, mastodon)" } }, "type": "object", "title": "ViewAnalyticsDetail", "description": "Detailed per-post view analytics." }, "ViewAnalyticsSummary": { "properties": { "total_views": { "type": "integer", "title": "Total Views", "description": "Total view events (deduplicated)", "default": 0 }, "unique_viewers": { "type": "integer", "title": "Unique Viewers", "description": "Unique viewers by fingerprint/wallet", "default": 0 }, "total_watch_time_minutes": { "type": "number", "title": "Total Watch Time Minutes", "description": "Total minutes watched", "default": 0.0 }, "average_view_duration_seconds": { "type": "number", "title": "Average View Duration Seconds", "description": "Average view duration", "default": 0.0 }, "median_view_duration_seconds": { "type": "number", "title": "Median View Duration Seconds", "description": "Median view duration", "default": 0.0 }, "view_through_rate": { "type": "number", "title": "View Through Rate", "description": "% who watched to end (0-100)", "default": 0.0 }, "scroll_by_rate": { "type": "number", "title": "Scroll By Rate", "description": "% who scrolled past without watching (0-100)", "default": 0.0 }, "replay_views": { "type": "integer", "title": "Replay Views", "description": "Replay views of live/VOD content", "default": 0 }, "peak_concurrent_viewers": { "type": "integer", "title": "Peak Concurrent Viewers", "description": "Peak concurrent (live)", "default": 0 }, "drop_off_points": { "items": { "$ref": "#/components/schemas/DropOffPoint" }, "type": "array", "title": "Drop Off Points" }, "daily_trend": { "items": { "$ref": "#/components/schemas/app__domains__analytics__models__DataPoint" }, "type": "array", "title": "Daily Trend" }, "period": { "type": "string", "title": "Period", "default": "7d" } }, "type": "object", "title": "ViewAnalyticsSummary", "description": "True view analytics for a creator or post." }, "WalletAnalyzeRequest": { "properties": { "address": { "type": "string", "maxLength": 44, "minLength": 32, "title": "Address" }, "transactions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Transactions", "description": "Raw tx list for ML analysis" }, "chain": { "type": "string", "title": "Chain", "default": "auto" } }, "type": "object", "required": [ "address" ], "title": "WalletAnalyzeRequest" }, "WalletCheckRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "ethereum" } }, "type": "object", "required": [ "address" ], "title": "WalletCheckRequest" }, "WalletLabelsResponse": { "properties": { "success": { "type": "boolean", "title": "Success", "default": true }, "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain" }, "labels": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Labels" }, "is_scammer": { "type": "boolean", "title": "Is Scammer", "default": false }, "is_good_actor": { "type": "boolean", "title": "Is Good Actor", "default": false }, "deployer_profile": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Deployer Profile" } }, "type": "object", "required": [ "address", "chain", "labels" ], "title": "WalletLabelsResponse", "description": "Wallet labels response." }, "WalletListRequest": { "properties": { "addresses": { "items": { "type": "string" }, "type": "array", "title": "Addresses" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "addresses" ], "title": "WalletListRequest" }, "WalletRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "address" ], "title": "WalletRequest" }, "WalletResolveResponse": { "properties": { "chain": { "type": "string", "maxLength": 50, "minLength": 1, "pattern": "^(ethereum|bsc|polygon|arbitrum|base|optimism|avalanche|solana)$", "title": "Chain" }, "address": { "type": "string", "maxLength": 44, "minLength": 26, "title": "Address" }, "labels": { "items": { "type": "string" }, "type": "array", "title": "Labels", "default": [] }, "entity": { "anyOf": [ { "type": "string", "maxLength": 100, "minLength": 1 }, { "type": "null" } ], "title": "Entity" }, "balance_usd": { "anyOf": [ { "type": "number", "minimum": 0.0 }, { "type": "null" } ], "title": "Balance Usd" }, "tx_count": { "anyOf": [ { "type": "integer", "minimum": 0.0 }, { "type": "null" } ], "title": "Tx Count" } }, "type": "object", "required": [ "chain", "address" ], "title": "WalletResolveResponse", "description": "Response for wallet resolution." }, "WalletScanRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "" } }, "type": "object", "required": [ "address" ], "title": "WalletScanRequest" }, "WalletVerifyRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "signature": { "type": "string", "title": "Signature" }, "chain": { "type": "string", "title": "Chain", "default": "evm" } }, "type": "object", "required": [ "address", "signature" ], "title": "WalletVerifyRequest" }, "WebhookEventType": { "type": "string", "enum": [ "token.deployed", "token.first_swap", "token.price_change", "token.whale_move", "token.liquidity_change", "wallet.activity", "chain.block", "transaction.enhanced" ], "title": "WebhookEventType", "description": "Webhook event types \u2014 free-data sourced plus Helius-style enhanced tx.\n\n``TRANSACTION_ENHANCED`` mirrors Helius \"enhanced transaction\" webhooks:\na full decoded transaction with instruction-level detail (token transfers,\nnative SOL/ETH transfers, swap classification, account balance deltas)\ninstead of the aggregated row our poll providers emit." }, "WebhookFilters": { "properties": { "chains": { "items": { "type": "string" }, "type": "array", "title": "Chains", "description": "Filter by chain IDs (e.g. ['ethereum', 'solana']). Empty = all chains." }, "token_addresses": { "items": { "type": "string" }, "type": "array", "title": "Token Addresses", "description": "Filter by specific token addresses. Empty = all tokens." }, "min_value_usd": { "anyOf": [ { "type": "number", "minimum": 0.0 }, { "type": "null" } ], "title": "Min Value Usd", "description": "Minimum USD value for whale/liquidity events." }, "price_change_pct": { "anyOf": [ { "type": "number", "maximum": 100.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Price Change Pct", "description": "Minimum % price change for price_change events." }, "wallet_addresses": { "items": { "type": "string" }, "type": "array", "title": "Wallet Addresses", "description": "Watch specific wallets for wallet.activity events. Empty = no wallet filter." }, "transaction_types": { "items": { "type": "string" }, "type": "array", "title": "Transaction Types", "description": "Filter enhanced_transaction events by decoded transaction type (e.g. ['SWAP', 'TRANSFER', 'NFT_SALE', 'NFT_MINT']). Empty = all types." }, "program_ids": { "items": { "type": "string" }, "type": "array", "title": "Program Ids", "description": "Filter enhanced_transaction events by Solana program ID or EVM router address (e.g. Jupiter, Raydium, Uniswap). Empty = all programs." } }, "type": "object", "title": "WebhookFilters", "description": "Optional user-configurable filters per event type." }, "WebhookRegisterRequest": { "properties": { "url": { "type": "string", "title": "Url", "description": "Webhook callback URL" }, "events": { "items": { "type": "string" }, "type": "array", "title": "Events", "description": "Events to monitor", "default": [ "rug_pull", "whale_move", "price_crash" ] }, "address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Address", "description": "Specific address to watch (optional)" }, "chain": { "type": "string", "title": "Chain", "description": "Chain filter", "default": "all" } }, "type": "object", "required": [ "url" ], "title": "WebhookRegisterRequest" }, "WhaleAlert": { "properties": { "user_id": { "type": "string", "title": "User Id" }, "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain" }, "threshold_usd": { "type": "number", "title": "Threshold Usd", "default": 100000 }, "notify_telegram": { "type": "boolean", "title": "Notify Telegram", "default": true }, "label": { "type": "string", "title": "Label", "default": "" } }, "type": "object", "required": [ "user_id", "address", "chain" ], "title": "WhaleAlert" }, "app__api__v1__kv_migration__IdentityResponse": { "properties": { "address": { "type": "string", "title": "Address" }, "data": { "additionalProperties": true, "type": "object", "title": "Data" }, "updated_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Updated At" } }, "type": "object", "required": [ "address" ], "title": "IdentityResponse", "description": "An identity mapping." }, "app__api__v1__public__token__TokenSummary": { "properties": { "chain": { "type": "string", "maxLength": 50, "minLength": 1, "pattern": "^(ethereum|bsc|polygon|arbitrum|base|optimism|avalanche|solana)$", "title": "Chain" }, "address": { "type": "string", "maxLength": 44, "minLength": 26, "pattern": "^0x[a-fA-F0-9]{40}$", "title": "Address" }, "name": { "anyOf": [ { "type": "string", "maxLength": 100, "minLength": 1 }, { "type": "null" } ], "title": "Name" }, "symbol": { "anyOf": [ { "type": "string", "maxLength": 20, "minLength": 1 }, { "type": "null" } ], "title": "Symbol" }, "decimals": { "anyOf": [ { "type": "integer", "maximum": 18.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Decimals" }, "deployed_at": { "anyOf": [ { "type": "string", "maxLength": 100, "minLength": 1 }, { "type": "null" } ], "title": "Deployed At" }, "deployer": { "anyOf": [ { "type": "string", "maxLength": 44, "minLength": 26, "pattern": "^0x[a-fA-F0-9]{40}$" }, { "type": "null" } ], "title": "Deployer" } }, "type": "object", "required": [ "chain", "address" ], "title": "TokenSummary", "description": "Basic token metadata." }, "app__core__health_route__HealthResponse": { "properties": { "status": { "type": "string", "title": "Status" }, "version": { "type": "string", "title": "Version" }, "uptime_seconds": { "type": "number", "title": "Uptime Seconds" }, "stores": { "additionalProperties": { "additionalProperties": true, "type": "object" }, "type": "object", "title": "Stores" }, "rag_pipeline": { "additionalProperties": true, "type": "object", "title": "Rag Pipeline", "default": {} }, "config_issues": { "items": { "additionalProperties": { "type": "string" }, "type": "object" }, "type": "array", "title": "Config Issues", "default": [] } }, "additionalProperties": true, "type": "object", "required": [ "status", "version", "uptime_seconds", "stores" ], "title": "HealthResponse" }, "app__domains__analytics__models__DataPoint": { "properties": { "date": { "type": "string", "title": "Date", "description": "ISO date string", "default": "" }, "value": { "type": "number", "title": "Value", "description": "Metric value", "default": 0.0 }, "label": { "type": "string", "title": "Label", "default": "" } }, "type": "object", "title": "DataPoint", "description": "A single time-series data point." }, "app__domains__analytics__router__AnalyticsOverview": { "properties": { "views": { "$ref": "#/components/schemas/ViewAnalyticsSummary" }, "engagement": { "$ref": "#/components/schemas/EngagementAnalyticsSummary" }, "cross_protocol": { "$ref": "#/components/schemas/CrossProtocolSummary" }, "audience": { "$ref": "#/components/schemas/AudienceSummary" }, "insights": { "$ref": "#/components/schemas/ContentInsightsResponse" } }, "type": "object", "title": "AnalyticsOverview", "description": "Top-level overview of all analytics for a creator dashboard." }, "app__domains__billing__x402__shared_models__ClusterRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" }, "depth": { "type": "integer", "title": "Depth", "default": 3 } }, "type": "object", "required": [ "address" ], "title": "ClusterRequest" }, "app__domains__postiz__models__AnalyticsOverview": { "properties": { "total_posts": { "type": "integer", "title": "Total Posts", "default": 0 }, "total_published": { "type": "integer", "title": "Total Published", "default": 0 }, "total_impressions": { "type": "integer", "title": "Total Impressions", "default": 0 }, "total_engagements": { "type": "integer", "title": "Total Engagements", "default": 0 }, "total_followers": { "type": "integer", "title": "Total Followers", "default": 0 }, "engagement_rate": { "type": "number", "title": "Engagement Rate", "default": 0.0 }, "avg_engagement_rate": { "type": "number", "title": "Avg Engagement Rate", "default": 0.0 }, "reach": { "type": "integer", "title": "Reach", "default": 0 }, "impressions_growth": { "type": "number", "title": "Impressions Growth", "default": 0.0 }, "followers_growth": { "type": "number", "title": "Followers Growth", "default": 0.0 }, "active_platforms": { "type": "integer", "title": "Active Platforms", "default": 0 }, "posts_this_week": { "type": "integer", "title": "Posts This Week", "default": 0 }, "posts_this_month": { "type": "integer", "title": "Posts This Month", "default": 0 } }, "type": "object", "title": "AnalyticsOverview", "description": "Top-level analytics summary." }, "app__domains__postiz__models__DataPoint": { "properties": { "date": { "type": "string", "title": "Date", "default": "" }, "value": { "type": "number", "title": "Value", "default": 0.0 }, "label": { "type": "string", "title": "Label", "default": "" } }, "type": "object", "title": "DataPoint", "description": "A single time-series data point." }, "app__domains__scanner__webhooks__models__CreateWebhookRequest": { "properties": { "url": { "type": "string", "maxLength": 2048, "minLength": 1, "title": "Url" }, "event_types": { "items": { "$ref": "#/components/schemas/WebhookEventType" }, "type": "array", "minItems": 1, "title": "Event Types" }, "filters": { "anyOf": [ { "$ref": "#/components/schemas/WebhookFilters" }, { "type": "null" } ] } }, "type": "object", "required": [ "url", "event_types" ], "title": "CreateWebhookRequest", "description": "API request to create a webhook subscription." }, "app__routers__admin__backend__CreateWebhookRequest": { "properties": { "url": { "type": "string", "title": "Url" }, "events": { "items": { "type": "string" }, "type": "array", "title": "Events" }, "secret": { "type": "string", "title": "Secret", "default": "" } }, "type": "object", "required": [ "url" ], "title": "CreateWebhookRequest" }, "app__routers__ai_stream__StreamRequest": { "properties": { "prompt": { "type": "string", "title": "Prompt" }, "task": { "type": "string", "title": "Task", "default": "fast" }, "prefer": { "type": "string", "title": "Prefer", "default": "fast" }, "disable_rag": { "type": "boolean", "title": "Disable Rag", "default": false } }, "type": "object", "required": [ "prompt" ], "title": "StreamRequest" }, "app__routers__bulletin_board__models__CreatePostRequest": { "properties": { "title": { "type": "string", "maxLength": 200, "minLength": 1, "title": "Title" }, "content": { "type": "string", "minLength": 1, "title": "Content" }, "category": { "type": "string", "title": "Category", "default": "news" }, "priority": { "type": "string", "title": "Priority", "default": "normal" }, "target_audience": { "type": "string", "title": "Target Audience", "default": "all" }, "status": { "type": "string", "title": "Status", "default": "draft" }, "featured_image": { "type": "string", "title": "Featured Image", "default": "" }, "attachments": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Attachments" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "scheduled_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scheduled At" }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expires At" }, "pinned": { "type": "boolean", "title": "Pinned", "default": false }, "allow_comments": { "type": "boolean", "title": "Allow Comments", "default": false }, "meta_title": { "type": "string", "title": "Meta Title", "default": "" }, "meta_description": { "type": "string", "title": "Meta Description", "default": "" }, "og_image": { "type": "string", "title": "Og Image", "default": "" } }, "type": "object", "required": [ "title", "content" ], "title": "CreatePostRequest" }, "app__routers__chat___chat_models__StreamRequest": { "properties": { "message": { "type": "string", "maxLength": 2000, "minLength": 1, "title": "Message" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model" }, "tier": { "type": "string", "pattern": "^(T0|T1|T2|T3|T4)$", "title": "Tier", "default": "T2" }, "temperature": { "type": "number", "maximum": 2.0, "minimum": 0.0, "title": "Temperature", "default": 0.7 }, "max_tokens": { "type": "integer", "maximum": 8192.0, "minimum": 64.0, "title": "Max Tokens", "default": 512 } }, "type": "object", "required": [ "message" ], "title": "StreamRequest" }, "app__routers__degenfeed_proxy__CreatePostRequest": { "properties": { "text": { "type": "string", "maxLength": 2000, "minLength": 1, "title": "Text", "description": "Post content" }, "media_urls": { "items": { "type": "string" }, "type": "array", "maxItems": 4, "title": "Media Urls", "description": "Attached media URLs" }, "tags": { "items": { "type": "string" }, "type": "array", "maxItems": 10, "title": "Tags", "description": "Topic tags" }, "cross_post_to": { "items": { "type": "string" }, "type": "array", "maxItems": 5, "title": "Cross Post To", "description": "Additional protocols to cross-post to" } }, "type": "object", "required": [ "text" ], "title": "CreatePostRequest", "description": "Request body for creating a post." }, "app__routers__degenfeed_proxy__IdentityResponse": { "properties": { "protocol": { "type": "string", "title": "Protocol" }, "handle": { "type": "string", "title": "Handle" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Display Name" }, "avatar_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Avatar Url" }, "bio": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Bio" }, "follower_count": { "type": "integer", "title": "Follower Count", "default": 0 }, "following_count": { "type": "integer", "title": "Following Count", "default": 0 }, "verified": { "type": "boolean", "title": "Verified", "default": false }, "profiles": { "additionalProperties": true, "type": "object", "title": "Profiles" } }, "additionalProperties": true, "type": "object", "required": [ "protocol", "handle" ], "title": "IdentityResponse", "description": "Resolved identity across protocols." }, "app__routers__kol_intel__HealthResponse": { "properties": { "status": { "type": "string", "title": "Status" }, "scammers": { "type": "integer", "title": "Scammers" }, "wallets": { "type": "integer", "title": "Wallets" } }, "type": "object", "required": [ "status", "scammers", "wallets" ], "title": "HealthResponse" }, "app__routers__v1__tokens__TokenSummary": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Symbol" }, "decimals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Decimals" }, "total_supply": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Total Supply" }, "price_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Price Usd" } }, "type": "object", "required": [ "address", "chain" ], "title": "TokenSummary" }, "app__routers__wallet_clustering_router__ClusterRequest": { "properties": { "wallets": { "items": { "type": "string" }, "type": "array", "title": "Wallets" }, "min_confidence": { "type": "number", "title": "Min Confidence", "default": 0.3 }, "include_sleepers": { "type": "boolean", "title": "Include Sleepers", "default": true } }, "type": "object", "required": [ "wallets" ], "title": "ClusterRequest" }, "app__routers__x402_advanced_tools__models__AddressRequest": { "properties": { "address": { "type": "string", "title": "Address", "description": "Wallet or token address" }, "chain": { "type": "string", "title": "Chain", "default": "base" } }, "type": "object", "required": [ "address" ], "title": "AddressRequest", "description": "Wallet or token address request." }, "app__routers__x402_databus_tools__models__AddressRequest": { "properties": { "address": { "type": "string", "title": "Address" }, "chain": { "type": "string", "title": "Chain", "default": "solana" } }, "type": "object", "required": [ "address" ], "title": "AddressRequest" }, "app__routers__x402_premium_tools__AddressRequest": { "properties": { "address": { "type": "string", "title": "Address", "description": "Wallet address, token contract, or ENS name" }, "chain": { "type": "string", "title": "Chain", "description": "Blockchain: base, solana, ethereum, bsc, etc.", "default": "base" } }, "type": "object", "required": [ "address" ], "title": "AddressRequest" } } } }