Skip to content

FinceptTerminal is a modern finance application offering advanced market analytics, investment research, and economic data tools, designed for interactive exploration and data-driven decision-making in a user-friendly environment.

profile update

tilakpatel22397f3715d20f
diff --git "a/fincept-terminal-desktop/C\357\200\272windowsdiskfinceptTerminalfincept-terminal-desktopopenapi_temp.json" "b/fincept-terminal-desktop/C\357\200\272windowsdiskfinceptTerminalfincept-terminal-desktopopenapi_temp.json"
new file mode 100644
index 000000000..bad4997c5
--- /dev/null
+++ "b/fincept-terminal-desktop/C\357\200\272windowsdiskfinceptTerminalfincept-terminal-desktopopenapi_temp.json"
@@ -0,0 +1 @@
+{"openapi":"3.1.0","info":{"title":"Fincept API","description":"Modular Financial Data API","version":"3.0.0"},"paths":{"/auth/user/verify-simulate":{"post":{"tags":["authentication"],"summary":"Simulate User Verification","description":"Simulate OTP verification for testing purposes","operationId":"simulate_user_verification_auth_user_verify_simulate_post","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/register":{"post":{"tags":["users"],"summary":"Register User","description":"Register new user account","operationId":"register_user_user_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserRegistration"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/verify-otp":{"post":{"tags":["users"],"summary":"Verify Otp","description":"Verify OTP and activate account","operationId":"verify_otp_user_verify_otp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OTPVerification"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/login":{"post":{"tags":["users"],"summary":"Login User","description":"User login with history tracking","operationId":"login_user_user_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserLogin"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/forgot-password":{"post":{"tags":["users"],"summary":"Forgot Password","description":"Request password reset","operationId":"forgot_password_user_forgot_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordReset"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/reset-password":{"post":{"tags":["users"],"summary":"Reset Password","description":"Reset password with OTP","operationId":"reset_password_user_reset_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetConfirm"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/profile":{"get":{"tags":["users"],"summary":"Get User Profile","description":"Get user profile information","operationId":"get_user_profile_user_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"put":{"tags":["users"],"summary":"Update User Profile","description":"Update user profile","operationId":"update_user_profile_user_profile_put","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Profile Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/regenerate-api-key":{"post":{"tags":["users"],"summary":"Regenerate Api Key","description":"Regenerate user API key","operationId":"regenerate_api_key_user_regenerate_api_key_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/usage":{"get":{"tags":["users"],"summary":"Get User Usage","description":"Get user's API usage statistics","operationId":"get_user_usage_user_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/login-history":{"get":{"tags":["users"],"summary":"Get My Login History","description":"Get current user's login history","operationId":"get_my_login_history_user_login_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/subscribe":{"post":{"tags":["users"],"summary":"Subscribe To Database","description":"Subscribe to a database","operationId":"subscribe_to_database_user_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseSubscriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/subscriptions":{"get":{"tags":["users"],"summary":"Get User Subscriptions","description":"Get user's database subscriptions","operationId":"get_user_subscriptions_user_subscriptions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/transactions":{"get":{"tags":["users"],"summary":"Get User Transactions","description":"Get user's transaction history","operationId":"get_user_transactions_user_transactions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/account":{"delete":{"tags":["users"],"summary":"Delete User Account","description":"Delete user account","operationId":"delete_user_account_user_account_delete","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Confirmation Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/admin/users":{"get":{"tags":["users"],"summary":"List All Users","description":"List all users (admin only)","operationId":"list_all_users_user_admin_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/admin/user/{user_id}":{"get":{"tags":["users"],"summary":"Get User Details","description":"Get detailed user information (admin only)","operationId":"get_user_details_user_admin_user__user_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/admin/user/{user_id}/credits":{"post":{"tags":["users"],"summary":"Manage User Credits","description":"Manage user credits (admin only)","operationId":"manage_user_credits_user_admin_user__user_id__credits_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Credits Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/admin/stats":{"get":{"tags":["users"],"summary":"Get Admin Statistics","description":"Get system statistics (admin only)","operationId":"get_admin_statistics_user_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/register":{"post":{"tags":["guests"],"summary":"Register Device","description":"Register device and create guest user with temporary API key (50 credits one-time per IP)","operationId":"register_device_guest_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceRegistration"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/guest/status":{"get":{"tags":["guests"],"summary":"Guest Status","description":"Get guest user status and usage","operationId":"guest_status_guest_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/extend":{"post":{"tags":["guests"],"summary":"Extend Guest Session","description":"Extend guest session if near expiry","operationId":"extend_guest_session_guest_extend_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/usage":{"get":{"tags":["guests"],"summary":"Get Guest Usage","description":"Get guest user's API usage statistics","operationId":"get_guest_usage_guest_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/session":{"delete":{"tags":["guests"],"summary":"Delete Guest Session","description":"Delete guest session and all associated data","operationId":"delete_guest_session_guest_session_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/databases":{"get":{"tags":["guests"],"summary":"List Public Databases","description":"List public databases available to guests","operationId":"list_public_databases_guest_databases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/database/{database_name}/tables":{"get":{"tags":["guests"],"summary":"Get Database Tables Guest","description":"Get tables in database for guests","operationId":"get_database_tables_guest_guest_database__database_name__tables_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"database_name","in":"path","required":true,"schema":{"type":"string","title":"Database Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/guest/database/{database_name}/{table_name}/data":{"get":{"tags":["guests"],"summary":"Get Table Data Guest","description":"Get data from table for guests (limited)","operationId":"get_table_data_guest_guest_database__database_name___table_name__data_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"database_name","in":"path","required":true,"schema":{"type":"string","title":"Database Name"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/guest/admin/guests":{"get":{"tags":["guests"],"summary":"Get All Guests","description":"Get all guest users (admin only - would need admin auth in production)","operationId":"get_all_guests_guest_admin_guests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/guest/admin/cleanup":{"post":{"tags":["guests"],"summary":"Manual Cleanup Expired Guests","description":"Manually trigger cleanup of expired guests (admin only)","operationId":"manual_cleanup_expired_guests_guest_admin_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/guest/admin/stats":{"get":{"tags":["guests"],"summary":"Get Guest Statistics","description":"Get guest user statistics (admin only)","operationId":"get_guest_statistics_guest_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/system/config":{"get":{"tags":["admin"],"summary":"Get System Config","description":"Get all system configurations","operationId":"get_system_config_admin_system_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["admin"],"summary":"Create System Config","description":"Create system configuration","operationId":"create_system_config_admin_system_config_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemConfigRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/system/config/{config_id}":{"put":{"tags":["admin"],"summary":"Update System Config","description":"Update system configuration","operationId":"update_system_config_admin_system_config__config_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"integer","title":"Config Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Config Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete System Config","description":"Delete system configuration","operationId":"delete_system_config_admin_system_config__config_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"integer","title":"Config Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/usage":{"get":{"tags":["admin"],"summary":"Get Usage Analytics","description":"Get detailed API usage analytics","operationId":"get_usage_analytics_admin_analytics_usage_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/performance":{"get":{"tags":["admin"],"summary":"Get Performance Analytics","description":"Get performance analytics","operationId":"get_performance_analytics_admin_analytics_performance_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/login-audit":{"get":{"tags":["admin"],"summary":"Get Login Audit","description":"Get login audit log for all users","operationId":"get_login_audit_admin_login_audit_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"User Id"}},{"name":"ip_address","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"}},{"name":"success_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success Only"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/login-stats":{"get":{"tags":["admin"],"summary":"Get Login Stats","description":"Get login statistics","operationId":"get_login_stats_admin_login_stats_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/broadcast":{"post":{"tags":["admin"],"summary":"Broadcast Message","description":"Send broadcast message to users","operationId":"broadcast_message_admin_broadcast_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BroadcastMessageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/maintenance/cleanup":{"post":{"tags":["admin"],"summary":"Run Maintenance Cleanup","description":"Run system maintenance and cleanup","operationId":"run_maintenance_cleanup_admin_maintenance_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/logs":{"get":{"tags":["admin"],"summary":"Get System Logs","description":"Get system logs (mock implementation)","operationId":"get_system_logs_admin_logs_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"lines","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Lines"}},{"name":"level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Level"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/export/users":{"get":{"tags":["admin"],"summary":"Export Users Data","description":"Export users data","operationId":"export_users_data_admin_export_users_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/export/usage":{"get":{"tags":["admin"],"summary":"Export Usage Data","description":"Export API usage data","operationId":"export_usage_data_admin_export_usage_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/health":{"get":{"tags":["admin"],"summary":"Admin System Health","description":"Check admin system health","operationId":"admin_system_health_admin_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/users/simple":{"get":{"tags":["admin"],"summary":"Get All Users Simple","description":"Get all users' names and emails (simple list)","operationId":"get_all_users_simple_admin_users_simple_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/users":{"get":{"tags":["admin"],"summary":"List All Users","description":"List all users with filtering and pagination","operationId":"list_all_users_admin_users_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"account_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Type"}},{"name":"is_verified","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Verified"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Create User","description":"Create new user (admin only)","operationId":"create_user_admin_users_post","security":[{"APIKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}":{"get":{"tags":["admin"],"summary":"Get User Details","description":"Get detailed user information","operationId":"get_user_details_admin_users__user_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["admin"],"summary":"Update User","description":"Update user information","operationId":"update_user_admin_users__user_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete User","description":"Delete user account","operationId":"delete_user_admin_users__user_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/credits":{"post":{"tags":["admin"],"summary":"Adjust User Credits","description":"Adjust user credit balance","operationId":"adjust_user_credits_admin_users__user_id__credits_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditAdjustmentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/reset-password":{"post":{"tags":["admin"],"summary":"Reset User Password","description":"Reset user password","operationId":"reset_user_password_admin_users__user_id__reset_password_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Password Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/guests":{"get":{"tags":["admin"],"summary":"List Guest Users","description":"List all guest users","operationId":"list_guest_users_admin_guests_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}},{"name":"is_active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/guests/cleanup":{"post":{"tags":["admin"],"summary":"Cleanup Expired Guests Endpoint","description":"Manually cleanup expired guests","operationId":"cleanup_expired_guests_endpoint_admin_guests_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/guests/{guest_id}":{"delete":{"tags":["admin"],"summary":"Delete Guest User","description":"Delete specific guest user","operationId":"delete_guest_user_admin_guests__guest_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"guest_id","in":"path","required":true,"schema":{"type":"integer","title":"Guest Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/databases":{"get":{"tags":["admin"],"summary":"List Databases","description":"List all databases in registry","operationId":"list_databases_admin_databases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["admin"],"summary":"Create Database","description":"Create new database registry entry","operationId":"create_database_admin_databases_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseCreateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/databases/{database_id}":{"put":{"tags":["admin"],"summary":"Update Database","description":"Update database registry entry","operationId":"update_database_admin_databases__database_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"database_id","in":"path","required":true,"schema":{"type":"integer","title":"Database Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Db Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/system/stats":{"get":{"tags":["admin"],"summary":"Get System Statistics","description":"Get comprehensive system statistics","operationId":"get_system_statistics_admin_system_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/payment/create-order":{"post":{"tags":["payments"],"summary":"Create Payment Order","description":"Create multi-currency payment order\n\nFlow:\n1. Get plan base price (INR)\n2. Convert to user's currency\n3. Create Cashfree order\n4. Save to database\n5. Return checkout URL","operationId":"create_payment_order_payment_create_order_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/payment/webhook":{"post":{"tags":["payments"],"summary":"Cashfree Webhook","description":"Cashfree webhook handler - Processes payment confirmations\n\nSecurity Layers:\n1. Signature verification\n2. Timestamp validation\n3. Multi-currency amount verification\n4. Idempotency check","operationId":"cashfree_webhook_payment_webhook_post","parameters":[{"name":"x-webhook-signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Webhook-Signature"}},{"name":"x-webhook-timestamp","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Webhook-Timestamp"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/status/{order_id}":{"get":{"tags":["payments"],"summary":"Get Payment Status","description":"Poll payment status (for Terminal app)","operationId":"get_payment_status_payment_status__order_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/verify/{order_id}":{"post":{"tags":["payments"],"summary":"Manual Verify Payment","description":"Fallback verification via Cashfree API","operationId":"manual_verify_payment_payment_verify__order_id__post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/history":{"get":{"tags":["payments"],"summary":"Get Payment History","description":"Get user's payment history with currency info","operationId":"get_payment_history_payment_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/plans":{"get":{"tags":["payments"],"summary":"Get Available Plans","description":"Get all subscription plans with prices in specified currency\n\nAuto-detects currency for authenticated users:\n- If user is authenticated: Uses their preferred_currency or country-based currency\n- If user is not authenticated or no currency specified: Defaults to USD\n\nArgs:\n currency: ISO currency code (optional - overrides auto-detection)","operationId":"get_available_plans_payment_plans_get","parameters":[{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/currencies":{"get":{"tags":["payments"],"summary":"Get Supported Currencies","description":"Get list of all supported currencies with current rates","operationId":"get_supported_currencies_payment_currencies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/payment/refresh-rates":{"post":{"tags":["payments"],"summary":"Refresh Currency Rates","description":"Force refresh currency rates (admin/debugging)\nRate limit: once per hour per user","operationId":"refresh_currency_rates_payment_refresh_rates_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/payment/admin/transactions":{"get":{"tags":["payments"],"summary":"Admin Get Transactions","description":"Admin: View all transactions with currency filters","operationId":"admin_get_transactions_payment_admin_transactions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/user/currency":{"get":{"tags":["payments"],"summary":"Get User Currency","description":"Get user's currency preferences and auto-detected currency\n\nReturns:\n - preferred_currency: User's manually set preference\n - detected_currency: Auto-detected from country\n - effective_currency: What will be used (preferred > detected > USD)","operationId":"get_user_currency_payment_user_currency_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["payments"],"summary":"Update User Currency","description":"Update user's preferred currency\n\nArgs:\n currency: ISO currency code (e.g., \"INR\", \"USD\", \"EUR\")","operationId":"update_user_currency_payment_user_currency_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"currency","in":"query","required":true,"schema":{"type":"string","title":"Currency"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/single-domain/{domain}":{"get":{"tags":["news"],"summary":"Get News From Single Domain","description":"Get news from a single domain with 0.10 credit cost","operationId":"get_news_from_single_domain_news_single_domain__domain__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}],"title":"Category"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/multiple-domains":{"post":{"tags":["news"],"summary":"Get News From Multiple Domains","description":"Get news from multiple domains with 0.25 credit cost","operationId":"get_news_from_multiple_domains_news_multiple_domains_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/date-range":{"post":{"tags":["news"],"summary":"Get News By Date Range","description":"Get news within a specific date range with 0.15 credit cost","operationId":"get_news_by_date_range_news_date_range_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DateRangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/country/{country_code}":{"get":{"tags":["news"],"summary":"Get News By Country","description":"Get news from a specific country with 0.12 credit cost","operationId":"get_news_by_country_news_country__country_code__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_code","in":"path","required":true,"schema":{"type":"string","title":"Country Code"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}],"title":"Category"}},{"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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/topic-search":{"post":{"tags":["news"],"summary":"Search News By Topic","description":"Search news by keywords/topics with 0.12 credit cost","operationId":"search_news_by_topic_news_topic_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/categories":{"get":{"tags":["news"],"summary":"Get Available Categories","description":"Get list of available news categories (free endpoint)","operationId":"get_available_categories_news_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/news/pricing":{"get":{"tags":["news"],"summary":"Get News Pricing","description":"Get credit costs for different news operations (free endpoint)","operationId":"get_news_pricing_news_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/news/stats":{"get":{"tags":["news"],"summary":"Get News Usage Stats","description":"Get user's news API usage statistics","operationId":"get_news_usage_stats_news_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/analyze":{"post":{"tags":["news"],"summary":"Analyze News Article","description":"AI-powered news article analysis\nExtracts article content and performs comprehensive financial analysis\nCost: 10 credits","operationId":"analyze_news_article_news_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/support/tickets":{"get":{"tags":["support"],"summary":"Get User Tickets","description":"Get user's support tickets","operationId":"get_user_tickets_support_tickets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["support"],"summary":"Create Ticket","description":"Create new support ticket (requires authentication)","operationId":"create_ticket_support_tickets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/support/tickets/{ticket_id}":{"get":{"tags":["support"],"summary":"Get Ticket Details","description":"Get detailed ticket information with messages","operationId":"get_ticket_details_support_tickets__ticket_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["support"],"summary":"Update Ticket","description":"Update ticket status (user can only close/reopen)","operationId":"update_ticket_support_tickets__ticket_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/tickets/{ticket_id}/messages":{"post":{"tags":["support"],"summary":"Add Ticket Message","description":"Add message to support ticket","operationId":"add_ticket_message_support_tickets__ticket_id__messages_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/contact":{"post":{"tags":["support"],"summary":"Submit Contact Form","description":"Submit contact form (public endpoint)","operationId":"submit_contact_form_support_contact_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactFormCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/feedback":{"post":{"tags":["support"],"summary":"Submit Feedback","description":"Submit feedback (public endpoint)","operationId":"submit_feedback_support_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/categories":{"get":{"tags":["support"],"summary":"Get Support Categories","description":"Get available support categories (public endpoint)","operationId":"get_support_categories_support_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/support/stats":{"get":{"tags":["support"],"summary":"Get Support Stats","description":"Get user's support statistics","operationId":"get_support_stats_support_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/support/newsletter/subscribe":{"post":{"tags":["support"],"summary":"Subscribe To Newsletter","description":"Subscribe to Fincept newsletter (public endpoint - no authentication required)","operationId":"subscribe_to_newsletter_support_newsletter_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterSubscribe"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/newsletter/unsubscribe":{"post":{"tags":["support"],"summary":"Unsubscribe From Newsletter","description":"Unsubscribe from newsletter (public endpoint)","operationId":"unsubscribe_from_newsletter_support_newsletter_unsubscribe_post","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","format":"email","title":"Email"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/newsletter/status":{"get":{"tags":["support"],"summary":"Check Newsletter Status","description":"Check newsletter subscription status (public endpoint)","operationId":"check_newsletter_status_support_newsletter_status_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","format":"email","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions":{"get":{"tags":["chat"],"summary":"Get Chat Sessions","description":"Get user's chat sessions (both registered and guest users)","operationId":"get_chat_sessions_chat_sessions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["chat"],"summary":"Create Chat Session","description":"Create new chat session","operationId":"create_chat_session_chat_sessions_post","security":[{"APIKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatSessionCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/bulk-delete":{"delete":{"tags":["chat"],"summary":"Bulk Delete Sessions","description":"Bulk delete chat sessions (registered users only)","operationId":"bulk_delete_sessions_chat_sessions_bulk_delete_delete","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Session Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/sessions/{session_uuid}":{"get":{"tags":["chat"],"summary":"Get Chat Session","description":"Get specific chat session with messages","operationId":"get_chat_session_chat_sessions__session_uuid__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["chat"],"summary":"Delete Chat Session","description":"Delete chat session and all messages","operationId":"delete_chat_session_chat_sessions__session_uuid__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/{session_uuid}/messages":{"post":{"tags":["chat"],"summary":"Send Chat Message","description":"Send message to chat session and get AI response","operationId":"send_chat_message_chat_sessions__session_uuid__messages_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatMessageCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/{session_uuid}/activate":{"put":{"tags":["chat"],"summary":"Activate Chat Session","description":"Activate a chat session (deactivates others)","operationId":"activate_chat_session_chat_sessions__session_uuid__activate_put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/{session_uuid}/title":{"put":{"tags":["chat"],"summary":"Update Chat Title","description":"Update chat session title","operationId":"update_chat_title_chat_sessions__session_uuid__title_put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Title Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/stats":{"get":{"tags":["chat"],"summary":"Get Chat Statistics","description":"Get chat statistics for current user","operationId":"get_chat_statistics_chat_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/export":{"post":{"tags":["chat"],"summary":"Export Chat Sessions","description":"Export chat sessions to JSON (registered users only)","operationId":"export_chat_sessions_chat_export_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Export Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/admin/statistics":{"get":{"tags":["chat"],"summary":"Get Admin Chat Statistics","description":"Get system-wide chat statistics (admin only)","operationId":"get_admin_chat_statistics_chat_admin_statistics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/admin/sessions":{"get":{"tags":["chat"],"summary":"Get Admin Chat Sessions","description":"Get all chat sessions with pagination (admin only)","operationId":"get_admin_chat_sessions_chat_admin_sessions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"user_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/quick-chat":{"post":{"tags":["chat"],"summary":"Quick Chat","description":"Quick chat without session management (for testing)","operationId":"quick_chat_chat_quick_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatMessageCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/search":{"get":{"tags":["chat"],"summary":"Search Chat Messages","description":"Search chat messages","operationId":"search_chat_messages_chat_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/templates":{"get":{"tags":["chat"],"summary":"Get Chat Templates","description":"Get predefined chat templates (registered users only)","operationId":"get_chat_templates_chat_templates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/templates/{template_id}/start":{"post":{"tags":["chat"],"summary":"Start Template Session","description":"Start a chat session from template (registered users only)","operationId":"start_template_session_chat_templates__template_id__start_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"template_id","in":"path","required":true,"schema":{"type":"string","title":"Template Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/categories":{"get":{"tags":["forum"],"summary":"Get Forum Categories","description":"Get all forum categories (accessible to both users and guests)","operationId":"get_forum_categories_forum_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/forum/categories/{category_id}/posts":{"get":{"tags":["forum"],"summary":"Get Category Posts","description":"Get posts in a specific category","operationId":"get_category_posts_forum_categories__category_id__posts_get","parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"integer","title":"Category Id"}},{"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":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","pattern":"^(latest|popular|views|replies)$","default":"latest","title":"Sort By"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["forum"],"summary":"Create Forum Post","description":"Create new forum post (registered users only)","operationId":"create_forum_post_forum_categories__category_id__posts_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"integer","title":"Category Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumPostCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/trending":{"get":{"tags":["forum"],"summary":"Get Trending Posts","description":"Get trending forum posts","operationId":"get_trending_posts_forum_posts_trending_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}},{"name":"timeframe","in":"query","required":false,"schema":{"type":"string","pattern":"^(day|week|month)$","default":"week","title":"Timeframe"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/{post_uuid}":{"get":{"tags":["forum"],"summary":"Get Forum Post","description":"Get specific forum post with comments","operationId":"get_forum_post_forum_posts__post_uuid__get","parameters":[{"name":"post_uuid","in":"path","required":true,"schema":{"type":"string","title":"Post Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/{post_uuid}/comments":{"post":{"tags":["forum"],"summary":"Create Forum Comment","description":"Create comment on forum post (registered users only)","operationId":"create_forum_comment_forum_posts__post_uuid__comments_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"post_uuid","in":"path","required":true,"schema":{"type":"string","title":"Post Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumCommentCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/{post_uuid}/vote":{"post":{"tags":["forum"],"summary":"Vote On Post","description":"Vote on forum post (registered users only)","operationId":"vote_on_post_forum_posts__post_uuid__vote_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"post_uuid","in":"path","required":true,"schema":{"type":"string","title":"Post Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumVoteCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/comments/{comment_uuid}/vote":{"post":{"tags":["forum"],"summary":"Vote On Comment","description":"Vote on forum comment (registered users only)","operationId":"vote_on_comment_forum_comments__comment_uuid__vote_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"comment_uuid","in":"path","required":true,"schema":{"type":"string","title":"Comment Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumVoteCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/search":{"get":{"tags":["forum"],"summary":"Search Forum","description":"Search forum posts and comments","operationId":"search_forum_forum_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100,"title":"Q"}},{"name":"category_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Category Id"}},{"name":"post_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(all|posts|comments)$","default":"all","title":"Post Type"}},{"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":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/stats":{"get":{"tags":["forum"],"summary":"Get Forum Statistics","description":"Get forum statistics","operationId":"get_forum_statistics_forum_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/forum/profile/{username}":{"get":{"tags":["forum"],"summary":"Get Forum User Profile","description":"Get forum user profile (registered users only)","operationId":"get_forum_user_profile_forum_profile__username__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/profile":{"get":{"tags":["forum"],"summary":"Get My Forum Profile","description":"Get current user's forum profile","operationId":"get_my_forum_profile_forum_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"put":{"tags":["forum"],"summary":"Update Forum Profile","description":"Update current user's forum profile","operationId":"update_forum_profile_forum_profile_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumProfileUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/forum/admin/categories":{"post":{"tags":["forum"],"summary":"Create Forum Category","description":"Create new forum category (admin only)","operationId":"create_forum_category_forum_admin_categories_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Category Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/forum/admin/statistics":{"get":{"tags":["forum"],"summary":"Get Admin Forum Statistics","description":"Get detailed forum statistics (admin only)","operationId":"get_admin_forum_statistics_forum_admin_statistics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/upload":{"post":{"tags":["marketplace"],"summary":"Upload Dataset","description":"Upload dataset to marketplace with pricing options","operationId":"upload_dataset_marketplace_upload_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"metadata","in":"query","required":true,"schema":{"type":"string","title":"Metadata"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_dataset_marketplace_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets":{"get":{"tags":["marketplace"],"summary":"Browse Datasets","description":"Browse marketplace datasets (registered users only)","operationId":"browse_datasets_marketplace_datasets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"price_tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Tier"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","default":"uploaded_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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/my-purchases":{"get":{"tags":["marketplace"],"summary":"Get User Purchases","description":"Get user's dataset purchases","operationId":"get_user_purchases_marketplace_my_purchases_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/pricing":{"get":{"tags":["marketplace"],"summary":"Get Pricing Tiers","description":"Get available pricing tiers for dataset uploads","operationId":"get_pricing_tiers_marketplace_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/my-datasets":{"get":{"tags":["marketplace"],"summary":"Get My Datasets","description":"Get user's uploaded datasets with status filtering","operationId":"get_my_datasets_marketplace_my_datasets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets/{dataset_id}":{"patch":{"tags":["marketplace"],"summary":"Update Dataset","description":"Update dataset metadata (only owner can update, only if pending/rejected)","operationId":"update_dataset_marketplace_datasets__dataset_id__patch","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Update Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["marketplace"],"summary":"Delete Dataset","description":"Delete dataset (only owner can delete, only if not purchased by others)","operationId":"delete_dataset_marketplace_datasets__dataset_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["marketplace"],"summary":"Get Dataset Details","description":"Get detailed dataset information","operationId":"get_dataset_details_marketplace_datasets__dataset_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets/{dataset_id}/purchase":{"post":{"tags":["marketplace"],"summary":"Purchase Dataset","description":"Get free access to dataset (no payment required)","operationId":"purchase_dataset_marketplace_datasets__dataset_id__purchase_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetPurchaseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets/{dataset_id}/download":{"post":{"tags":["marketplace"],"summary":"Download Dataset","description":"Download dataset file (free for all registered users)","operationId":"download_dataset_marketplace_datasets__dataset_id__download_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/my-datasets/analytics":{"get":{"tags":["marketplace"],"summary":"Get Dataset Analytics","description":"Get analytics for user's uploaded datasets","operationId":"get_dataset_analytics_marketplace_my_datasets_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/revenue-analytics":{"get":{"tags":["marketplace"],"summary":"Get Admin Revenue Analytics","description":"Get marketplace revenue analytics for admin","operationId":"get_admin_revenue_analytics_marketplace_admin_revenue_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/stats":{"get":{"tags":["marketplace"],"summary":"Get Marketplace Stats","description":"Get comprehensive marketplace statistics","operationId":"get_marketplace_stats_marketplace_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/pending-datasets":{"get":{"tags":["marketplace"],"summary":"Get Pending Datasets","description":"Get all pending datasets for approval","operationId":"get_pending_datasets_marketplace_admin_pending_datasets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/datasets/{dataset_id}/approve":{"post":{"tags":["marketplace"],"summary":"Approve Dataset","description":"Approve a pending dataset","operationId":"approve_dataset_marketplace_admin_datasets__dataset_id__approve_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/admin/datasets/{dataset_id}/reject":{"post":{"tags":["marketplace"],"summary":"Reject Dataset","description":"Reject a pending dataset","operationId":"reject_dataset_marketplace_admin_datasets__dataset_id__reject_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Rejection Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research/papers/search":{"get":{"tags":["research","research"],"summary":"Search Papers","description":"Search academic papers from arXiv with pagination\nCost: 1 credit per 10 papers (per page)\nRate limit: 1 request per second\n\nReturns 10 papers per page. Each page costs 1 credit.\nExample: page=1 returns papers 1-10, page=2 returns papers 11-20","operationId":"search_papers_research_papers_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","description":"Search query (keywords separated by space)","title":"Query"},"description":"Search query (keywords separated by space)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research/papers/trending":{"get":{"tags":["research","research"],"summary":"Get Trending Papers","description":"Get trending recent papers by topic with pagination\nCost: 1 credit per 10 papers (per page)\nRate limit: 1 request per second","operationId":"get_trending_papers_research_papers_trending_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"topic","in":"query","required":true,"schema":{"type":"string","description":"Research topic","title":"Topic"},"description":"Research topic"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":7,"description":"Days to look back","default":30,"title":"Days"},"description":"Days to look back"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research/content-reader":{"post":{"tags":["research","research"],"summary":"Content Reader","description":"Extract and read content from web documents\nCost: 0.25 credits per request\nRate limit: 1 request per second","operationId":"content_reader_research_content_reader_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentReaderRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/web-search":{"post":{"tags":["research","research"],"summary":"Web Search","description":"Search the web for financial and market intelligence","operationId":"web_search_research_web_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/chat":{"post":{"tags":["research","research"],"summary":"Fincept Chat","description":"Official Fincept AI Chat","operationId":"fincept_chat_research_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/grokipedia":{"post":{"tags":["research","research"],"summary":"Grokipedia Fetch","description":"Fetch knowledge articles from Grokipedia (xAI's knowledge base)\n\nThis endpoint retrieves comprehensive articles from Grokipedia, covering various topics\nwith detailed content, references, and citations.\n\nCost: 0.25 credits per request\nRate limit: 1 request per second\n\nParameters:\n- slug: Article slug/identifier (e.g., \"artificial-intelligence\", \"climate-change\")\n- extract_refs: Extract and include references (default: true)\n- truncate: Limit content to N characters (optional)\n- citations: Include citation formatting (default: false)\n\nExample slugs:\n- \"bitcoin\"\n- \"machine-learning\"\n- \"quantum-computing\"\n- \"financial-markets\"","operationId":"grokipedia_fetch_research_grokipedia_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrokipediaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/pdf/extract":{"post":{"tags":["research","research"],"summary":"Extract Pdf Text","description":"Extract text from uploaded PDF file\nDynamic Pricing:\n- 1-10 pages: 1 credit\n- 11-50 pages: 2 credits\n- 51-100 pages: 3 credits\n- 101-200 pages: 5 credits\n- 201+ pages: 10 credits\nRate limit: 1 request per second\nMax file size: 10MB","operationId":"extract_pdf_text_research_pdf_extract_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_extract_pdf_text_research_pdf_extract_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/health":{"get":{"tags":["research","research"],"summary":"Research Health","description":"Health check for Fincept research module","operationId":"research_health_research_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/research/llm":{"post":{"tags":["research","research"],"summary":"General Llm Inference","description":"General-purpose LLM endpoint for running agents, processing data, and AI tasks.\n\nThis endpoint allows you to use Fincept API as your LLM provider for:\n- Running AI agents\n- Data processing and analysis\n- Code generation\n- Text summarization\n- Question answering\n- Any other LLM-based tasks\n\nCost: 5 credits per successful response\nNote: Credits are ONLY deducted on successful LLM response. If the LLM fails, no credits are charged.\n\nRate limit: 1 request per second","operationId":"general_llm_inference_research_llm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LLMRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/visual-analysis":{"post":{"tags":["research","research"],"summary":"Satellite Visual Analysis","description":"Multimodal Visual Analysis using GLM-4.6V for satellite imagery and visual understanding.\n\nThis endpoint enables advanced visual analysis capabilities including:\n- Satellite image analysis and interpretation\n- Geographic feature detection and classification\n- Land use and land cover analysis\n- Urban planning and infrastructure mapping\n- Environmental monitoring\n- Agricultural assessment\n- Disaster response and damage assessment\n- Object detection and counting in images\n- Visual question answering\n- Image description and captioning\n\nModel: GLM-4.6V (Multimodal Vision-Language Model)\n- Native multimodal understanding\n- 128K context window\n- Advanced visual reasoning\n- Function calling capabilities\n- High-resolution image processing\n\nCost: 10 credits per successful response\nNote: Credits are ONLY deducted on successful analysis. If the model fails, no credits are charged.\n\nRate limit: 1 request per second\n\nExample Use Cases:\n- \"Identify all buildings in this satellite image\"\n- \"What type of land use is shown in this area?\"\n- \"Detect any changes or anomalies in this image\"\n- \"Count the number of vehicles in this parking lot\"\n- \"Analyze the vegetation health in this agricultural field\"","operationId":"satellite_visual_analysis_research_visual_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisualAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/position":{"post":{"tags":["marine","marine"],"summary":"Get Vessel Position","description":"Get last known position of a vessel by IMO\nCost: 1 credit per request","operationId":"get_vessel_position_marine_vessel_position_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VesselPositionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/history":{"post":{"tags":["marine","marine"],"summary":"Get Vessel History","description":"Get complete historical location data for a vessel\nCost: 5 credits per request","operationId":"get_vessel_history_marine_vessel_history_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VesselPositionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/multi":{"post":{"tags":["marine","marine"],"summary":"Get Multi Vessel Positions","description":"Get last known positions for multiple vessels (max 50)\nCost: 3 credits per request","operationId":"get_multi_vessel_positions_marine_vessel_multi_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiVesselRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/area-search":{"post":{"tags":["marine","marine"],"summary":"Search Vessels In Area","description":"Search for all vessels in a defined geographic area\nCost: 2 credits per request","operationId":"search_vessels_in_area_marine_vessel_area_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/health":{"get":{"tags":["marine","marine"],"summary":"Marine Health","description":"Health check for marine module","operationId":"marine_health_marine_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/aircraft/health":{"get":{"tags":["aircraft","aircraft"],"summary":"Aircraft Health","description":"Health check for aircraft tracking module","operationId":"aircraft_health_aircraft_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/aircraft/track":{"post":{"tags":["aircraft","aircraft"],"summary":"Track Aircraft","description":"Track aircraft by ID using PlaneFinder API with Selenium\nCost: 0.25 credits per successful request\nRate limit: 1 request per second","operationId":"track_aircraft_aircraft_track_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AircraftRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/aircraft/{aircraft_id}":{"get":{"tags":["aircraft","aircraft"],"summary":"Get Aircraft Endpoint","description":"Get aircraft data by ID (raw format)\nSimple endpoint without authentication for testing","operationId":"get_aircraft_endpoint_aircraft__aircraft_id__get","parameters":[{"name":"aircraft_id","in":"path","required":true,"schema":{"type":"string","title":"Aircraft Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/aircraft/{aircraft_id}/raw":{"get":{"tags":["aircraft","aircraft"],"summary":"Get Aircraft Raw","description":"Get raw aircraft data by ID\nSimple endpoint without authentication for testing","operationId":"get_aircraft_raw_aircraft__aircraft_id__raw_get","parameters":[{"name":"aircraft_id","in":"path","required":true,"schema":{"type":"string","title":"Aircraft Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/health":{"get":{"tags":["twitter","twitter"],"summary":"Twitter Health","description":"Health check for Twitter integration module","operationId":"twitter_health_twitter_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/twitter/countries":{"get":{"tags":["twitter","twitter"],"summary":"Get Available Countries","description":"Get list of all available countries for Twitter trends\nNo authentication required","operationId":"get_available_countries_twitter_countries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/twitter/trends":{"get":{"tags":["twitter","twitter"],"summary":"Get Twitter Trends","description":"Get current Twitter trending topics for a country\n\nParameters:\n- country: Country name (optional, default: \"worldwide\")\n Examples: \"india\", \"usa\", \"uk\", \"japan\", \"brazil\", \"france\", etc.\n Use /twitter/countries to see all available countries\n\nCost: 0.5 credits per request\nRate limit: 1 request per 2 seconds","operationId":"get_twitter_trends_twitter_trends_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/user/tweets":{"get":{"tags":["twitter","twitter"],"summary":"Get User Tweets","description":"Get user's latest tweets (up to 20 per request)\n\nParameters:\n- username: Twitter screen name (e.g., \"elonmusk\")\n- user_id: Twitter user ID (recommended, more stable than username)\n- cursor: Pagination cursor for next page\n\nNote: Either username OR user_id is required. If both provided, user_id takes priority.\n\nCost: 1.0 credit per request (returns up to 20 tweets)\nRate limit: 1 request per 2 seconds\n\nReturns tweets sorted by created_at with pagination support.","operationId":"get_user_tweets_twitter_user_tweets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"username","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"}},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweets":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweets By Ids","description":"Get tweets by their IDs\n\nParameters:\n- tweet_ids: Comma-separated tweet IDs (e.g., \"1846987139428634858,1866332309399781537\")\n\nCost: 0.5 credits per request\nRate limit: 1 request per 2 seconds\n\nReturns tweet data for the specified IDs.","operationId":"get_tweets_by_ids_twitter_tweets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_ids","in":"query","required":true,"schema":{"type":"string","title":"Tweet Ids"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/replies":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Replies","description":"Get replies to a tweet (up to 20 per request)\n\nParameters:\n- tweet_id: The tweet ID to get replies for (required)\n- since_time: On or after specified unix timestamp in seconds (optional)\n- until_time: Before specified unix timestamp in seconds (optional)\n- cursor: Pagination cursor for next page (optional)\n\nNote: tweet_id must be an original tweet (not a reply to another tweet)\n and should be the first tweet in a thread.\n\nCost: 1.0 credit per request (returns up to 20 replies)\nRate limit: 1 request per 2 seconds\n\nReturns replies sorted by reply time (descending) with pagination support.","operationId":"get_tweet_replies_twitter_tweet_replies_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"since_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Since Time"}},{"name":"until_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Until Time"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/quotes":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Quotes","description":"Get quote tweets of a tweet (20 quotes per request)\n\nParameters:\n- tweet_id: The tweet ID to get quotes for (required)\n- since_time: On or after specified unix timestamp in seconds (optional)\n- until_time: Before specified unix timestamp in seconds (optional)\n- include_replies: Include replies in results (default: true)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 1.0 credit per request (returns 20 quotes)\nRate limit: 1 request per 2 seconds\n\nReturns quote tweets sorted by quote time (descending) with pagination support.","operationId":"get_tweet_quotes_twitter_tweet_quotes_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"since_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Since Time"}},{"name":"until_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Until Time"}},{"name":"include_replies","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Replies"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/retweeters":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Retweeters","description":"Get users who retweeted a tweet (~100 users per request)\n\nParameters:\n- tweet_id: The tweet ID to get retweeters for (required)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 1.5 credits per request (returns ~100 users)\nRate limit: 1 request per 2 seconds\n\nReturns users who retweeted the tweet, sorted by retweet time (descending) with pagination support.","operationId":"get_tweet_retweeters_twitter_tweet_retweeters_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/article":{"get":{"tags":["twitter","twitter"],"summary":"Get Twitter Article","description":"Get full article content from a Twitter article tweet\n\n⚠️ PREMIUM ENDPOINT - Costs 100 credits per article!\n\nParameters:\n- tweet_id: The tweet ID of the article (required)\n\nCost: 100 credits per article (PREMIUM)\nRate limit: 1 request per 2 seconds\n\nReturns full article content including title, preview, cover image, and full text.\nThis is a premium endpoint due to the comprehensive article data provided.","operationId":"get_twitter_article_twitter_article_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/thread_context":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Thread Context","description":"Get the full thread context of a tweet\n\nThis endpoint retrieves the entire conversation thread containing the specified tweet.\nFor example, if a thread has tweets t1 -> t2 -> t3 -> t4, t5, t6 (all replying to t3),\nproviding t3 will return the entire thread: t1, t2, t3, t4, t5, t6.\n\nParameters:\n- tweet_id: The tweet ID (can be a reply or original tweet)\n- cursor: Pagination cursor for next page (optional)\n\nNote: Pagination size varies due to Twitter API limitations.\nThe number of tweets per page is not fixed.\n\nCost: 2.0 credits per request (variable tweets per page)\nRate limit: 1 request per 2 seconds\n\nReturns the full thread context with pagination support.","operationId":"get_tweet_thread_context_twitter_tweet_thread_context_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/advanced_search":{"get":{"tags":["twitter","twitter"],"summary":"Advanced Tweet Search","description":"Advanced search for tweets with powerful query syntax\n\nSupports advanced Twitter search operators for precise tweet discovery.\n\nParameters:\n- query: Search query with advanced operators (required)\n Examples:\n - \"AI\" OR \"Twitter\" from:elonmusk since:2021-12-31_23:59:59_UTC\n - \"#bitcoin\" min_faves:100\n - \"python\" filter:verified\n See: https://github.com/igorbrigadir/twitter-advanced-search\n\n- query_type: \"Latest\" (chronological) or \"Top\" (most relevant)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 2.5 credits per request (up to 20 tweets)\nRate limit: 1 request per 2 seconds\n\nReturns search results with pagination support.","operationId":"advanced_tweet_search_twitter_tweet_advanced_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"query_type","in":"query","required":false,"schema":{"type":"string","default":"Latest","title":"Query Type"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/user/search":{"get":{"tags":["twitter","twitter"],"summary":"Search Users","description":"Search for Twitter users by keyword\n\nParameters:\n- query: Search keyword (required)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 1.5 credits per request\nRate limit: 1 request per 2 seconds\n\nReturns matching users with pagination support.","operationId":"search_users_twitter_user_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/user/mentions":{"get":{"tags":["twitter","twitter"],"summary":"Get User Mentions","description":"Get tweet mentions by user screen name\nEach page returns exactly 20 mentions\nOrder by mention time descending\nCost: 1.0 credit per request\nRate limit: 1 request per 2 seconds","operationId":"get_user_mentions_twitter_user_mentions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"userName","in":"query","required":true,"schema":{"type":"string","title":"Username"}},{"name":"sinceTime","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sincetime"}},{"name":"untilTime","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Untiltime"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/my-login-history":{"get":{"tags":["analytics"],"summary":"Get My Login History","description":"Get current user's login history (User only sees their own)","operationId":"get_my_login_history_analytics_my_login_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/admin/dashboard":{"get":{"tags":["analytics"],"summary":"Get Admin Dashboard","description":"Get comprehensive dashboard statistics (Admin only)","operationId":"get_admin_dashboard_analytics_admin_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/users/growth":{"get":{"tags":["analytics"],"summary":"Get User Growth","description":"Get user growth analytics (Admin only)","operationId":"get_user_growth_analytics_admin_users_growth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/engagement":{"get":{"tags":["analytics"],"summary":"Get Engagement Metrics","description":"Get user engagement metrics (Admin only)","operationId":"get_engagement_metrics_analytics_admin_engagement_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/api-stats":{"get":{"tags":["analytics"],"summary":"Get Api Statistics","description":"Get API usage statistics (Admin only)","operationId":"get_api_statistics_analytics_admin_api_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/usage":{"get":{"tags":["analytics"],"summary":"Get Usage Analytics","description":"Get detailed API usage analytics (Admin only)","operationId":"get_usage_analytics_analytics_admin_usage_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/admin/performance":{"get":{"tags":["analytics"],"summary":"Get Performance Analytics","description":"Get performance analytics (Admin only)","operationId":"get_performance_analytics_analytics_admin_performance_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/admin/login-audit":{"get":{"tags":["analytics"],"summary":"Get Login Audit","description":"Get login audit log for all users (Admin only)","operationId":"get_login_audit_analytics_admin_login_audit_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"User Id"}},{"name":"ip_address","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"}},{"name":"success_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success Only"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/admin/revenue-analytics":{"get":{"tags":["analytics"],"summary":"Get Admin Revenue Analytics","description":"Get marketplace revenue analytics (Admin only)","operationId":"get_admin_revenue_analytics_analytics_admin_revenue_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/subscription-analytics":{"get":{"tags":["analytics"],"summary":"Get Subscription Analytics","description":"Get subscription analytics (Admin only) - DISABLED - Payment system to be reimplemented","operationId":"get_subscription_analytics_analytics_admin_subscription_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/speech/decompose":{"post":{"tags":["speech"],"summary":"Decompose Speech","description":"Decompose financial/political speech into structured components.\n\n- Requires API key authentication\n- Costs 2-10 credits based on text size\n- Maximum text length: 500,000 characters\n- Processing is done asynchronously for long texts (>10K chars)\n\nCredit tiers:\n- <5K chars: 2 credits\n- <15K chars: 3 credits\n- <30K chars: 4 credits\n- <50K chars: 5 credits\n- <100K chars: 6 credits\n- <200K chars: 8 credits\n- 200K+ chars: 10 credits","operationId":"decompose_speech_speech_decompose_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpeechInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/speech/status/{analysis_id}":{"get":{"tags":["speech"],"summary":"Get Analysis Status","description":"Get status of a speech analysis (user can only access their own)","operationId":"get_analysis_status_speech_status__analysis_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"analysis_id","in":"path","required":true,"schema":{"type":"string","title":"Analysis Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/speech/history":{"get":{"tags":["speech"],"summary":"Get Analysis History","description":"Get user's speech analysis history","operationId":"get_analysis_history_speech_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/speech/result/{analysis_id}":{"get":{"tags":["speech"],"summary":"Get Full Result","description":"Get full decomposition result including raw passes (user's own only)","operationId":"get_full_result_speech_result__analysis_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"analysis_id","in":"path","required":true,"schema":{"type":"string","title":"Analysis Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/countries":{"get":{"tags":["trade"],"summary":"Get Countries","description":"Get list of countries with optional filtering\n\n- continent: Filter by continent ID (af, as, eu, na, sa, oc)\n- search: Search country name","operationId":"get_countries_trade_countries_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"continent","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Continent"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/continents":{"get":{"tags":["trade"],"summary":"Get Continents","description":"Get list of all continents","operationId":"get_continents_trade_continents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/trade/products":{"get":{"tags":["trade"],"summary":"Get Products","description":"Get product hierarchy\n\n- level: Filter by level (Section, HS2, HS4, HS6)\n- parent: Get children of parent HS code","operationId":"get_products_trade_products_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Level"}},{"name":"parent","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/bilateral":{"get":{"tags":["trade"],"summary":"Get Bilateral Trade","description":"Get bilateral trade data between countries\n\nReturns trade flows between exporters and importers for a specific product and year","operationId":"get_bilateral_trade_trade_bilateral_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":true,"schema":{"type":"string","description":"HS product code","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":true,"schema":{"type":"integer","description":"Year (1995-2023)","title":"Year"},"description":"Year (1995-2023)"},{"name":"exporter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Exporter country ID","title":"Exporter"},"description":"Exporter country ID"},{"name":"importer","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Importer country ID","title":"Importer"},"description":"Importer country ID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/country-partners/{country_id}":{"get":{"tags":["trade"],"summary":"Get Country Trade Partners","description":"Get top trading partners for a country (for Chord Diagram)\n\nReturns ranked list of trading partners with trade values","operationId":"get_country_trade_partners_trade_country_partners__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer","description":"Year (1995-2023)","title":"Year"},"description":"Year (1995-2023)"},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"flow_type","in":"query","required":false,"schema":{"type":"string","description":"export, import, or total","default":"total","title":"Flow Type"},"description":"export, import, or total"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/chord-data/{country_id}":{"get":{"tags":["trade"],"summary":"Get Chord Diagram Data","description":"Get data formatted for Chord Diagram visualization (like Bloomberg Terminal)\n\nReturns:\n- nodes: List of countries (source + top partners)\n- flows: Trade flows between countries\n- rankings: Ranked list of partners with total trade","operationId":"get_chord_diagram_data_trade_chord_data__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"year","in":"query","required":false,"schema":{"type":"integer","description":"Year (1995-2023)","default":2017,"title":"Year"},"description":"Year (1995-2023)"},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":50,"description":"Number of top partners","default":15,"title":"Top N"},"description":"Number of top partners"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/time-series/{country_id}":{"get":{"tags":["trade"],"summary":"Get Trade Time Series","description":"Get time series trade data for a country\n\nReturns trade values over time for trend analysis","operationId":"get_trade_time_series_trade_time_series__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"start_year","in":"query","required":false,"schema":{"type":"integer","default":1995,"title":"Start Year"}},{"name":"end_year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"End Year"}},{"name":"flow","in":"query","required":false,"schema":{"type":"string","description":"export, import, or both","default":"both","title":"Flow"},"description":"export, import, or both"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/growth/{country_id}":{"get":{"tags":["trade"],"summary":"Get Trade Growth","description":"Get trade growth rates for a country","operationId":"get_trade_growth_trade_growth__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}},{"name":"flow","in":"query","required":false,"schema":{"type":"string","description":"export or import","default":"export","title":"Flow"},"description":"export or import"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/balance/{country_id}":{"get":{"tags":["trade"],"summary":"Get Trade Balance","description":"Get trade balance (surplus/deficit) for a country","operationId":"get_trade_balance_trade_balance__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/top-exporters":{"get":{"tags":["trade"],"summary":"Get Top Exporters","description":"Get top exporting countries for a product","operationId":"get_top_exporters_trade_top_exporters_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/top-importers":{"get":{"tags":["trade"],"summary":"Get Top Importers","description":"Get top importing countries for a product","operationId":"get_top_importers_trade_top_importers_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/continent-trade":{"get":{"tags":["trade"],"summary":"Get Continent Trade","description":"Get trade by continent","operationId":"get_continent_trade_trade_continent_trade_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/health":{"get":{"tags":["trade"],"summary":"Health Check","description":"Health check for trade analytics API","operationId":"health_check_trade_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Root","description":"API status endpoint","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/cashfree-test":{"get":{"summary":"Cashfree Test Page","description":"Serve Cashfree payment test page","operationId":"cashfree_test_page_cashfree_test_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health Check","description":"System health check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/auth/status":{"get":{"summary":"Auth Status","description":"Check authentication status","operationId":"auth_status_auth_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/test":{"get":{"summary":"Test Endpoint","description":"Test endpoint","operationId":"test_endpoint_test_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/sync":{"post":{"summary":"Manual Mcp Sync","description":"Manually trigger MCP scripts sync from GitHub (Admin only)\n\nArgs:\n force: Force sync even if not time yet (default False)","operationId":"manual_mcp_sync_mcp_sync_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"force","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/status":{"get":{"summary":"Mcp Status","description":"Get MCP system status (tools available, last sync, etc.)","operationId":"mcp_status_mcp_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AircraftRequest":{"properties":{"aircraft_id":{"type":"string","title":"Aircraft Id"}},"type":"object","required":["aircraft_id"],"title":"AircraftRequest"},"AreaSearchRequest":{"properties":{"min_lat":{"type":"number","title":"Min Lat"},"max_lat":{"type":"number","title":"Max Lat"},"min_lng":{"type":"number","title":"Min Lng"},"max_lng":{"type":"number","title":"Max Lng"}},"type":"object","required":["min_lat","max_lat","min_lng","max_lng"],"title":"AreaSearchRequest"},"Body_extract_pdf_text_research_pdf_extract_post":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"PDF file to process"}},"type":"object","required":["file"],"title":"Body_extract_pdf_text_research_pdf_extract_post"},"Body_upload_dataset_marketplace_upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_dataset_marketplace_upload_post"},"BroadcastMessageRequest":{"properties":{"subject":{"type":"string","title":"Subject"},"message":{"type":"string","title":"Message"},"target_users":{"type":"string","title":"Target Users","default":"all"}},"type":"object","required":["subject","message"],"title":"BroadcastMessageRequest"},"ChatMessageCreate":{"properties":{"content":{"type":"string","title":"Content"}},"type":"object","required":["content"],"title":"ChatMessageCreate"},"ChatRequest":{"properties":{"messages":{"items":{},"type":"array","title":"Messages"},"model":{"type":"string","title":"Model","default":"meituan/longcat-flash-chat:free"}},"type":"object","required":["messages"],"title":"ChatRequest"},"ChatSessionCreate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":"New Conversation"}},"type":"object","title":"ChatSessionCreate"},"ContactFormCreate":{"properties":{"name":{"type":"string","title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"subject":{"type":"string","title":"Subject"},"message":{"type":"string","title":"Message"}},"type":"object","required":["name","email","subject","message"],"title":"ContactFormCreate"},"ContentReaderRequest":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"format":{"type":"string","title":"Format","default":"markdown"}},"type":"object","required":["url"],"title":"ContentReaderRequest"},"CreateOrderRequest":{"properties":{"plan_id":{"type":"string","title":"Plan Id"},"currency":{"type":"string","title":"Currency","default":"USD"}},"type":"object","required":["plan_id"],"title":"CreateOrderRequest"},"CreditAdjustmentRequest":{"properties":{"action":{"type":"string","title":"Action"},"amount":{"type":"integer","title":"Amount"},"reason":{"type":"string","title":"Reason","default":"Admin adjustment"}},"type":"object","required":["action","amount"],"title":"CreditAdjustmentRequest"},"DatabaseCreateRequest":{"properties":{"database_name":{"type":"string","title":"Database Name"},"display_name":{"type":"string","title":"Display Name"},"description":{"type":"string","title":"Description","default":""},"category":{"type":"string","title":"Category","default":"general"},"is_public":{"type":"boolean","title":"Is Public","default":false},"requires_subscription":{"type":"boolean","title":"Requires Subscription","default":true},"cost_per_request":{"type":"integer","title":"Cost Per Request","default":20},"free_tier_limit":{"type":"integer","title":"Free Tier Limit","default":10},"total_tables":{"type":"integer","title":"Total Tables","default":0}},"type":"object","required":["database_name","display_name"],"title":"DatabaseCreateRequest"},"DatabaseSubscriptionRequest":{"properties":{"database_name":{"type":"string","title":"Database Name"}},"type":"object","required":["database_name"],"title":"DatabaseSubscriptionRequest"},"DatasetPurchaseRequest":{"properties":{"payment_method":{"type":"string","title":"Payment Method","default":"subscription_credit"}},"type":"object","title":"DatasetPurchaseRequest"},"DateRangeRequest":{"properties":{"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"category":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}]},"limit":{"type":"integer","title":"Limit","default":10}},"type":"object","required":["start_date","end_date"],"title":"DateRangeRequest"},"DeviceRegistration":{"properties":{"device_id":{"type":"string","title":"Device Id"},"device_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device Name"},"platform":{"type":"string","title":"Platform"},"hardware_info":{"additionalProperties":true,"type":"object","title":"Hardware Info"}},"type":"object","required":["device_id","platform","hardware_info"],"title":"DeviceRegistration"},"FeedbackCreate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"rating":{"type":"integer","title":"Rating"},"feedback_text":{"type":"string","title":"Feedback Text"},"category":{"type":"string","title":"Category","default":"general"}},"type":"object","required":["rating","feedback_text"],"title":"FeedbackCreate"},"ForumCommentCreate":{"properties":{"content":{"type":"string","title":"Content"},"parent_comment_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Comment Id"}},"type":"object","required":["content"],"title":"ForumCommentCreate"},"ForumPostCreate":{"properties":{"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"category_id":{"type":"integer","title":"Category Id"}},"type":"object","required":["title","content","category_id"],"title":"ForumPostCreate"},"ForumProfileUpdate":{"properties":{"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"avatar_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Color"},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature"},"show_email":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Show Email"},"email_notifications":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Email Notifications"}},"type":"object","title":"ForumProfileUpdate"},"ForumVoteCreate":{"properties":{"vote_type":{"type":"string","title":"Vote Type"}},"type":"object","required":["vote_type"],"title":"ForumVoteCreate"},"GrokipediaRequest":{"properties":{"slug":{"type":"string","title":"Slug"},"extract_refs":{"type":"boolean","title":"Extract Refs","default":true},"truncate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Truncate"},"citations":{"type":"boolean","title":"Citations","default":false}},"type":"object","required":["slug"],"title":"GrokipediaRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LLMRequest":{"properties":{"prompt":{"type":"string","title":"Prompt"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","default":4096},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","default":0.7}},"type":"object","required":["prompt"],"title":"LLMRequest"},"MessageCreate":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"MessageCreate"},"MultiVesselRequest":{"properties":{"imos":{"items":{"type":"string"},"type":"array","title":"Imos"}},"type":"object","required":["imos"],"title":"MultiVesselRequest"},"NewsAnalysisRequest":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"NewsAnalysisRequest"},"NewsCategory":{"type":"string","enum":["business","technology","sports","entertainment","health","science","politics","world","local"],"title":"NewsCategory"},"NewsRequest":{"properties":{"domains":{"items":{"type":"string"},"type":"array","title":"Domains"},"category":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","default":"en"},"limit":{"type":"integer","title":"Limit","default":10}},"type":"object","required":["domains"],"title":"NewsRequest"},"NewsletterSubscribe":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":"website"}},"type":"object","required":["email"],"title":"NewsletterSubscribe"},"OTPVerification":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"otp":{"type":"string","title":"Otp"}},"type":"object","required":["email","otp"],"title":"OTPVerification"},"PasswordReset":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"PasswordReset"},"PasswordResetConfirm":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"otp":{"type":"string","title":"Otp"},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["email","otp","new_password"],"title":"PasswordResetConfirm"},"SpeechInput":{"properties":{"text":{"type":"string","maxLength":500000,"minLength":50,"title":"Text","description":"Raw speech text (50-500K chars)"}},"type":"object","required":["text"],"title":"SpeechInput"},"SystemConfigRequest":{"properties":{"config_key":{"type":"string","title":"Config Key"},"config_value":{"type":"string","title":"Config Value"},"config_type":{"type":"string","title":"Config Type","default":"string"},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["config_key","config_value"],"title":"SystemConfigRequest"},"TicketCreate":{"properties":{"subject":{"type":"string","title":"Subject"},"description":{"type":"string","title":"Description"},"category":{"type":"string","title":"Category"},"priority":{"type":"string","title":"Priority","default":"medium"}},"type":"object","required":["subject","description","category"],"title":"TicketCreate"},"TicketUpdate":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","title":"TicketUpdate"},"TopicSearchRequest":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"limit":{"type":"integer","title":"Limit","default":10}},"type":"object","required":["keywords"],"title":"TopicSearchRequest"},"UserCreateRequest":{"properties":{"username":{"type":"string","title":"Username"},"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"account_type":{"type":"string","title":"Account Type","default":"free"},"is_admin":{"type":"boolean","title":"Is Admin","default":false},"is_verified":{"type":"boolean","title":"Is Verified","default":true},"credit_balance":{"type":"integer","title":"Credit Balance","default":0}},"type":"object","required":["username","email","password"],"title":"UserCreateRequest"},"UserLogin":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"UserLogin"},"UserRegistration":{"properties":{"username":{"type":"string","title":"Username"},"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"preferred_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preferred Currency"}},"type":"object","required":["username","email","password"],"title":"UserRegistration"},"UserUpdateRequest":{"properties":{"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"account_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Type"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Verified"},"is_admin":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Admin"},"credit_balance":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credit Balance"}},"type":"object","title":"UserUpdateRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VesselPositionRequest":{"properties":{"imo":{"type":"string","title":"Imo"}},"type":"object","required":["imo"],"title":"VesselPositionRequest"},"VisualAnalysisRequest":{"properties":{"image_url":{"type":"string","title":"Image Url"},"prompt":{"type":"string","title":"Prompt"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","default":4096},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","default":0.7},"enable_thinking":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enable Thinking","default":false}},"type":"object","required":["image_url","prompt"],"title":"VisualAnalysisRequest"},"WebSearchRequest":{"properties":{"query":{"type":"string","title":"Query"},"engine":{"type":"string","title":"Engine","default":"google"}},"type":"object","required":["query"],"title":"WebSearchRequest"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}
\ No newline at end of file
diff --git a/fincept-terminal-desktop/openapi_temp.json b/fincept-terminal-desktop/openapi_temp.json
new file mode 100644
index 000000000..bad4997c5
--- /dev/null
+++ b/fincept-terminal-desktop/openapi_temp.json
@@ -0,0 +1 @@
+{"openapi":"3.1.0","info":{"title":"Fincept API","description":"Modular Financial Data API","version":"3.0.0"},"paths":{"/auth/user/verify-simulate":{"post":{"tags":["authentication"],"summary":"Simulate User Verification","description":"Simulate OTP verification for testing purposes","operationId":"simulate_user_verification_auth_user_verify_simulate_post","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/register":{"post":{"tags":["users"],"summary":"Register User","description":"Register new user account","operationId":"register_user_user_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserRegistration"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/verify-otp":{"post":{"tags":["users"],"summary":"Verify Otp","description":"Verify OTP and activate account","operationId":"verify_otp_user_verify_otp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OTPVerification"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/login":{"post":{"tags":["users"],"summary":"Login User","description":"User login with history tracking","operationId":"login_user_user_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserLogin"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/forgot-password":{"post":{"tags":["users"],"summary":"Forgot Password","description":"Request password reset","operationId":"forgot_password_user_forgot_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordReset"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/reset-password":{"post":{"tags":["users"],"summary":"Reset Password","description":"Reset password with OTP","operationId":"reset_password_user_reset_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetConfirm"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/profile":{"get":{"tags":["users"],"summary":"Get User Profile","description":"Get user profile information","operationId":"get_user_profile_user_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"put":{"tags":["users"],"summary":"Update User Profile","description":"Update user profile","operationId":"update_user_profile_user_profile_put","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Profile Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/regenerate-api-key":{"post":{"tags":["users"],"summary":"Regenerate Api Key","description":"Regenerate user API key","operationId":"regenerate_api_key_user_regenerate_api_key_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/usage":{"get":{"tags":["users"],"summary":"Get User Usage","description":"Get user's API usage statistics","operationId":"get_user_usage_user_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/login-history":{"get":{"tags":["users"],"summary":"Get My Login History","description":"Get current user's login history","operationId":"get_my_login_history_user_login_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/subscribe":{"post":{"tags":["users"],"summary":"Subscribe To Database","description":"Subscribe to a database","operationId":"subscribe_to_database_user_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseSubscriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/subscriptions":{"get":{"tags":["users"],"summary":"Get User Subscriptions","description":"Get user's database subscriptions","operationId":"get_user_subscriptions_user_subscriptions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/transactions":{"get":{"tags":["users"],"summary":"Get User Transactions","description":"Get user's transaction history","operationId":"get_user_transactions_user_transactions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/account":{"delete":{"tags":["users"],"summary":"Delete User Account","description":"Delete user account","operationId":"delete_user_account_user_account_delete","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Confirmation Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/admin/users":{"get":{"tags":["users"],"summary":"List All Users","description":"List all users (admin only)","operationId":"list_all_users_user_admin_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/user/admin/user/{user_id}":{"get":{"tags":["users"],"summary":"Get User Details","description":"Get detailed user information (admin only)","operationId":"get_user_details_user_admin_user__user_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/admin/user/{user_id}/credits":{"post":{"tags":["users"],"summary":"Manage User Credits","description":"Manage user credits (admin only)","operationId":"manage_user_credits_user_admin_user__user_id__credits_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Credits Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/user/admin/stats":{"get":{"tags":["users"],"summary":"Get Admin Statistics","description":"Get system statistics (admin only)","operationId":"get_admin_statistics_user_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/register":{"post":{"tags":["guests"],"summary":"Register Device","description":"Register device and create guest user with temporary API key (50 credits one-time per IP)","operationId":"register_device_guest_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceRegistration"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/guest/status":{"get":{"tags":["guests"],"summary":"Guest Status","description":"Get guest user status and usage","operationId":"guest_status_guest_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/extend":{"post":{"tags":["guests"],"summary":"Extend Guest Session","description":"Extend guest session if near expiry","operationId":"extend_guest_session_guest_extend_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/usage":{"get":{"tags":["guests"],"summary":"Get Guest Usage","description":"Get guest user's API usage statistics","operationId":"get_guest_usage_guest_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/session":{"delete":{"tags":["guests"],"summary":"Delete Guest Session","description":"Delete guest session and all associated data","operationId":"delete_guest_session_guest_session_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/databases":{"get":{"tags":["guests"],"summary":"List Public Databases","description":"List public databases available to guests","operationId":"list_public_databases_guest_databases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/guest/database/{database_name}/tables":{"get":{"tags":["guests"],"summary":"Get Database Tables Guest","description":"Get tables in database for guests","operationId":"get_database_tables_guest_guest_database__database_name__tables_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"database_name","in":"path","required":true,"schema":{"type":"string","title":"Database Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/guest/database/{database_name}/{table_name}/data":{"get":{"tags":["guests"],"summary":"Get Table Data Guest","description":"Get data from table for guests (limited)","operationId":"get_table_data_guest_guest_database__database_name___table_name__data_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"database_name","in":"path","required":true,"schema":{"type":"string","title":"Database Name"}},{"name":"table_name","in":"path","required":true,"schema":{"type":"string","title":"Table Name"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/guest/admin/guests":{"get":{"tags":["guests"],"summary":"Get All Guests","description":"Get all guest users (admin only - would need admin auth in production)","operationId":"get_all_guests_guest_admin_guests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/guest/admin/cleanup":{"post":{"tags":["guests"],"summary":"Manual Cleanup Expired Guests","description":"Manually trigger cleanup of expired guests (admin only)","operationId":"manual_cleanup_expired_guests_guest_admin_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/guest/admin/stats":{"get":{"tags":["guests"],"summary":"Get Guest Statistics","description":"Get guest user statistics (admin only)","operationId":"get_guest_statistics_guest_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/system/config":{"get":{"tags":["admin"],"summary":"Get System Config","description":"Get all system configurations","operationId":"get_system_config_admin_system_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["admin"],"summary":"Create System Config","description":"Create system configuration","operationId":"create_system_config_admin_system_config_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemConfigRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/system/config/{config_id}":{"put":{"tags":["admin"],"summary":"Update System Config","description":"Update system configuration","operationId":"update_system_config_admin_system_config__config_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"integer","title":"Config Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Config Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete System Config","description":"Delete system configuration","operationId":"delete_system_config_admin_system_config__config_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"config_id","in":"path","required":true,"schema":{"type":"integer","title":"Config Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/usage":{"get":{"tags":["admin"],"summary":"Get Usage Analytics","description":"Get detailed API usage analytics","operationId":"get_usage_analytics_admin_analytics_usage_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/performance":{"get":{"tags":["admin"],"summary":"Get Performance Analytics","description":"Get performance analytics","operationId":"get_performance_analytics_admin_analytics_performance_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/login-audit":{"get":{"tags":["admin"],"summary":"Get Login Audit","description":"Get login audit log for all users","operationId":"get_login_audit_admin_login_audit_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"User Id"}},{"name":"ip_address","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"}},{"name":"success_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success Only"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/login-stats":{"get":{"tags":["admin"],"summary":"Get Login Stats","description":"Get login statistics","operationId":"get_login_stats_admin_login_stats_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/broadcast":{"post":{"tags":["admin"],"summary":"Broadcast Message","description":"Send broadcast message to users","operationId":"broadcast_message_admin_broadcast_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BroadcastMessageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/maintenance/cleanup":{"post":{"tags":["admin"],"summary":"Run Maintenance Cleanup","description":"Run system maintenance and cleanup","operationId":"run_maintenance_cleanup_admin_maintenance_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/logs":{"get":{"tags":["admin"],"summary":"Get System Logs","description":"Get system logs (mock implementation)","operationId":"get_system_logs_admin_logs_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"lines","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Lines"}},{"name":"level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Level"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/export/users":{"get":{"tags":["admin"],"summary":"Export Users Data","description":"Export users data","operationId":"export_users_data_admin_export_users_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/export/usage":{"get":{"tags":["admin"],"summary":"Export Usage Data","description":"Export API usage data","operationId":"export_usage_data_admin_export_usage_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/health":{"get":{"tags":["admin"],"summary":"Admin System Health","description":"Check admin system health","operationId":"admin_system_health_admin_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/users/simple":{"get":{"tags":["admin"],"summary":"Get All Users Simple","description":"Get all users' names and emails (simple list)","operationId":"get_all_users_simple_admin_users_simple_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/users":{"get":{"tags":["admin"],"summary":"List All Users","description":"List all users with filtering and pagination","operationId":"list_all_users_admin_users_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"account_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Type"}},{"name":"is_verified","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Verified"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Create User","description":"Create new user (admin only)","operationId":"create_user_admin_users_post","security":[{"APIKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}":{"get":{"tags":["admin"],"summary":"Get User Details","description":"Get detailed user information","operationId":"get_user_details_admin_users__user_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["admin"],"summary":"Update User","description":"Update user information","operationId":"update_user_admin_users__user_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["admin"],"summary":"Delete User","description":"Delete user account","operationId":"delete_user_admin_users__user_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/credits":{"post":{"tags":["admin"],"summary":"Adjust User Credits","description":"Adjust user credit balance","operationId":"adjust_user_credits_admin_users__user_id__credits_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditAdjustmentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/users/{user_id}/reset-password":{"post":{"tags":["admin"],"summary":"Reset User Password","description":"Reset user password","operationId":"reset_user_password_admin_users__user_id__reset_password_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"integer","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Password Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/guests":{"get":{"tags":["admin"],"summary":"List Guest Users","description":"List all guest users","operationId":"list_guest_users_admin_guests_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}},{"name":"is_active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/guests/cleanup":{"post":{"tags":["admin"],"summary":"Cleanup Expired Guests Endpoint","description":"Manually cleanup expired guests","operationId":"cleanup_expired_guests_endpoint_admin_guests_cleanup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/guests/{guest_id}":{"delete":{"tags":["admin"],"summary":"Delete Guest User","description":"Delete specific guest user","operationId":"delete_guest_user_admin_guests__guest_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"guest_id","in":"path","required":true,"schema":{"type":"integer","title":"Guest Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/databases":{"get":{"tags":["admin"],"summary":"List Databases","description":"List all databases in registry","operationId":"list_databases_admin_databases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["admin"],"summary":"Create Database","description":"Create new database registry entry","operationId":"create_database_admin_databases_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatabaseCreateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/databases/{database_id}":{"put":{"tags":["admin"],"summary":"Update Database","description":"Update database registry entry","operationId":"update_database_admin_databases__database_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"database_id","in":"path","required":true,"schema":{"type":"integer","title":"Database Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Db Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/system/stats":{"get":{"tags":["admin"],"summary":"Get System Statistics","description":"Get comprehensive system statistics","operationId":"get_system_statistics_admin_system_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/payment/create-order":{"post":{"tags":["payments"],"summary":"Create Payment Order","description":"Create multi-currency payment order\n\nFlow:\n1. Get plan base price (INR)\n2. Convert to user's currency\n3. Create Cashfree order\n4. Save to database\n5. Return checkout URL","operationId":"create_payment_order_payment_create_order_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/payment/webhook":{"post":{"tags":["payments"],"summary":"Cashfree Webhook","description":"Cashfree webhook handler - Processes payment confirmations\n\nSecurity Layers:\n1. Signature verification\n2. Timestamp validation\n3. Multi-currency amount verification\n4. Idempotency check","operationId":"cashfree_webhook_payment_webhook_post","parameters":[{"name":"x-webhook-signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Webhook-Signature"}},{"name":"x-webhook-timestamp","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Webhook-Timestamp"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/status/{order_id}":{"get":{"tags":["payments"],"summary":"Get Payment Status","description":"Poll payment status (for Terminal app)","operationId":"get_payment_status_payment_status__order_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/verify/{order_id}":{"post":{"tags":["payments"],"summary":"Manual Verify Payment","description":"Fallback verification via Cashfree API","operationId":"manual_verify_payment_payment_verify__order_id__post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/history":{"get":{"tags":["payments"],"summary":"Get Payment History","description":"Get user's payment history with currency info","operationId":"get_payment_history_payment_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/plans":{"get":{"tags":["payments"],"summary":"Get Available Plans","description":"Get all subscription plans with prices in specified currency\n\nAuto-detects currency for authenticated users:\n- If user is authenticated: Uses their preferred_currency or country-based currency\n- If user is not authenticated or no currency specified: Defaults to USD\n\nArgs:\n currency: ISO currency code (optional - overrides auto-detection)","operationId":"get_available_plans_payment_plans_get","parameters":[{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/currencies":{"get":{"tags":["payments"],"summary":"Get Supported Currencies","description":"Get list of all supported currencies with current rates","operationId":"get_supported_currencies_payment_currencies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/payment/refresh-rates":{"post":{"tags":["payments"],"summary":"Refresh Currency Rates","description":"Force refresh currency rates (admin/debugging)\nRate limit: once per hour per user","operationId":"refresh_currency_rates_payment_refresh_rates_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/payment/admin/transactions":{"get":{"tags":["payments"],"summary":"Admin Get Transactions","description":"Admin: View all transactions with currency filters","operationId":"admin_get_transactions_payment_admin_transactions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payment/user/currency":{"get":{"tags":["payments"],"summary":"Get User Currency","description":"Get user's currency preferences and auto-detected currency\n\nReturns:\n - preferred_currency: User's manually set preference\n - detected_currency: Auto-detected from country\n - effective_currency: What will be used (preferred > detected > USD)","operationId":"get_user_currency_payment_user_currency_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["payments"],"summary":"Update User Currency","description":"Update user's preferred currency\n\nArgs:\n currency: ISO currency code (e.g., \"INR\", \"USD\", \"EUR\")","operationId":"update_user_currency_payment_user_currency_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"currency","in":"query","required":true,"schema":{"type":"string","title":"Currency"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/single-domain/{domain}":{"get":{"tags":["news"],"summary":"Get News From Single Domain","description":"Get news from a single domain with 0.10 credit cost","operationId":"get_news_from_single_domain_news_single_domain__domain__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}],"title":"Category"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/multiple-domains":{"post":{"tags":["news"],"summary":"Get News From Multiple Domains","description":"Get news from multiple domains with 0.25 credit cost","operationId":"get_news_from_multiple_domains_news_multiple_domains_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/date-range":{"post":{"tags":["news"],"summary":"Get News By Date Range","description":"Get news within a specific date range with 0.15 credit cost","operationId":"get_news_by_date_range_news_date_range_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DateRangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/country/{country_code}":{"get":{"tags":["news"],"summary":"Get News By Country","description":"Get news from a specific country with 0.12 credit cost","operationId":"get_news_by_country_news_country__country_code__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_code","in":"path","required":true,"schema":{"type":"string","title":"Country Code"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}],"title":"Category"}},{"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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/topic-search":{"post":{"tags":["news"],"summary":"Search News By Topic","description":"Search news by keywords/topics with 0.12 credit cost","operationId":"search_news_by_topic_news_topic_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/categories":{"get":{"tags":["news"],"summary":"Get Available Categories","description":"Get list of available news categories (free endpoint)","operationId":"get_available_categories_news_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/news/pricing":{"get":{"tags":["news"],"summary":"Get News Pricing","description":"Get credit costs for different news operations (free endpoint)","operationId":"get_news_pricing_news_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/news/stats":{"get":{"tags":["news"],"summary":"Get News Usage Stats","description":"Get user's news API usage statistics","operationId":"get_news_usage_stats_news_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/news/analyze":{"post":{"tags":["news"],"summary":"Analyze News Article","description":"AI-powered news article analysis\nExtracts article content and performs comprehensive financial analysis\nCost: 10 credits","operationId":"analyze_news_article_news_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/support/tickets":{"get":{"tags":["support"],"summary":"Get User Tickets","description":"Get user's support tickets","operationId":"get_user_tickets_support_tickets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"post":{"tags":["support"],"summary":"Create Ticket","description":"Create new support ticket (requires authentication)","operationId":"create_ticket_support_tickets_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/support/tickets/{ticket_id}":{"get":{"tags":["support"],"summary":"Get Ticket Details","description":"Get detailed ticket information with messages","operationId":"get_ticket_details_support_tickets__ticket_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["support"],"summary":"Update Ticket","description":"Update ticket status (user can only close/reopen)","operationId":"update_ticket_support_tickets__ticket_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/tickets/{ticket_id}/messages":{"post":{"tags":["support"],"summary":"Add Ticket Message","description":"Add message to support ticket","operationId":"add_ticket_message_support_tickets__ticket_id__messages_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"ticket_id","in":"path","required":true,"schema":{"type":"integer","title":"Ticket Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/contact":{"post":{"tags":["support"],"summary":"Submit Contact Form","description":"Submit contact form (public endpoint)","operationId":"submit_contact_form_support_contact_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactFormCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/feedback":{"post":{"tags":["support"],"summary":"Submit Feedback","description":"Submit feedback (public endpoint)","operationId":"submit_feedback_support_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/categories":{"get":{"tags":["support"],"summary":"Get Support Categories","description":"Get available support categories (public endpoint)","operationId":"get_support_categories_support_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/support/stats":{"get":{"tags":["support"],"summary":"Get Support Stats","description":"Get user's support statistics","operationId":"get_support_stats_support_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/support/newsletter/subscribe":{"post":{"tags":["support"],"summary":"Subscribe To Newsletter","description":"Subscribe to Fincept newsletter (public endpoint - no authentication required)","operationId":"subscribe_to_newsletter_support_newsletter_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterSubscribe"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/newsletter/unsubscribe":{"post":{"tags":["support"],"summary":"Unsubscribe From Newsletter","description":"Unsubscribe from newsletter (public endpoint)","operationId":"unsubscribe_from_newsletter_support_newsletter_unsubscribe_post","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","format":"email","title":"Email"}},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/support/newsletter/status":{"get":{"tags":["support"],"summary":"Check Newsletter Status","description":"Check newsletter subscription status (public endpoint)","operationId":"check_newsletter_status_support_newsletter_status_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","format":"email","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions":{"get":{"tags":["chat"],"summary":"Get Chat Sessions","description":"Get user's chat sessions (both registered and guest users)","operationId":"get_chat_sessions_chat_sessions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["chat"],"summary":"Create Chat Session","description":"Create new chat session","operationId":"create_chat_session_chat_sessions_post","security":[{"APIKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatSessionCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/bulk-delete":{"delete":{"tags":["chat"],"summary":"Bulk Delete Sessions","description":"Bulk delete chat sessions (registered users only)","operationId":"bulk_delete_sessions_chat_sessions_bulk_delete_delete","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Session Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/sessions/{session_uuid}":{"get":{"tags":["chat"],"summary":"Get Chat Session","description":"Get specific chat session with messages","operationId":"get_chat_session_chat_sessions__session_uuid__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["chat"],"summary":"Delete Chat Session","description":"Delete chat session and all messages","operationId":"delete_chat_session_chat_sessions__session_uuid__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/{session_uuid}/messages":{"post":{"tags":["chat"],"summary":"Send Chat Message","description":"Send message to chat session and get AI response","operationId":"send_chat_message_chat_sessions__session_uuid__messages_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatMessageCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/{session_uuid}/activate":{"put":{"tags":["chat"],"summary":"Activate Chat Session","description":"Activate a chat session (deactivates others)","operationId":"activate_chat_session_chat_sessions__session_uuid__activate_put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/sessions/{session_uuid}/title":{"put":{"tags":["chat"],"summary":"Update Chat Title","description":"Update chat session title","operationId":"update_chat_title_chat_sessions__session_uuid__title_put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"session_uuid","in":"path","required":true,"schema":{"type":"string","title":"Session Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Title Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/stats":{"get":{"tags":["chat"],"summary":"Get Chat Statistics","description":"Get chat statistics for current user","operationId":"get_chat_statistics_chat_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/export":{"post":{"tags":["chat"],"summary":"Export Chat Sessions","description":"Export chat sessions to JSON (registered users only)","operationId":"export_chat_sessions_chat_export_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Export Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/admin/statistics":{"get":{"tags":["chat"],"summary":"Get Admin Chat Statistics","description":"Get system-wide chat statistics (admin only)","operationId":"get_admin_chat_statistics_chat_admin_statistics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/admin/sessions":{"get":{"tags":["chat"],"summary":"Get Admin Chat Sessions","description":"Get all chat sessions with pagination (admin only)","operationId":"get_admin_chat_sessions_chat_admin_sessions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"user_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/quick-chat":{"post":{"tags":["chat"],"summary":"Quick Chat","description":"Quick chat without session management (for testing)","operationId":"quick_chat_chat_quick_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatMessageCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/search":{"get":{"tags":["chat"],"summary":"Search Chat Messages","description":"Search chat messages","operationId":"search_chat_messages_chat_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chat/templates":{"get":{"tags":["chat"],"summary":"Get Chat Templates","description":"Get predefined chat templates (registered users only)","operationId":"get_chat_templates_chat_templates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/chat/templates/{template_id}/start":{"post":{"tags":["chat"],"summary":"Start Template Session","description":"Start a chat session from template (registered users only)","operationId":"start_template_session_chat_templates__template_id__start_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"template_id","in":"path","required":true,"schema":{"type":"string","title":"Template Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/categories":{"get":{"tags":["forum"],"summary":"Get Forum Categories","description":"Get all forum categories (accessible to both users and guests)","operationId":"get_forum_categories_forum_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/forum/categories/{category_id}/posts":{"get":{"tags":["forum"],"summary":"Get Category Posts","description":"Get posts in a specific category","operationId":"get_category_posts_forum_categories__category_id__posts_get","parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"integer","title":"Category Id"}},{"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":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","pattern":"^(latest|popular|views|replies)$","default":"latest","title":"Sort By"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["forum"],"summary":"Create Forum Post","description":"Create new forum post (registered users only)","operationId":"create_forum_post_forum_categories__category_id__posts_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"integer","title":"Category Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumPostCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/trending":{"get":{"tags":["forum"],"summary":"Get Trending Posts","description":"Get trending forum posts","operationId":"get_trending_posts_forum_posts_trending_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}},{"name":"timeframe","in":"query","required":false,"schema":{"type":"string","pattern":"^(day|week|month)$","default":"week","title":"Timeframe"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/{post_uuid}":{"get":{"tags":["forum"],"summary":"Get Forum Post","description":"Get specific forum post with comments","operationId":"get_forum_post_forum_posts__post_uuid__get","parameters":[{"name":"post_uuid","in":"path","required":true,"schema":{"type":"string","title":"Post Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/{post_uuid}/comments":{"post":{"tags":["forum"],"summary":"Create Forum Comment","description":"Create comment on forum post (registered users only)","operationId":"create_forum_comment_forum_posts__post_uuid__comments_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"post_uuid","in":"path","required":true,"schema":{"type":"string","title":"Post Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumCommentCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/posts/{post_uuid}/vote":{"post":{"tags":["forum"],"summary":"Vote On Post","description":"Vote on forum post (registered users only)","operationId":"vote_on_post_forum_posts__post_uuid__vote_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"post_uuid","in":"path","required":true,"schema":{"type":"string","title":"Post Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumVoteCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/comments/{comment_uuid}/vote":{"post":{"tags":["forum"],"summary":"Vote On Comment","description":"Vote on forum comment (registered users only)","operationId":"vote_on_comment_forum_comments__comment_uuid__vote_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"comment_uuid","in":"path","required":true,"schema":{"type":"string","title":"Comment Uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumVoteCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/search":{"get":{"tags":["forum"],"summary":"Search Forum","description":"Search forum posts and comments","operationId":"search_forum_forum_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100,"title":"Q"}},{"name":"category_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Category Id"}},{"name":"post_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(all|posts|comments)$","default":"all","title":"Post Type"}},{"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":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/stats":{"get":{"tags":["forum"],"summary":"Get Forum Statistics","description":"Get forum statistics","operationId":"get_forum_statistics_forum_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/forum/profile/{username}":{"get":{"tags":["forum"],"summary":"Get Forum User Profile","description":"Get forum user profile (registered users only)","operationId":"get_forum_user_profile_forum_profile__username__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forum/profile":{"get":{"tags":["forum"],"summary":"Get My Forum Profile","description":"Get current user's forum profile","operationId":"get_my_forum_profile_forum_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]},"put":{"tags":["forum"],"summary":"Update Forum Profile","description":"Update current user's forum profile","operationId":"update_forum_profile_forum_profile_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForumProfileUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/forum/admin/categories":{"post":{"tags":["forum"],"summary":"Create Forum Category","description":"Create new forum category (admin only)","operationId":"create_forum_category_forum_admin_categories_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Category Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/forum/admin/statistics":{"get":{"tags":["forum"],"summary":"Get Admin Forum Statistics","description":"Get detailed forum statistics (admin only)","operationId":"get_admin_forum_statistics_forum_admin_statistics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/upload":{"post":{"tags":["marketplace"],"summary":"Upload Dataset","description":"Upload dataset to marketplace with pricing options","operationId":"upload_dataset_marketplace_upload_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"metadata","in":"query","required":true,"schema":{"type":"string","title":"Metadata"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_dataset_marketplace_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets":{"get":{"tags":["marketplace"],"summary":"Browse Datasets","description":"Browse marketplace datasets (registered users only)","operationId":"browse_datasets_marketplace_datasets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"price_tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Tier"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","default":"uploaded_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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/my-purchases":{"get":{"tags":["marketplace"],"summary":"Get User Purchases","description":"Get user's dataset purchases","operationId":"get_user_purchases_marketplace_my_purchases_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/pricing":{"get":{"tags":["marketplace"],"summary":"Get Pricing Tiers","description":"Get available pricing tiers for dataset uploads","operationId":"get_pricing_tiers_marketplace_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/my-datasets":{"get":{"tags":["marketplace"],"summary":"Get My Datasets","description":"Get user's uploaded datasets with status filtering","operationId":"get_my_datasets_marketplace_my_datasets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets/{dataset_id}":{"patch":{"tags":["marketplace"],"summary":"Update Dataset","description":"Update dataset metadata (only owner can update, only if pending/rejected)","operationId":"update_dataset_marketplace_datasets__dataset_id__patch","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Update Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["marketplace"],"summary":"Delete Dataset","description":"Delete dataset (only owner can delete, only if not purchased by others)","operationId":"delete_dataset_marketplace_datasets__dataset_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["marketplace"],"summary":"Get Dataset Details","description":"Get detailed dataset information","operationId":"get_dataset_details_marketplace_datasets__dataset_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets/{dataset_id}/purchase":{"post":{"tags":["marketplace"],"summary":"Purchase Dataset","description":"Get free access to dataset (no payment required)","operationId":"purchase_dataset_marketplace_datasets__dataset_id__purchase_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetPurchaseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/datasets/{dataset_id}/download":{"post":{"tags":["marketplace"],"summary":"Download Dataset","description":"Download dataset file (free for all registered users)","operationId":"download_dataset_marketplace_datasets__dataset_id__download_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/my-datasets/analytics":{"get":{"tags":["marketplace"],"summary":"Get Dataset Analytics","description":"Get analytics for user's uploaded datasets","operationId":"get_dataset_analytics_marketplace_my_datasets_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/revenue-analytics":{"get":{"tags":["marketplace"],"summary":"Get Admin Revenue Analytics","description":"Get marketplace revenue analytics for admin","operationId":"get_admin_revenue_analytics_marketplace_admin_revenue_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/stats":{"get":{"tags":["marketplace"],"summary":"Get Marketplace Stats","description":"Get comprehensive marketplace statistics","operationId":"get_marketplace_stats_marketplace_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/pending-datasets":{"get":{"tags":["marketplace"],"summary":"Get Pending Datasets","description":"Get all pending datasets for approval","operationId":"get_pending_datasets_marketplace_admin_pending_datasets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/marketplace/admin/datasets/{dataset_id}/approve":{"post":{"tags":["marketplace"],"summary":"Approve Dataset","description":"Approve a pending dataset","operationId":"approve_dataset_marketplace_admin_datasets__dataset_id__approve_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/admin/datasets/{dataset_id}/reject":{"post":{"tags":["marketplace"],"summary":"Reject Dataset","description":"Reject a pending dataset","operationId":"reject_dataset_marketplace_admin_datasets__dataset_id__reject_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"integer","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Rejection Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research/papers/search":{"get":{"tags":["research","research"],"summary":"Search Papers","description":"Search academic papers from arXiv with pagination\nCost: 1 credit per 10 papers (per page)\nRate limit: 1 request per second\n\nReturns 10 papers per page. Each page costs 1 credit.\nExample: page=1 returns papers 1-10, page=2 returns papers 11-20","operationId":"search_papers_research_papers_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","description":"Search query (keywords separated by space)","title":"Query"},"description":"Search query (keywords separated by space)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research/papers/trending":{"get":{"tags":["research","research"],"summary":"Get Trending Papers","description":"Get trending recent papers by topic with pagination\nCost: 1 credit per 10 papers (per page)\nRate limit: 1 request per second","operationId":"get_trending_papers_research_papers_trending_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"topic","in":"query","required":true,"schema":{"type":"string","description":"Research topic","title":"Topic"},"description":"Research topic"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":7,"description":"Days to look back","default":30,"title":"Days"},"description":"Days to look back"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/research/content-reader":{"post":{"tags":["research","research"],"summary":"Content Reader","description":"Extract and read content from web documents\nCost: 0.25 credits per request\nRate limit: 1 request per second","operationId":"content_reader_research_content_reader_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentReaderRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/web-search":{"post":{"tags":["research","research"],"summary":"Web Search","description":"Search the web for financial and market intelligence","operationId":"web_search_research_web_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/chat":{"post":{"tags":["research","research"],"summary":"Fincept Chat","description":"Official Fincept AI Chat","operationId":"fincept_chat_research_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/grokipedia":{"post":{"tags":["research","research"],"summary":"Grokipedia Fetch","description":"Fetch knowledge articles from Grokipedia (xAI's knowledge base)\n\nThis endpoint retrieves comprehensive articles from Grokipedia, covering various topics\nwith detailed content, references, and citations.\n\nCost: 0.25 credits per request\nRate limit: 1 request per second\n\nParameters:\n- slug: Article slug/identifier (e.g., \"artificial-intelligence\", \"climate-change\")\n- extract_refs: Extract and include references (default: true)\n- truncate: Limit content to N characters (optional)\n- citations: Include citation formatting (default: false)\n\nExample slugs:\n- \"bitcoin\"\n- \"machine-learning\"\n- \"quantum-computing\"\n- \"financial-markets\"","operationId":"grokipedia_fetch_research_grokipedia_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrokipediaRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/pdf/extract":{"post":{"tags":["research","research"],"summary":"Extract Pdf Text","description":"Extract text from uploaded PDF file\nDynamic Pricing:\n- 1-10 pages: 1 credit\n- 11-50 pages: 2 credits\n- 51-100 pages: 3 credits\n- 101-200 pages: 5 credits\n- 201+ pages: 10 credits\nRate limit: 1 request per second\nMax file size: 10MB","operationId":"extract_pdf_text_research_pdf_extract_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_extract_pdf_text_research_pdf_extract_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/health":{"get":{"tags":["research","research"],"summary":"Research Health","description":"Health check for Fincept research module","operationId":"research_health_research_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/research/llm":{"post":{"tags":["research","research"],"summary":"General Llm Inference","description":"General-purpose LLM endpoint for running agents, processing data, and AI tasks.\n\nThis endpoint allows you to use Fincept API as your LLM provider for:\n- Running AI agents\n- Data processing and analysis\n- Code generation\n- Text summarization\n- Question answering\n- Any other LLM-based tasks\n\nCost: 5 credits per successful response\nNote: Credits are ONLY deducted on successful LLM response. If the LLM fails, no credits are charged.\n\nRate limit: 1 request per second","operationId":"general_llm_inference_research_llm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LLMRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/research/visual-analysis":{"post":{"tags":["research","research"],"summary":"Satellite Visual Analysis","description":"Multimodal Visual Analysis using GLM-4.6V for satellite imagery and visual understanding.\n\nThis endpoint enables advanced visual analysis capabilities including:\n- Satellite image analysis and interpretation\n- Geographic feature detection and classification\n- Land use and land cover analysis\n- Urban planning and infrastructure mapping\n- Environmental monitoring\n- Agricultural assessment\n- Disaster response and damage assessment\n- Object detection and counting in images\n- Visual question answering\n- Image description and captioning\n\nModel: GLM-4.6V (Multimodal Vision-Language Model)\n- Native multimodal understanding\n- 128K context window\n- Advanced visual reasoning\n- Function calling capabilities\n- High-resolution image processing\n\nCost: 10 credits per successful response\nNote: Credits are ONLY deducted on successful analysis. If the model fails, no credits are charged.\n\nRate limit: 1 request per second\n\nExample Use Cases:\n- \"Identify all buildings in this satellite image\"\n- \"What type of land use is shown in this area?\"\n- \"Detect any changes or anomalies in this image\"\n- \"Count the number of vehicles in this parking lot\"\n- \"Analyze the vegetation health in this agricultural field\"","operationId":"satellite_visual_analysis_research_visual_analysis_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisualAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/position":{"post":{"tags":["marine","marine"],"summary":"Get Vessel Position","description":"Get last known position of a vessel by IMO\nCost: 1 credit per request","operationId":"get_vessel_position_marine_vessel_position_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VesselPositionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/history":{"post":{"tags":["marine","marine"],"summary":"Get Vessel History","description":"Get complete historical location data for a vessel\nCost: 5 credits per request","operationId":"get_vessel_history_marine_vessel_history_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VesselPositionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/multi":{"post":{"tags":["marine","marine"],"summary":"Get Multi Vessel Positions","description":"Get last known positions for multiple vessels (max 50)\nCost: 3 credits per request","operationId":"get_multi_vessel_positions_marine_vessel_multi_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiVesselRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/vessel/area-search":{"post":{"tags":["marine","marine"],"summary":"Search Vessels In Area","description":"Search for all vessels in a defined geographic area\nCost: 2 credits per request","operationId":"search_vessels_in_area_marine_vessel_area_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AreaSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/marine/health":{"get":{"tags":["marine","marine"],"summary":"Marine Health","description":"Health check for marine module","operationId":"marine_health_marine_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/aircraft/health":{"get":{"tags":["aircraft","aircraft"],"summary":"Aircraft Health","description":"Health check for aircraft tracking module","operationId":"aircraft_health_aircraft_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/aircraft/track":{"post":{"tags":["aircraft","aircraft"],"summary":"Track Aircraft","description":"Track aircraft by ID using PlaneFinder API with Selenium\nCost: 0.25 credits per successful request\nRate limit: 1 request per second","operationId":"track_aircraft_aircraft_track_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AircraftRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/aircraft/{aircraft_id}":{"get":{"tags":["aircraft","aircraft"],"summary":"Get Aircraft Endpoint","description":"Get aircraft data by ID (raw format)\nSimple endpoint without authentication for testing","operationId":"get_aircraft_endpoint_aircraft__aircraft_id__get","parameters":[{"name":"aircraft_id","in":"path","required":true,"schema":{"type":"string","title":"Aircraft Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/aircraft/{aircraft_id}/raw":{"get":{"tags":["aircraft","aircraft"],"summary":"Get Aircraft Raw","description":"Get raw aircraft data by ID\nSimple endpoint without authentication for testing","operationId":"get_aircraft_raw_aircraft__aircraft_id__raw_get","parameters":[{"name":"aircraft_id","in":"path","required":true,"schema":{"type":"string","title":"Aircraft Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/health":{"get":{"tags":["twitter","twitter"],"summary":"Twitter Health","description":"Health check for Twitter integration module","operationId":"twitter_health_twitter_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/twitter/countries":{"get":{"tags":["twitter","twitter"],"summary":"Get Available Countries","description":"Get list of all available countries for Twitter trends\nNo authentication required","operationId":"get_available_countries_twitter_countries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/twitter/trends":{"get":{"tags":["twitter","twitter"],"summary":"Get Twitter Trends","description":"Get current Twitter trending topics for a country\n\nParameters:\n- country: Country name (optional, default: \"worldwide\")\n Examples: \"india\", \"usa\", \"uk\", \"japan\", \"brazil\", \"france\", etc.\n Use /twitter/countries to see all available countries\n\nCost: 0.5 credits per request\nRate limit: 1 request per 2 seconds","operationId":"get_twitter_trends_twitter_trends_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/user/tweets":{"get":{"tags":["twitter","twitter"],"summary":"Get User Tweets","description":"Get user's latest tweets (up to 20 per request)\n\nParameters:\n- username: Twitter screen name (e.g., \"elonmusk\")\n- user_id: Twitter user ID (recommended, more stable than username)\n- cursor: Pagination cursor for next page\n\nNote: Either username OR user_id is required. If both provided, user_id takes priority.\n\nCost: 1.0 credit per request (returns up to 20 tweets)\nRate limit: 1 request per 2 seconds\n\nReturns tweets sorted by created_at with pagination support.","operationId":"get_user_tweets_twitter_user_tweets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"username","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"}},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweets":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweets By Ids","description":"Get tweets by their IDs\n\nParameters:\n- tweet_ids: Comma-separated tweet IDs (e.g., \"1846987139428634858,1866332309399781537\")\n\nCost: 0.5 credits per request\nRate limit: 1 request per 2 seconds\n\nReturns tweet data for the specified IDs.","operationId":"get_tweets_by_ids_twitter_tweets_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_ids","in":"query","required":true,"schema":{"type":"string","title":"Tweet Ids"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/replies":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Replies","description":"Get replies to a tweet (up to 20 per request)\n\nParameters:\n- tweet_id: The tweet ID to get replies for (required)\n- since_time: On or after specified unix timestamp in seconds (optional)\n- until_time: Before specified unix timestamp in seconds (optional)\n- cursor: Pagination cursor for next page (optional)\n\nNote: tweet_id must be an original tweet (not a reply to another tweet)\n and should be the first tweet in a thread.\n\nCost: 1.0 credit per request (returns up to 20 replies)\nRate limit: 1 request per 2 seconds\n\nReturns replies sorted by reply time (descending) with pagination support.","operationId":"get_tweet_replies_twitter_tweet_replies_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"since_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Since Time"}},{"name":"until_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Until Time"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/quotes":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Quotes","description":"Get quote tweets of a tweet (20 quotes per request)\n\nParameters:\n- tweet_id: The tweet ID to get quotes for (required)\n- since_time: On or after specified unix timestamp in seconds (optional)\n- until_time: Before specified unix timestamp in seconds (optional)\n- include_replies: Include replies in results (default: true)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 1.0 credit per request (returns 20 quotes)\nRate limit: 1 request per 2 seconds\n\nReturns quote tweets sorted by quote time (descending) with pagination support.","operationId":"get_tweet_quotes_twitter_tweet_quotes_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"since_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Since Time"}},{"name":"until_time","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Until Time"}},{"name":"include_replies","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Replies"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/retweeters":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Retweeters","description":"Get users who retweeted a tweet (~100 users per request)\n\nParameters:\n- tweet_id: The tweet ID to get retweeters for (required)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 1.5 credits per request (returns ~100 users)\nRate limit: 1 request per 2 seconds\n\nReturns users who retweeted the tweet, sorted by retweet time (descending) with pagination support.","operationId":"get_tweet_retweeters_twitter_tweet_retweeters_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/article":{"get":{"tags":["twitter","twitter"],"summary":"Get Twitter Article","description":"Get full article content from a Twitter article tweet\n\n⚠️ PREMIUM ENDPOINT - Costs 100 credits per article!\n\nParameters:\n- tweet_id: The tweet ID of the article (required)\n\nCost: 100 credits per article (PREMIUM)\nRate limit: 1 request per 2 seconds\n\nReturns full article content including title, preview, cover image, and full text.\nThis is a premium endpoint due to the comprehensive article data provided.","operationId":"get_twitter_article_twitter_article_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/thread_context":{"get":{"tags":["twitter","twitter"],"summary":"Get Tweet Thread Context","description":"Get the full thread context of a tweet\n\nThis endpoint retrieves the entire conversation thread containing the specified tweet.\nFor example, if a thread has tweets t1 -> t2 -> t3 -> t4, t5, t6 (all replying to t3),\nproviding t3 will return the entire thread: t1, t2, t3, t4, t5, t6.\n\nParameters:\n- tweet_id: The tweet ID (can be a reply or original tweet)\n- cursor: Pagination cursor for next page (optional)\n\nNote: Pagination size varies due to Twitter API limitations.\nThe number of tweets per page is not fixed.\n\nCost: 2.0 credits per request (variable tweets per page)\nRate limit: 1 request per 2 seconds\n\nReturns the full thread context with pagination support.","operationId":"get_tweet_thread_context_twitter_tweet_thread_context_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"tweet_id","in":"query","required":true,"schema":{"type":"string","title":"Tweet Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/tweet/advanced_search":{"get":{"tags":["twitter","twitter"],"summary":"Advanced Tweet Search","description":"Advanced search for tweets with powerful query syntax\n\nSupports advanced Twitter search operators for precise tweet discovery.\n\nParameters:\n- query: Search query with advanced operators (required)\n Examples:\n - \"AI\" OR \"Twitter\" from:elonmusk since:2021-12-31_23:59:59_UTC\n - \"#bitcoin\" min_faves:100\n - \"python\" filter:verified\n See: https://github.com/igorbrigadir/twitter-advanced-search\n\n- query_type: \"Latest\" (chronological) or \"Top\" (most relevant)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 2.5 credits per request (up to 20 tweets)\nRate limit: 1 request per 2 seconds\n\nReturns search results with pagination support.","operationId":"advanced_tweet_search_twitter_tweet_advanced_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"query_type","in":"query","required":false,"schema":{"type":"string","default":"Latest","title":"Query Type"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/user/search":{"get":{"tags":["twitter","twitter"],"summary":"Search Users","description":"Search for Twitter users by keyword\n\nParameters:\n- query: Search keyword (required)\n- cursor: Pagination cursor for next page (optional)\n\nCost: 1.5 credits per request\nRate limit: 1 request per 2 seconds\n\nReturns matching users with pagination support.","operationId":"search_users_twitter_user_search_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","title":"Query"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/twitter/user/mentions":{"get":{"tags":["twitter","twitter"],"summary":"Get User Mentions","description":"Get tweet mentions by user screen name\nEach page returns exactly 20 mentions\nOrder by mention time descending\nCost: 1.0 credit per request\nRate limit: 1 request per 2 seconds","operationId":"get_user_mentions_twitter_user_mentions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"userName","in":"query","required":true,"schema":{"type":"string","title":"Username"}},{"name":"sinceTime","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sincetime"}},{"name":"untilTime","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Untiltime"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/my-login-history":{"get":{"tags":["analytics"],"summary":"Get My Login History","description":"Get current user's login history (User only sees their own)","operationId":"get_my_login_history_analytics_my_login_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/admin/dashboard":{"get":{"tags":["analytics"],"summary":"Get Admin Dashboard","description":"Get comprehensive dashboard statistics (Admin only)","operationId":"get_admin_dashboard_analytics_admin_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/users/growth":{"get":{"tags":["analytics"],"summary":"Get User Growth","description":"Get user growth analytics (Admin only)","operationId":"get_user_growth_analytics_admin_users_growth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/engagement":{"get":{"tags":["analytics"],"summary":"Get Engagement Metrics","description":"Get user engagement metrics (Admin only)","operationId":"get_engagement_metrics_analytics_admin_engagement_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/api-stats":{"get":{"tags":["analytics"],"summary":"Get Api Statistics","description":"Get API usage statistics (Admin only)","operationId":"get_api_statistics_analytics_admin_api_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/usage":{"get":{"tags":["analytics"],"summary":"Get Usage Analytics","description":"Get detailed API usage analytics (Admin only)","operationId":"get_usage_analytics_analytics_admin_usage_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/admin/performance":{"get":{"tags":["analytics"],"summary":"Get Performance Analytics","description":"Get performance analytics (Admin only)","operationId":"get_performance_analytics_analytics_admin_performance_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Hours"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/admin/login-audit":{"get":{"tags":["analytics"],"summary":"Get Login Audit","description":"Get login audit log for all users (Admin only)","operationId":"get_login_audit_analytics_admin_login_audit_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"User Id"}},{"name":"ip_address","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"}},{"name":"success_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success Only"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/admin/revenue-analytics":{"get":{"tags":["analytics"],"summary":"Get Admin Revenue Analytics","description":"Get marketplace revenue analytics (Admin only)","operationId":"get_admin_revenue_analytics_analytics_admin_revenue_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/analytics/admin/subscription-analytics":{"get":{"tags":["analytics"],"summary":"Get Subscription Analytics","description":"Get subscription analytics (Admin only) - DISABLED - Payment system to be reimplemented","operationId":"get_subscription_analytics_analytics_admin_subscription_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/speech/decompose":{"post":{"tags":["speech"],"summary":"Decompose Speech","description":"Decompose financial/political speech into structured components.\n\n- Requires API key authentication\n- Costs 2-10 credits based on text size\n- Maximum text length: 500,000 characters\n- Processing is done asynchronously for long texts (>10K chars)\n\nCredit tiers:\n- <5K chars: 2 credits\n- <15K chars: 3 credits\n- <30K chars: 4 credits\n- <50K chars: 5 credits\n- <100K chars: 6 credits\n- <200K chars: 8 credits\n- 200K+ chars: 10 credits","operationId":"decompose_speech_speech_decompose_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpeechInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/speech/status/{analysis_id}":{"get":{"tags":["speech"],"summary":"Get Analysis Status","description":"Get status of a speech analysis (user can only access their own)","operationId":"get_analysis_status_speech_status__analysis_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"analysis_id","in":"path","required":true,"schema":{"type":"string","title":"Analysis Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/speech/history":{"get":{"tags":["speech"],"summary":"Get Analysis History","description":"Get user's speech analysis history","operationId":"get_analysis_history_speech_history_get","security":[{"APIKeyHeader":[]}],"parameters":[{"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":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/speech/result/{analysis_id}":{"get":{"tags":["speech"],"summary":"Get Full Result","description":"Get full decomposition result including raw passes (user's own only)","operationId":"get_full_result_speech_result__analysis_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"analysis_id","in":"path","required":true,"schema":{"type":"string","title":"Analysis Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/countries":{"get":{"tags":["trade"],"summary":"Get Countries","description":"Get list of countries with optional filtering\n\n- continent: Filter by continent ID (af, as, eu, na, sa, oc)\n- search: Search country name","operationId":"get_countries_trade_countries_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"continent","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Continent"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/continents":{"get":{"tags":["trade"],"summary":"Get Continents","description":"Get list of all continents","operationId":"get_continents_trade_continents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/trade/products":{"get":{"tags":["trade"],"summary":"Get Products","description":"Get product hierarchy\n\n- level: Filter by level (Section, HS2, HS4, HS6)\n- parent: Get children of parent HS code","operationId":"get_products_trade_products_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Level"}},{"name":"parent","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/bilateral":{"get":{"tags":["trade"],"summary":"Get Bilateral Trade","description":"Get bilateral trade data between countries\n\nReturns trade flows between exporters and importers for a specific product and year","operationId":"get_bilateral_trade_trade_bilateral_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":true,"schema":{"type":"string","description":"HS product code","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":true,"schema":{"type":"integer","description":"Year (1995-2023)","title":"Year"},"description":"Year (1995-2023)"},{"name":"exporter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Exporter country ID","title":"Exporter"},"description":"Exporter country ID"},{"name":"importer","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Importer country ID","title":"Importer"},"description":"Importer country ID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/country-partners/{country_id}":{"get":{"tags":["trade"],"summary":"Get Country Trade Partners","description":"Get top trading partners for a country (for Chord Diagram)\n\nReturns ranked list of trading partners with trade values","operationId":"get_country_trade_partners_trade_country_partners__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"year","in":"query","required":true,"schema":{"type":"integer","description":"Year (1995-2023)","title":"Year"},"description":"Year (1995-2023)"},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"flow_type","in":"query","required":false,"schema":{"type":"string","description":"export, import, or total","default":"total","title":"Flow Type"},"description":"export, import, or total"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/chord-data/{country_id}":{"get":{"tags":["trade"],"summary":"Get Chord Diagram Data","description":"Get data formatted for Chord Diagram visualization (like Bloomberg Terminal)\n\nReturns:\n- nodes: List of countries (source + top partners)\n- flows: Trade flows between countries\n- rankings: Ranked list of partners with total trade","operationId":"get_chord_diagram_data_trade_chord_data__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"year","in":"query","required":false,"schema":{"type":"integer","description":"Year (1995-2023)","default":2017,"title":"Year"},"description":"Year (1995-2023)"},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":50,"description":"Number of top partners","default":15,"title":"Top N"},"description":"Number of top partners"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/time-series/{country_id}":{"get":{"tags":["trade"],"summary":"Get Trade Time Series","description":"Get time series trade data for a country\n\nReturns trade values over time for trend analysis","operationId":"get_trade_time_series_trade_time_series__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"start_year","in":"query","required":false,"schema":{"type":"integer","default":1995,"title":"Start Year"}},{"name":"end_year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"End Year"}},{"name":"flow","in":"query","required":false,"schema":{"type":"string","description":"export, import, or both","default":"both","title":"Flow"},"description":"export, import, or both"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/growth/{country_id}":{"get":{"tags":["trade"],"summary":"Get Trade Growth","description":"Get trade growth rates for a country","operationId":"get_trade_growth_trade_growth__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}},{"name":"flow","in":"query","required":false,"schema":{"type":"string","description":"export or import","default":"export","title":"Flow"},"description":"export or import"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/balance/{country_id}":{"get":{"tags":["trade"],"summary":"Get Trade Balance","description":"Get trade balance (surplus/deficit) for a country","operationId":"get_trade_balance_trade_balance__country_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"country_id","in":"path","required":true,"schema":{"type":"string","title":"Country Id"}},{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/top-exporters":{"get":{"tags":["trade"],"summary":"Get Top Exporters","description":"Get top exporting countries for a product","operationId":"get_top_exporters_trade_top_exporters_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/top-importers":{"get":{"tags":["trade"],"summary":"Get Top Importers","description":"Get top importing countries for a product","operationId":"get_top_importers_trade_top_importers_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/continent-trade":{"get":{"tags":["trade"],"summary":"Get Continent Trade","description":"Get trade by continent","operationId":"get_continent_trade_trade_continent_trade_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"hs_code","in":"query","required":false,"schema":{"type":"string","description":"HS product code","default":"1","title":"Hs Code"},"description":"HS product code"},{"name":"year","in":"query","required":false,"schema":{"type":"integer","default":2023,"title":"Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trade/health":{"get":{"tags":["trade"],"summary":"Health Check","description":"Health check for trade analytics API","operationId":"health_check_trade_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Root","description":"API status endpoint","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/cashfree-test":{"get":{"summary":"Cashfree Test Page","description":"Serve Cashfree payment test page","operationId":"cashfree_test_page_cashfree_test_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health Check","description":"System health check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/auth/status":{"get":{"summary":"Auth Status","description":"Check authentication status","operationId":"auth_status_auth_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/test":{"get":{"summary":"Test Endpoint","description":"Test endpoint","operationId":"test_endpoint_test_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/sync":{"post":{"summary":"Manual Mcp Sync","description":"Manually trigger MCP scripts sync from GitHub (Admin only)\n\nArgs:\n force: Force sync even if not time yet (default False)","operationId":"manual_mcp_sync_mcp_sync_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"force","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp/status":{"get":{"summary":"Mcp Status","description":"Get MCP system status (tools available, last sync, etc.)","operationId":"mcp_status_mcp_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AircraftRequest":{"properties":{"aircraft_id":{"type":"string","title":"Aircraft Id"}},"type":"object","required":["aircraft_id"],"title":"AircraftRequest"},"AreaSearchRequest":{"properties":{"min_lat":{"type":"number","title":"Min Lat"},"max_lat":{"type":"number","title":"Max Lat"},"min_lng":{"type":"number","title":"Min Lng"},"max_lng":{"type":"number","title":"Max Lng"}},"type":"object","required":["min_lat","max_lat","min_lng","max_lng"],"title":"AreaSearchRequest"},"Body_extract_pdf_text_research_pdf_extract_post":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"PDF file to process"}},"type":"object","required":["file"],"title":"Body_extract_pdf_text_research_pdf_extract_post"},"Body_upload_dataset_marketplace_upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_dataset_marketplace_upload_post"},"BroadcastMessageRequest":{"properties":{"subject":{"type":"string","title":"Subject"},"message":{"type":"string","title":"Message"},"target_users":{"type":"string","title":"Target Users","default":"all"}},"type":"object","required":["subject","message"],"title":"BroadcastMessageRequest"},"ChatMessageCreate":{"properties":{"content":{"type":"string","title":"Content"}},"type":"object","required":["content"],"title":"ChatMessageCreate"},"ChatRequest":{"properties":{"messages":{"items":{},"type":"array","title":"Messages"},"model":{"type":"string","title":"Model","default":"meituan/longcat-flash-chat:free"}},"type":"object","required":["messages"],"title":"ChatRequest"},"ChatSessionCreate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":"New Conversation"}},"type":"object","title":"ChatSessionCreate"},"ContactFormCreate":{"properties":{"name":{"type":"string","title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"subject":{"type":"string","title":"Subject"},"message":{"type":"string","title":"Message"}},"type":"object","required":["name","email","subject","message"],"title":"ContactFormCreate"},"ContentReaderRequest":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"format":{"type":"string","title":"Format","default":"markdown"}},"type":"object","required":["url"],"title":"ContentReaderRequest"},"CreateOrderRequest":{"properties":{"plan_id":{"type":"string","title":"Plan Id"},"currency":{"type":"string","title":"Currency","default":"USD"}},"type":"object","required":["plan_id"],"title":"CreateOrderRequest"},"CreditAdjustmentRequest":{"properties":{"action":{"type":"string","title":"Action"},"amount":{"type":"integer","title":"Amount"},"reason":{"type":"string","title":"Reason","default":"Admin adjustment"}},"type":"object","required":["action","amount"],"title":"CreditAdjustmentRequest"},"DatabaseCreateRequest":{"properties":{"database_name":{"type":"string","title":"Database Name"},"display_name":{"type":"string","title":"Display Name"},"description":{"type":"string","title":"Description","default":""},"category":{"type":"string","title":"Category","default":"general"},"is_public":{"type":"boolean","title":"Is Public","default":false},"requires_subscription":{"type":"boolean","title":"Requires Subscription","default":true},"cost_per_request":{"type":"integer","title":"Cost Per Request","default":20},"free_tier_limit":{"type":"integer","title":"Free Tier Limit","default":10},"total_tables":{"type":"integer","title":"Total Tables","default":0}},"type":"object","required":["database_name","display_name"],"title":"DatabaseCreateRequest"},"DatabaseSubscriptionRequest":{"properties":{"database_name":{"type":"string","title":"Database Name"}},"type":"object","required":["database_name"],"title":"DatabaseSubscriptionRequest"},"DatasetPurchaseRequest":{"properties":{"payment_method":{"type":"string","title":"Payment Method","default":"subscription_credit"}},"type":"object","title":"DatasetPurchaseRequest"},"DateRangeRequest":{"properties":{"start_date":{"type":"string","format":"date-time","title":"Start Date"},"end_date":{"type":"string","format":"date-time","title":"End Date"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"category":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}]},"limit":{"type":"integer","title":"Limit","default":10}},"type":"object","required":["start_date","end_date"],"title":"DateRangeRequest"},"DeviceRegistration":{"properties":{"device_id":{"type":"string","title":"Device Id"},"device_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device Name"},"platform":{"type":"string","title":"Platform"},"hardware_info":{"additionalProperties":true,"type":"object","title":"Hardware Info"}},"type":"object","required":["device_id","platform","hardware_info"],"title":"DeviceRegistration"},"FeedbackCreate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"rating":{"type":"integer","title":"Rating"},"feedback_text":{"type":"string","title":"Feedback Text"},"category":{"type":"string","title":"Category","default":"general"}},"type":"object","required":["rating","feedback_text"],"title":"FeedbackCreate"},"ForumCommentCreate":{"properties":{"content":{"type":"string","title":"Content"},"parent_comment_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Comment Id"}},"type":"object","required":["content"],"title":"ForumCommentCreate"},"ForumPostCreate":{"properties":{"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"category_id":{"type":"integer","title":"Category Id"}},"type":"object","required":["title","content","category_id"],"title":"ForumPostCreate"},"ForumProfileUpdate":{"properties":{"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"avatar_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Color"},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature"},"show_email":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Show Email"},"email_notifications":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Email Notifications"}},"type":"object","title":"ForumProfileUpdate"},"ForumVoteCreate":{"properties":{"vote_type":{"type":"string","title":"Vote Type"}},"type":"object","required":["vote_type"],"title":"ForumVoteCreate"},"GrokipediaRequest":{"properties":{"slug":{"type":"string","title":"Slug"},"extract_refs":{"type":"boolean","title":"Extract Refs","default":true},"truncate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Truncate"},"citations":{"type":"boolean","title":"Citations","default":false}},"type":"object","required":["slug"],"title":"GrokipediaRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LLMRequest":{"properties":{"prompt":{"type":"string","title":"Prompt"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","default":4096},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","default":0.7}},"type":"object","required":["prompt"],"title":"LLMRequest"},"MessageCreate":{"properties":{"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"MessageCreate"},"MultiVesselRequest":{"properties":{"imos":{"items":{"type":"string"},"type":"array","title":"Imos"}},"type":"object","required":["imos"],"title":"MultiVesselRequest"},"NewsAnalysisRequest":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"NewsAnalysisRequest"},"NewsCategory":{"type":"string","enum":["business","technology","sports","entertainment","health","science","politics","world","local"],"title":"NewsCategory"},"NewsRequest":{"properties":{"domains":{"items":{"type":"string"},"type":"array","title":"Domains"},"category":{"anyOf":[{"$ref":"#/components/schemas/NewsCategory"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","default":"en"},"limit":{"type":"integer","title":"Limit","default":10}},"type":"object","required":["domains"],"title":"NewsRequest"},"NewsletterSubscribe":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":"website"}},"type":"object","required":["email"],"title":"NewsletterSubscribe"},"OTPVerification":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"otp":{"type":"string","title":"Otp"}},"type":"object","required":["email","otp"],"title":"OTPVerification"},"PasswordReset":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"PasswordReset"},"PasswordResetConfirm":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"otp":{"type":"string","title":"Otp"},"new_password":{"type":"string","title":"New Password"}},"type":"object","required":["email","otp","new_password"],"title":"PasswordResetConfirm"},"SpeechInput":{"properties":{"text":{"type":"string","maxLength":500000,"minLength":50,"title":"Text","description":"Raw speech text (50-500K chars)"}},"type":"object","required":["text"],"title":"SpeechInput"},"SystemConfigRequest":{"properties":{"config_key":{"type":"string","title":"Config Key"},"config_value":{"type":"string","title":"Config Value"},"config_type":{"type":"string","title":"Config Type","default":"string"},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["config_key","config_value"],"title":"SystemConfigRequest"},"TicketCreate":{"properties":{"subject":{"type":"string","title":"Subject"},"description":{"type":"string","title":"Description"},"category":{"type":"string","title":"Category"},"priority":{"type":"string","title":"Priority","default":"medium"}},"type":"object","required":["subject","description","category"],"title":"TicketCreate"},"TicketUpdate":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","title":"TicketUpdate"},"TopicSearchRequest":{"properties":{"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"limit":{"type":"integer","title":"Limit","default":10}},"type":"object","required":["keywords"],"title":"TopicSearchRequest"},"UserCreateRequest":{"properties":{"username":{"type":"string","title":"Username"},"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"account_type":{"type":"string","title":"Account Type","default":"free"},"is_admin":{"type":"boolean","title":"Is Admin","default":false},"is_verified":{"type":"boolean","title":"Is Verified","default":true},"credit_balance":{"type":"integer","title":"Credit Balance","default":0}},"type":"object","required":["username","email","password"],"title":"UserCreateRequest"},"UserLogin":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"UserLogin"},"UserRegistration":{"properties":{"username":{"type":"string","title":"Username"},"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"preferred_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preferred Currency"}},"type":"object","required":["username","email","password"],"title":"UserRegistration"},"UserUpdateRequest":{"properties":{"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"account_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Type"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Verified"},"is_admin":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Admin"},"credit_balance":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credit Balance"}},"type":"object","title":"UserUpdateRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VesselPositionRequest":{"properties":{"imo":{"type":"string","title":"Imo"}},"type":"object","required":["imo"],"title":"VesselPositionRequest"},"VisualAnalysisRequest":{"properties":{"image_url":{"type":"string","title":"Image Url"},"prompt":{"type":"string","title":"Prompt"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","default":4096},"temperature":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Temperature","default":0.7},"enable_thinking":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enable Thinking","default":false}},"type":"object","required":["image_url","prompt"],"title":"VisualAnalysisRequest"},"WebSearchRequest":{"properties":{"query":{"type":"string","title":"Query"},"engine":{"type":"string","title":"Engine","default":"google"}},"type":"object","required":["query"],"title":"WebSearchRequest"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}
\ No newline at end of file
diff --git a/fincept-terminal-desktop/src/components/auth/PricingScreen.tsx b/fincept-terminal-desktop/src/components/auth/PricingScreen.tsx
index 61e1fd9ce..2bcbdece2 100644
--- a/fincept-terminal-desktop/src/components/auth/PricingScreen.tsx
+++ b/fincept-terminal-desktop/src/components/auth/PricingScreen.tsx
@@ -101,14 +101,11 @@ const PricingScreen: React.FC<PricingScreenProps> = ({
// Separate effect to set default selection when plans are loaded
useEffect(() => {
if (availablePlans.length > 0 && !selectedPlan) {
- const currentPlanId = (session?.subscription as any)?.data?.subscription?.plan?.plan_id ||
- session?.subscription?.subscription?.plan?.plan_id;
- // Don't auto-select if user already has current plan, otherwise select basic
- if (!currentPlanId) {
- setSelectedPlan('basic');
- }
+ const currentPlanId = session?.user_info?.account_type || 'free';
+ // Auto-select user's current plan
+ setSelectedPlan(currentPlanId);
}
- }, [availablePlans.length, selectedPlan, session?.subscription]);
+ }, [availablePlans.length, selectedPlan, session?.user_info?.account_type]);
const getAnnualPrice = (monthlyPrice: number) => {
return monthlyPrice * 10; // 2 months free when billed annually
diff --git a/fincept-terminal-desktop/src/components/auth/RegisterScreen.tsx b/fincept-terminal-desktop/src/components/auth/RegisterScreen.tsx
index e42065c7d..fec68c529 100644
--- a/fincept-terminal-desktop/src/components/auth/RegisterScreen.tsx
+++ b/fincept-terminal-desktop/src/components/auth/RegisterScreen.tsx
@@ -111,24 +111,23 @@ const RegisterScreen: React.FC<RegisterScreenProps> = ({ onNavigate }) => {
console.log('Generated username:', username);
// Parse phone number if provided
- let parsedPhone: any = null;
+ let phone = '';
+ let country = '';
+ let countryCode = '';
+
if (phoneNumber) {
try {
const { parsePhoneNumber } = await import('libphonenumber-js');
- parsedPhone = parsePhoneNumber(phoneNumber);
+ const parsed = parsePhoneNumber(phoneNumber);
+ phone = parsed.nationalNumber;
+ country = parsed.country || '';
+ countryCode = `+${parsed.countryCallingCode}`;
} catch (err) {
console.error('Failed to parse phone number:', err);
}
}
- // Prepare additional registration data
- const additionalData = {
- phone: parsedPhone?.nationalNumber || phoneNumber || undefined,
- country_code: parsedPhone ? `+${parsedPhone.countryCallingCode}` : undefined,
- country: parsedPhone?.country || undefined
- };
-
- const result = await signup(username, formData.email, formData.password, additionalData);
+ const result = await signup(username, formData.email, formData.password, phone, country, countryCode);
if (result.success) {
console.log('Registration successful, OTP sent to:', formData.email);
@@ -201,24 +200,23 @@ const RegisterScreen: React.FC<RegisterScreenProps> = ({ onNavigate }) => {
const username = `${formData.firstName.trim()}${formData.lastName.trim()}`.toLowerCase();
// Parse phone number if provided
- let parsedPhone: any = null;
+ let phone = '';
+ let country = '';
+ let countryCode = '';
+
if (phoneNumber) {
try {
const { parsePhoneNumber } = await import('libphonenumber-js');
- parsedPhone = parsePhoneNumber(phoneNumber);
+ const parsed = parsePhoneNumber(phoneNumber);
+ phone = parsed.nationalNumber;
+ country = parsed.country || '';
+ countryCode = `+${parsed.countryCallingCode}`;
} catch (err) {
console.error('Failed to parse phone number:', err);
}
}
- // Prepare additional registration data
- const additionalData = {
- phone: parsedPhone?.nationalNumber || phoneNumber || undefined,
- country_code: parsedPhone ? `+${parsedPhone.countryCallingCode}` : undefined,
- country: parsedPhone?.country || undefined
- };
-
- const result = await signup(username, formData.email, formData.password, additionalData);
+ const result = await signup(username, formData.email, formData.password, phone, country, countryCode);
if (result.success) {
setError(""); // Clear any previous errors
diff --git a/fincept-terminal-desktop/src/components/tabs/ProfileTab.tsx b/fincept-terminal-desktop/src/components/tabs/ProfileTab.tsx
index bfc4dab5b..804bb1b30 100644
--- a/fincept-terminal-desktop/src/components/tabs/ProfileTab.tsx
+++ b/fincept-terminal-desktop/src/components/tabs/ProfileTab.tsx
@@ -1,985 +1,557 @@
+// File: src/components/tabs/ProfileTab.tsx
+// Bloomberg-style Professional Profile & Account Management Interface
+
import React, { useState, useEffect } from 'react';
import { useAuth } from '@/contexts/AuthContext';
-import { useNavigation } from '@/contexts/NavigationContext';
import { UserApiService } from '@/services/userApi';
-import { useTerminalTheme } from '@/contexts/ThemeContext';
-import { useTranslation } from 'react-i18next';
+import { TabHeader } from '@/components/common/TabHeader';
import { TabFooter } from '@/components/common/TabFooter';
+import {
+ User, CreditCard, Activity, Shield, Key, RefreshCw,
+ LogOut, Crown, Zap, FileText, CheckCircle, AlertCircle, Eye, EyeOff, BarChart
+} from 'lucide-react';
+
+// Bloomberg Professional Color Palette
+const COLORS = {
+ ORANGE: '#ea580c',
+ WHITE: '#ffffff',
+ RED: '#ef4444',
+ GREEN: '#10b981',
+ GRAY: '#6b7280',
+ DARK_BG: '#000000',
+ PANEL_BG: '#0a0a0a',
+ HEADER_BG: '#1a1a1a',
+ CYAN: '#06b6d4',
+ YELLOW: '#eab308',
+ BORDER: '#262626',
+ MUTED: '#737373'
+};
-type ProfileScreen = 'overview' | 'usage' | 'payments' | 'subscriptions' | 'support' | 'settings';
+type Section = 'overview' | 'usage' | 'security' | 'billing';
const ProfileTab: React.FC = () => {
- const { colors } = useTerminalTheme();
- const { t } = useTranslation('profile');
- const { session, logout } = useAuth();
- const navigation = useNavigation();
- const [currentTime, setCurrentTime] = useState(new Date());
- const [currentScreen, setCurrentScreen] = useState<ProfileScreen>('overview');
+ const { session, logout, refreshUserData } = useAuth();
+ const [activeSection, setActiveSection] = useState<Section>('overview');
const [loading, setLoading] = useState(false);
-
- // Data states
const [usageData, setUsageData] = useState<any>(null);
const [paymentHistory, setPaymentHistory] = useState<any[]>([]);
- const [subscriptions, setSubscriptions] = useState<any[]>([]);
- const [supportTickets, setSupportTickets] = useState<any[]>([]);
- const [detailedUsage, setDetailedUsage] = useState<any>(null);
+ const [showApiKey, setShowApiKey] = useState(false);
useEffect(() => {
- const timer = setInterval(() => setCurrentTime(new Date()), 1000);
- return () => clearInterval(timer);
- }, []);
-
- // F11 fullscreen toggle
- const toggleFullscreen = () => {
- if (!document.fullscreenElement) {
- document.documentElement.requestFullscreen();
- } else {
- if (document.exitFullscreen) {
- document.exitFullscreen();
- }
- }
- };
+ fetchSectionData();
+ }, [activeSection, session]);
- const fetchData = async (showNotification = false) => {
+ const fetchSectionData = async () => {
if (!session?.api_key) return;
-
setLoading(true);
try {
- if (currentScreen === 'usage') {
- if (session.user_type === 'guest') {
- const result = await UserApiService.getGuestUsage(session.api_key || '');
- if (result.success) setUsageData(result.data);
- } else {
- const result = await UserApiService.getUserUsage(session.api_key || '');
- if (result.success) setUsageData(result.data);
-
- const detailedResult = await UserApiService.getUsageDetails(session.api_key || '');
- if (detailedResult.success) setDetailedUsage(detailedResult.data);
- }
- } else if (currentScreen === 'payments') {
- const result = await UserApiService.getPaymentHistory(session.api_key || '', 1, 20);
- if (result.success) setPaymentHistory(result.data?.payments || result.data || []);
- } else if (currentScreen === 'subscriptions') {
- const result = await UserApiService.getUserSubscriptions(session.api_key || '');
- if (result.success) setSubscriptions(result.data?.subscriptions || result.data || []);
- } else if (currentScreen === 'support') {
- const result = await UserApiService.getUserTickets(session.api_key || '');
- if (result.success) setSupportTickets(result.data?.tickets || result.data || []);
- }
-
- if (showNotification) {
- alert('[OK] Profile data refreshed successfully!');
+ if (activeSection === 'usage') {
+ const result = session.user_type === 'guest'
+ ? await UserApiService.getGuestUsage(session.api_key)
+ : await UserApiService.getUserUsage(session.api_key);
+ if (result.success) setUsageData(result.data);
+ } else if (activeSection === 'billing') {
+ const result = await UserApiService.getPaymentHistory(session.api_key, 1, 10);
+ if (result.success) setPaymentHistory(result.data?.payments || []);
}
} catch (error) {
console.error('Error fetching data:', error);
- if (showNotification) {
- alert('[FAIL] Failed to refresh data. Please try again.');
- }
} finally {
setLoading(false);
}
};
- // Fetch data based on current screen
- useEffect(() => {
- fetchData();
- }, [currentScreen, session]);
-
- const logoutUser = async () => {
- if (confirm('Are you sure you want to logout?')) {
+ const handleLogout = async () => {
+ if (confirm('Logout from Fincept Terminal?')) {
await logout();
}
};
- const regenerateApiKey = async () => {
+ const handleRegenerateKey = async () => {
if (!session?.api_key) return;
- if (confirm('Are you sure you want to regenerate your API key? Your old key will be invalidated.')) {
+ if (confirm('Regenerate API Key? Your old key will be invalidated.')) {
setLoading(true);
- const result = await UserApiService.regenerateApiKey(session.api_key || '');
+ const result = await UserApiService.regenerateApiKey(session.api_key);
setLoading(false);
if (result.success) {
- alert(`New API Key: ${result.data?.new_api_key || 'Check your profile'}\n\nPlease save this key securely. You will need to re-login.`);
- await logout();
- } else {
- alert(`Failed to regenerate API key: ${result.error}`);
+ alert('API Key regenerated successfully!');
+ await refreshUserData();
}
}
};
- const extendSession = async () => {
- if (!session?.api_key) return;
- setLoading(true);
- const result = await UserApiService.extendGuestSession(session.api_key || '');
- setLoading(false);
- if (result.success) {
- alert('Session extended successfully!');
- } else {
- alert(`Failed to extend session: ${result.error}`);
- }
- };
+ const accountType = session?.user_info?.account_type || 'free';
+ const credits = session?.user_info?.credit_balance || 0;
+ const username = session?.user_info?.username || session?.user_info?.email || 'User';
+ const email = session?.user_info?.email || 'N/A';
+ const apiKey = session?.api_key || '';
+
+ const headerActions = (
+ <div style={{ display: 'flex', gap: '8px', alignItems: 'center' }}>
+ <div style={{
+ padding: '6px 12px',
+ backgroundColor: COLORS.PANEL_BG,
+ border: `1px solid ${COLORS.BORDER}`,
+ fontFamily: 'monospace',
+ fontSize: '11px'
+ }}>
+ <span style={{ color: COLORS.MUTED }}>CREDITS: </span>
+ <span style={{ color: COLORS.CYAN, fontWeight: 'bold' }}>{credits.toLocaleString()}</span>
+ </div>
+ <div style={{
+ padding: '6px 12px',
+ backgroundColor: COLORS.PANEL_BG,
+ border: `1px solid ${COLORS.BORDER}`,
+ fontFamily: 'monospace',
+ fontSize: '11px'
+ }}>
+ <span style={{ color: COLORS.MUTED }}>PLAN: </span>
+ <span style={{ color: COLORS.ORANGE, fontWeight: 'bold' }}>{accountType.toUpperCase()}</span>
+ </div>
+ <button
+ onClick={() => fetchSectionData()}
+ style={{
+ padding: '6px 12px',
+ backgroundColor: COLORS.HEADER_BG,
+ border: `1px solid ${COLORS.BORDER}`,
+ color: COLORS.WHITE,
+ cursor: 'pointer',
+ fontFamily: 'monospace',
+ fontSize: '11px',
+ display: 'flex',
+ alignItems: 'center',
+ gap: '4px'
+ }}
+ >
+ <RefreshCw size={12} />
+ REFRESH
+ </button>
+ </div>
+ );
- const cancelSubscription = async () => {
- if (!session?.api_key) return;
- if (confirm('Are you sure you want to cancel your subscription? It will remain active until the end of the billing period.')) {
- setLoading(true);
- const result = await UserApiService.cancelSubscription(session.api_key || '');
- setLoading(false);
- if (result.success) {
- alert('Subscription cancelled successfully. It will remain active until the end of your billing period.');
- } else {
- alert(`Failed to cancel subscription: ${result.error}`);
- }
- }
- };
+ return (
+ <div style={{
+ height: '100%',
+ display: 'flex',
+ flexDirection: 'column',
+ backgroundColor: COLORS.DARK_BG,
+ fontFamily: 'Consolas, "Courier New", monospace'
+ }}>
+ <TabHeader
+ title="PROFILE & ACCOUNT"
+ subtitle={`${username} | ${email}`}
+ icon={<User size={20} />}
+ actions={headerActions}
+ />
- const deleteAccount = async () => {
- if (!session?.api_key) return;
- const confirmation = prompt('This action cannot be undone. Type "DELETE MY ACCOUNT" to confirm:');
- if (confirmation === 'DELETE MY ACCOUNT') {
- setLoading(true);
- const result = await UserApiService.deleteUserAccount(session.api_key || '', { confirm: true });
- setLoading(false);
- if (result.success) {
- alert('Your account has been deleted.');
- await logout();
- } else {
- alert(`Failed to delete account: ${result.error}`);
- }
- }
- };
+ {/* Navigation Bar */}
+ <div style={{
+ borderBottom: `1px solid ${COLORS.BORDER}`,
+ backgroundColor: COLORS.HEADER_BG,
+ display: 'flex',
+ gap: '0',
+ flexShrink: 0
+ }}>
+ {[
+ { id: 'overview', label: 'OVERVIEW', icon: User },
+ { id: 'usage', label: 'USAGE & CREDITS', icon: Activity },
+ { id: 'security', label: 'SECURITY', icon: Shield },
+ { id: 'billing', label: 'BILLING', icon: CreditCard },
+ ].map(section => (
+ <button
+ key={section.id}
+ onClick={() => setActiveSection(section.id as Section)}
+ style={{
+ padding: '10px 20px',
+ backgroundColor: activeSection === section.id ? COLORS.PANEL_BG : 'transparent',
+ border: 'none',
+ borderBottom: activeSection === section.id ? `2px solid ${COLORS.ORANGE}` : '2px solid transparent',
+ color: activeSection === section.id ? COLORS.ORANGE : COLORS.MUTED,
+ cursor: 'pointer',
+ fontFamily: 'monospace',
+ fontSize: '11px',
+ fontWeight: 'bold',
+ display: 'flex',
+ alignItems: 'center',
+ gap: '6px',
+ transition: 'all 0.2s'
+ }}
+ >
+ {React.createElement(section.icon, { size: 14 })}
+ {section.label}
+ </button>
+ ))}
+ </div>
- const formatDate = (dateStr?: string) => {
- if (!dateStr) return 'N/A';
- return new Date(dateStr).toLocaleDateString('en-US', {
- year: 'numeric',
- month: 'short',
- day: 'numeric'
- });
- };
+ {/* Content Area */}
+ <div style={{
+ flex: 1,
+ overflow: 'auto',
+ padding: '16px',
+ minHeight: 0,
+ display: 'flex',
+ flexDirection: 'column'
+ }}>
+ {activeSection === 'overview' && <OverviewSection session={session} onLogout={handleLogout} />}
+ {activeSection === 'usage' && <UsageSection usageData={usageData} loading={loading} session={session} />}
+ {activeSection === 'security' && (
+ <SecuritySection
+ session={session}
+ onRegenerateKey={handleRegenerateKey}
+ loading={loading}
+ showApiKey={showApiKey}
+ setShowApiKey={setShowApiKey}
+ />
+ )}
+ {activeSection === 'billing' && <BillingSection paymentHistory={paymentHistory} loading={loading} />}
+ </div>
- const formatCurrency = (amount: number) => {
- return `$${(amount / 100).toFixed(2)}`;
- };
+ <TabFooter
+ tabName="PROFILE"
+ leftInfo={[
+ { label: 'USER', value: username, color: COLORS.CYAN },
+ { label: 'TYPE', value: session?.user_type?.toUpperCase(), color: COLORS.WHITE }
+ ]}
+ statusInfo={`Last Updated: ${new Date().toLocaleTimeString()}`}
+ />
+ </div>
+ );
+};
- // Guest Profile View
- const renderGuestProfile = () => {
- const displayDeviceId = session?.device_id?.substring(0, 30) + "..." || 'Unknown';
- const requestsToday = session?.requests_today || usageData?.requests_today || 0;
- const dailyLimit = session?.daily_limit || usageData?.daily_limit || 50;
- const remaining = Math.max(0, dailyLimit - requestsToday);
- const usagePercent = (requestsToday / dailyLimit) * 100;
-
- return (
- <div style={{ height: '100%', display: 'flex', flexDirection: 'column', backgroundColor: colors.background, overflow: 'hidden' }}>
- {/* Header */}
- <div style={{ backgroundColor: colors.panel, borderBottom: `1px solid ${colors.textMuted}`, padding: '4px 8px', flexShrink: 0 }}>
- <div style={{ display: 'flex', alignItems: 'center', gap: '8px', fontSize: '13px', marginBottom: '2px' }}>
- <span style={{ color: colors.primary, fontWeight: 'bold' }}>{t('guestProfile')}</span>
- <span style={{ color: colors.text }}>|</span>
- <span style={{ color: colors.text }}>{currentTime.toISOString().replace('T', ' ').substring(0, 19)} UTC</span>
- <span style={{ color: colors.text }}>|</span>
- <span style={{ color: colors.textMuted }}>{t('requests')}:</span>
- <span style={{ color: colors.accent }}>{requestsToday}/{dailyLimit}</span>
- <span style={{ color: colors.text }}>|</span>
- <span style={{ color: colors.textMuted }}>{t('remaining')}:</span>
- <span style={{ color: remaining > 10 ? colors.secondary : colors.alert }}>{remaining}</span>
- <button
- onClick={() => fetchData(true)}
- disabled={loading}
- style={{
- marginLeft: 'auto',
- padding: '2px 8px',
- backgroundColor: colors.primary,
- color: colors.background,
- border: 'none',
- borderRadius: '2px',
- fontSize: '11px',
- cursor: loading ? 'not-allowed' : 'pointer',
- fontWeight: 'bold',
- opacity: loading ? 0.5 : 1
- }}
- >
- {loading ? t('loading') : t('refresh')}
- </button>
- </div>
- </div>
+// Overview Section
+const OverviewSection: React.FC<{ session: any; onLogout: () => void }> = ({ session, onLogout }) => {
+ const accountType = session?.user_info?.account_type || 'free';
- {/* Function Keys Bar */}
- <div style={{ backgroundColor: colors.panel, borderBottom: `1px solid ${colors.textMuted}`, padding: '2px 4px', flexShrink: 0 }}>
- <div style={{ display: 'grid', gridTemplateColumns: 'repeat(6, 1fr)', gap: '2px' }}>
- {[
- { key: "F1", label: t('overview'), screen: "overview" },
- { key: "F2", label: t('usage'), screen: "usage" },
- { key: "F3", label: t('settings'), screen: "settings" },
- { key: "F4", label: t('refresh'), action: 'refresh' },
- { key: "F5", label: t('pricing'), action: 'pricing' },
- { key: "F6", label: t('logout'), action: 'logout' }
- ].map(item => (
- <button key={item.key}
- onClick={() => {
- if (item.action === 'refresh') window.location.reload();
- else if (item.action === 'extend') extendSession();
- else if (item.action === 'pricing') navigation.navigateToPricing();
- else if (item.action === 'logout') logoutUser();
- else if (item.screen) setCurrentScreen(item.screen as ProfileScreen);
- }}
- disabled={loading && (item.action === 'extend' || item.action === 'refresh')}
- style={{
- backgroundColor: currentScreen === item.screen ? colors.primary : colors.background,
- border: `1px solid ${colors.textMuted}`,
- color: currentScreen === item.screen ? colors.background : colors.text,
- padding: '2px 4px',
- fontSize: '12px',
- height: '16px',
- display: 'flex',
- alignItems: 'center',
- justifyContent: 'center',
- fontWeight: currentScreen === item.screen ? 'bold' : 'normal',
- cursor: 'pointer'
- }}>
- <span style={{ color: colors.warning }}>{item.key}:</span>
- <span style={{ marginLeft: '2px' }}>{item.label}</span>
- </button>
- ))}
+ return (
+ <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '16px' }}>
+ {/* Account Info */}
+ <DataPanel title="ACCOUNT INFORMATION" icon={<User size={16} />}>
+ <DataRow label="USERNAME" value={session?.user_info?.username || 'N/A'} />
+ <DataRow label="EMAIL" value={session?.user_info?.email || 'N/A'} />
+ <DataRow label="USER TYPE" value={session?.user_type?.toUpperCase() || 'N/A'} />
+ <DataRow label="ACCOUNT TYPE" value={accountType.toUpperCase()} valueColor={COLORS.ORANGE} />
+ <DataRow
+ label="EMAIL VERIFIED"
+ value={session?.user_info?.is_verified ? 'YES' : 'NO'}
+ valueColor={session?.user_info?.is_verified ? COLORS.GREEN : COLORS.RED}
+ />
+ <DataRow
+ label="2FA ENABLED"
+ value={session?.user_info?.mfa_enabled ? 'YES' : 'NO'}
+ valueColor={session?.user_info?.mfa_enabled ? COLORS.GREEN : COLORS.RED}
+ />
+ </DataPanel>
+
+ {/* Credits & Balance */}
+ <DataPanel title="CREDITS & BALANCE" icon={<Zap size={16} />}>
+ <div style={{ padding: '20px 0', textAlign: 'center', borderBottom: `1px solid ${COLORS.BORDER}` }}>
+ <div style={{ fontSize: '36px', color: COLORS.CYAN, fontWeight: 'bold', marginBottom: '8px' }}>
+ {(session?.user_info?.credit_balance || 0).toLocaleString()}
</div>
+ <div style={{ fontSize: '11px', color: COLORS.MUTED }}>AVAILABLE CREDITS</div>
</div>
-
- {/* Main Content */}
- <div style={{ flex: 1, overflow: 'auto', padding: '4px', backgroundColor: '#050505' }}>
- {currentScreen === 'overview' && (
- <div style={{ display: 'flex', gap: '4px', height: '100%' }}>
- {/* Left Column */}
- <div style={{ flex: 1, backgroundColor: colors.panel, border: `1px solid ${colors.textMuted}`, padding: '4px', overflow: 'auto' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- {t('sessionInformation')}
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
-
- <div style={{ marginBottom: '8px', fontSize: '12px' }}>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>{t('accountType')}:</span>
- <span style={{ color: colors.warning, fontWeight: 'bold' }}>{t('guest')}</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>{t('sessionExpires')}:</span>
- <span style={{ color: colors.alert }}>{session?.expires_at ? formatDate(session.expires_at) : 'N/A'}</span>
- </div>
- <div style={{ marginBottom: '2px', paddingTop: '4px', borderTop: `1px solid ${colors.textMuted}` }}>
- <span style={{ color: colors.textMuted }}>{t('deviceId')}:</span>
- <div style={{ color: colors.text, fontSize: '11px', marginTop: '2px', wordBreak: 'break-all' }}>
- {displayDeviceId}
- </div>
- </div>
- <div style={{ marginBottom: '2px', paddingTop: '4px', borderTop: `1px solid ${colors.textMuted}` }}>
- <span style={{ color: colors.textMuted }}>{t('apiKey')}:</span>
- <div style={{ color: colors.text, fontSize: '11px', marginTop: '2px', wordBreak: 'break-all' }}>
- {session?.api_key ? `${session.api_key.substring(0, 40)}...` : 'N/A'}
- </div>
- </div>
- </div>
-
- <div style={{ marginTop: '12px' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- {t('dailyUsageStats')}
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
-
- <div style={{ fontSize: '12px', marginBottom: '6px' }}>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>{t('todaysRequests')}:</span>
- <span style={{ color: colors.text, fontWeight: 'bold' }}>{requestsToday}/{dailyLimit}</span>
- </div>
- <div style={{ backgroundColor: colors.background, height: '6px', marginBottom: '4px', border: `1px solid ${colors.textMuted}` }}>
- <div style={{
- width: `${usagePercent}%`,
- height: '100%',
- backgroundColor: remaining > 10 ? colors.secondary : colors.alert,
- transition: 'width 0.3s'
- }} />
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>{t('remaining')}:</span>
- <span style={{ color: remaining > 10 ? colors.secondary : colors.alert, fontWeight: 'bold' }}>{remaining}</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between' }}>
- <span style={{ color: colors.textMuted }}>{t('status')}:</span>
- <span style={{ color: colors.secondary }}>{t('active')}</span>
- </div>
- </div>
- </div>
- </div>
-
- {/* Right Column */}
- <div style={{ flex: 1, backgroundColor: colors.panel, border: `1px solid ${colors.textMuted}`, padding: '4px', overflow: 'auto' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- {t('upgradeToFullAccess')}
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
-
- <div style={{ fontSize: '12px', color: colors.text, lineHeight: '1.4', marginBottom: '8px' }}>
- <div style={{ color: colors.warning, fontWeight: 'bold', marginBottom: '4px' }}>
- {t('createAccountUnlock')}:
- </div>
- <div style={{ marginLeft: '8px' }}>
- <div>- {t('unlimitedApiRequests')}</div>
- <div>- {t('permanentApiKey')}</div>
- <div>- {t('allDatabaseAccess')}</div>
- <div>- {t('premiumFeatures')}</div>
- <div>- {t('dataMarketplace')}</div>
- <div>- {t('advancedAnalytics')}</div>
- </div>
- </div>
-
- <button
- onClick={() => navigation.navigateToPricing()}
- style={{
- width: '100%',
- padding: '6px',
- backgroundColor: colors.primary,
- border: 'none',
- color: colors.background,
- fontSize: '11px',
- fontWeight: 'bold',
- cursor: 'pointer'
- }}
- >
- {t('viewPricingPlans')}
- </button>
- </div>
- </div>
+ <div style={{ padding: '12px 0' }}>
+ <DataRow label="PLAN" value={accountType.toUpperCase()} valueColor={COLORS.ORANGE} />
+ {session?.user_type === 'guest' && (
+ <>
+ <DataRow label="DAILY LIMIT" value={session?.daily_limit?.toString() || '0'} />
+ <DataRow label="REQUESTS TODAY" value={session?.requests_today?.toString() || '0'} />
+ </>
)}
-
- {currentScreen === 'usage' && renderUsageScreen()}
- {currentScreen === 'settings' && renderGuestSettingsScreen()}
</div>
-
- {/* Status Bar */}
- <div style={{ borderTop: `1px solid ${colors.textMuted}`, backgroundColor: colors.panel, padding: '2px 8px', fontSize: '11px', color: colors.textMuted, flexShrink: 0 }}>
- <div style={{ display: 'flex', justifyContent: 'space-between' }}>
- <span>FinceptTerminal v3.0.11 | Guest Session</span>
- <span>Device: {session?.device_id?.substring(0, 20) || 'UNKNOWN'} | Status: {loading ? 'UPDATING' : 'READY'}</span>
+ </DataPanel>
+
+ {/* Quick Actions */}
+ <div style={{ gridColumn: '1 / -1' }}>
+ <DataPanel title="QUICK ACTIONS" icon={<Activity size={16} />}>
+ <div style={{ display: 'grid', gridTemplateColumns: 'repeat(4, 1fr)', gap: '12px', padding: '8px 0' }}>
+ <ActionButton label="REFRESH DATA" onClick={() => window.location.reload()} />
+ <ActionButton label="UPGRADE PLAN" onClick={() => {}} />
+ <ActionButton label="SETTINGS" onClick={() => {}} />
+ <ActionButton label="LOGOUT" onClick={onLogout} danger />
</div>
- </div>
+ </DataPanel>
</div>
- );
- };
-
- // Registered User Profile View
- const renderUserProfile = () => {
- const userInfo = session?.user_info;
- const accountType = userInfo?.account_type || 'free';
- const hasSubscription = (session?.subscription as any)?.data?.has_subscription || session?.subscription?.has_subscription;
- const subscriptionPlan = (session?.subscription as any)?.data?.subscription?.plan || session?.subscription?.subscription?.plan;
- const subscriptionStatus = (session?.subscription as any)?.data?.subscription?.status || session?.subscription?.subscription?.status;
- const creditBalance = userInfo?.credit_balance ?? 0;
-
- const accountTypeColor = {
- free: colors.textMuted,
- starter: colors.info,
- professional: colors.purple,
- enterprise: colors.primary,
- unlimited: colors.warning
- }[accountType] || colors.text;
-
- const totalRequests = usageData?.total_requests || 0;
- const todayRequests = usageData?.requests_today || usageData?.today_requests || 0;
-
- return (
- <div style={{ height: '100%', display: 'flex', flexDirection: 'column', backgroundColor: colors.background, overflow: 'hidden' }}>
- {/* Header */}
- <div style={{ backgroundColor: colors.panel, borderBottom: `1px solid ${colors.textMuted}`, padding: '4px 8px', flexShrink: 0 }}>
- <div style={{ display: 'flex', alignItems: 'center', gap: '8px', fontSize: '13px', marginBottom: '2px' }}>
- <span style={{ color: colors.primary, fontWeight: 'bold' }}>FINCEPT TERMINAL PROFILE</span>
- <span style={{ color: colors.text }}>|</span>
- <span style={{ color: colors.accent, fontWeight: 'bold' }}>
- {userInfo?.username?.toUpperCase() || userInfo?.email?.split('@')[0]?.toUpperCase() || 'USER'}
- </span>
- <span style={{ color: colors.text }}>|</span>
- <span style={{ color: colors.text }}>{currentTime.toISOString().replace('T', ' ').substring(0, 19)} UTC</span>
- <span style={{ color: colors.text }}>|</span>
- <span style={{ color: colors.textMuted }}>CREDITS:</span>
- <span style={{ color: creditBalance > 0 ? colors.secondary : colors.alert, fontWeight: 'bold' }}>
- {creditBalance.toFixed(2)}
- </span>
- <span style={{ color: colors.text }}>|</span>
- <span style={{ color: colors.textMuted }}>PLAN:</span>
- <span style={{ color: accountTypeColor, fontWeight: 'bold' }}>{accountType.toUpperCase()}</span>
- <button
- onClick={() => fetchData(true)}
- disabled={loading}
- style={{
- marginLeft: 'auto',
- padding: '3px 12px',
- backgroundColor: colors.primary,
- color: colors.background,
- border: 'none',
- borderRadius: '3px',
- fontSize: '11px',
- cursor: loading ? 'not-allowed' : 'pointer',
- fontWeight: 'bold',
- opacity: loading ? 0.5 : 1
- }}
- >
- {loading ? 'LOADING...' : '↻ REFRESH'}
- </button>
- </div>
- </div>
-
- {/* Function Keys Bar */}
- <div style={{ backgroundColor: colors.panel, borderBottom: `1px solid ${colors.textMuted}`, padding: '2px 4px', flexShrink: 0 }}>
- <div style={{ display: 'grid', gridTemplateColumns: 'repeat(12, 1fr)', gap: '2px' }}>
- {[
- { key: "F1", label: "OVERVIEW", screen: "overview" },
- { key: "F2", label: "USAGE", screen: "usage" },
- { key: "F3", label: "PAYMENTS", screen: "payments" },
- { key: "F4", label: "SUBS", screen: "subscriptions" },
- { key: "F5", label: "SUPPORT", screen: "support" },
- { key: "F6", label: "SETTINGS", screen: "settings" },
- { key: "F7", label: "CREDITS", action: 'pricing' },
- { key: "F8", label: "REGEN", action: 'regen' },
- { key: "F9", label: "", screen: "" },
- { key: "F10", label: "", screen: "" },
- { key: "F11", label: "FULL", action: 'fullscreen' },
- { key: "F12", label: "LOGOUT", action: 'logout' }
- ].map(item => (
- <button key={item.key}
- onClick={() => {
- if (item.action === 'logout') logoutUser();
- else if (item.action === 'pricing') navigation.navigateToPricing();
- else if (item.action === 'regen') regenerateApiKey();
- else if (item.action === 'fullscreen') toggleFullscreen();
- else if (item.screen) setCurrentScreen(item.screen as ProfileScreen);
- }}
- disabled={!item.label || (loading && item.action === 'regen')}
- style={{
- backgroundColor: currentScreen === item.screen ? colors.primary : colors.background,
- border: `1px solid ${colors.textMuted}`,
- color: currentScreen === item.screen ? colors.background : colors.text,
- padding: '2px 4px',
- fontSize: '12px',
- height: '16px',
- display: 'flex',
- alignItems: 'center',
- justifyContent: 'center',
- fontWeight: currentScreen === item.screen ? 'bold' : 'normal',
- cursor: item.label ? 'pointer' : 'default',
- opacity: item.label ? 1 : 0.3
- }}>
- <span style={{ color: colors.warning }}>{item.key}:</span>
- {item.label && <span style={{ marginLeft: '2px' }}>{item.label}</span>}
- </button>
- ))}
- </div>
- </div>
-
- {/* Main Content */}
- <div style={{ flex: 1, overflow: 'auto', padding: '4px', backgroundColor: '#050505' }}>
- {currentScreen === 'overview' && (
- <div style={{ display: 'flex', gap: '4px', height: '100%' }}>
- {/* Left Column */}
- <div style={{ flex: 1, backgroundColor: colors.panel, border: `1px solid ${colors.textMuted}`, padding: '4px', overflow: 'auto' }}>
- {/* Credits Section */}
- <div style={{ marginBottom: '12px' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- CREDIT BALANCE
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', marginBottom: '6px' }}>
- <div style={{ color: colors.text, fontSize: '24px', fontWeight: 'bold' }}>
- {creditBalance.toFixed(2)}
- </div>
- <button
- onClick={() => navigation.navigateToPricing()}
- style={{
- padding: '4px 8px',
- backgroundColor: colors.secondary,
- border: 'none',
- color: colors.background,
- fontSize: '12px',
- fontWeight: 'bold',
- cursor: 'pointer'
- }}
- >
- ADD CREDITS
- </button>
- </div>
- <div style={{ color: colors.textMuted, fontSize: '11px' }}>
- Available for API calls and premium features
- </div>
- </div>
-
- {/* Account Details */}
- <div style={{ marginBottom: '12px' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- ACCOUNT DETAILS
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- <div style={{ fontSize: '12px' }}>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>Username:</span>
- <span style={{ color: colors.text, fontWeight: 'bold' }}>{userInfo?.username || 'N/A'}</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>Email:</span>
- <span style={{ color: colors.text }}>{userInfo?.email || 'N/A'}</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>Account Type:</span>
- <span style={{ color: accountTypeColor, fontWeight: 'bold' }}>{accountType.toUpperCase()}</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>Member Since:</span>
- <span style={{ color: colors.text }}>{formatDate((userInfo as any)?.created_at)}</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between' }}>
- <span style={{ color: colors.textMuted }}>User ID:</span>
- <span style={{ color: colors.textMuted, fontSize: '11px' }}>#{(userInfo as any)?.id || 'N/A'}</span>
- </div>
- </div>
- </div>
-
- {/* API Key */}
- <div>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- API AUTHENTICATION
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- <div style={{ fontSize: '12px' }}>
- <div style={{ color: colors.textMuted, marginBottom: '2px' }}>API Key:</div>
- <div style={{ backgroundColor: colors.background, padding: '4px', marginBottom: '4px', border: `1px solid ${colors.textMuted}`, fontSize: '11px', wordBreak: 'break-all', color: colors.text }}>
- {session?.api_key || 'No API key available'}
- </div>
- <button
- onClick={regenerateApiKey}
- disabled={loading}
- style={{
- padding: '4px 8px',
- backgroundColor: colors.background,
- border: `1px solid ${colors.purple}`,
- color: colors.purple,
- fontSize: '12px',
- fontWeight: 'bold',
- cursor: 'pointer',
- width: '100%'
- }}
- >
- REGENERATE API KEY
- </button>
- </div>
- </div>
- </div>
-
- {/* Right Column */}
- <div style={{ flex: 1, backgroundColor: colors.panel, border: `1px solid ${colors.textMuted}`, padding: '4px', overflow: 'auto' }}>
- {/* Subscription Info */}
- <div style={{ marginBottom: '12px' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- SUBSCRIPTION STATUS
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- {hasSubscription && subscriptionPlan ? (
- <div style={{ fontSize: '12px' }}>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>Plan:</span>
- <span style={{ color: colors.secondary, fontWeight: 'bold' }}>{subscriptionPlan.name}</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>Price:</span>
- <span style={{ color: colors.text }}>${subscriptionPlan.price_usd / 100}/mo</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>API Calls:</span>
- <span style={{ color: colors.accent, fontWeight: 'bold' }}>
- {subscriptionPlan.api_calls_limit === -1 ? 'UNLIMITED' :
- subscriptionPlan.api_calls_limit != null ? subscriptionPlan.api_calls_limit.toLocaleString() : 'N/A'}
- </span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '6px' }}>
- <span style={{ color: colors.textMuted }}>Status:</span>
- <span style={{ color: colors.secondary, fontWeight: 'bold' }}>{subscriptionStatus?.toUpperCase()}</span>
- </div>
- <div style={{ display: 'flex', gap: '4px' }}>
- <button
- onClick={cancelSubscription}
- disabled={loading}
- style={{
- flex: 1,
- padding: '4px',
- backgroundColor: colors.background,
- border: `1px solid ${colors.alert}`,
- color: colors.alert,
- fontSize: '11px',
- fontWeight: 'bold',
- cursor: 'pointer'
- }}
- >
- CANCEL
- </button>
- <button
- onClick={() => navigation.navigateToPricing()}
- style={{
- flex: 1,
- padding: '4px',
- backgroundColor: colors.background,
- border: `1px solid ${colors.info}`,
- color: colors.info,
- fontSize: '11px',
- fontWeight: 'bold',
- cursor: 'pointer'
- }}
- >
- CHANGE
- </button>
- </div>
- </div>
- ) : (
- <div style={{ fontSize: '12px' }}>
- <div style={{ color: colors.warning, marginBottom: '4px', fontWeight: 'bold' }}>No active subscription</div>
- <div style={{ color: colors.text, marginBottom: '6px', lineHeight: '1.4' }}>
- <div>- Unlimited API requests</div>
- <div>- Priority support</div>
- <div>- Advanced features</div>
- <div>- Data marketplace access</div>
- </div>
- <button
- onClick={() => navigation.navigateToPricing()}
- style={{
- width: '100%',
- padding: '6px',
- backgroundColor: colors.primary,
- border: 'none',
- color: colors.background,
- fontSize: '12px',
- fontWeight: 'bold',
- cursor: 'pointer'
- }}
- >
- VIEW PLANS
- </button>
- </div>
- )}
- </div>
-
- {/* Usage Stats Quick View */}
- <div>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- API USAGE SUMMARY
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- <div style={{ fontSize: '12px' }}>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>Total Requests:</span>
- <span style={{ color: colors.text }}>{totalRequests.toLocaleString()}</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between' }}>
- <span style={{ color: colors.textMuted }}>Today's Requests:</span>
- <span style={{ color: colors.accent }}>{todayRequests}</span>
- </div>
- </div>
- </div>
- </div>
- </div>
- )}
+ </div>
+ );
+};
- {currentScreen === 'usage' && renderUsageScreen()}
- {currentScreen === 'payments' && renderPaymentsScreen()}
- {currentScreen === 'subscriptions' && renderSubscriptionsScreen()}
- {currentScreen === 'support' && renderSupportScreen()}
- {currentScreen === 'settings' && renderSettingsScreen()}
- </div>
+// Usage Section
+const UsageSection: React.FC<{ usageData: any; loading: boolean; session: any }> = ({ usageData, loading, session }) => {
+ const credits = session?.user_info?.credit_balance || 0;
+ const dailyLimit = session?.daily_limit || 0;
+ const requestsToday = session?.requests_today || 0;
+ const usagePercent = dailyLimit > 0 ? (requestsToday / dailyLimit) * 100 : 0;
- {/* Status Bar */}
- <div style={{ borderTop: `1px solid ${colors.textMuted}`, backgroundColor: colors.panel, padding: '2px 8px', fontSize: '11px', color: colors.textMuted, flexShrink: 0 }}>
- <div style={{ display: 'flex', justifyContent: 'space-between' }}>
- <span>FinceptTerminal v3.0.11 | User: {userInfo?.username || 'N/A'}</span>
- <span>Account: {accountType.toUpperCase()} | Requests: {todayRequests.toLocaleString()} | Status: {loading ? 'UPDATING' : 'READY'}</span>
+ return (
+ <div style={{ display: 'flex', flexDirection: 'column', gap: '16px' }}>
+ <DataPanel title="CREDIT BALANCE" icon={<Zap size={16} />}>
+ <div style={{ padding: '20px 0', textAlign: 'center' }}>
+ <div style={{ fontSize: '48px', color: COLORS.CYAN, fontWeight: 'bold', marginBottom: '8px' }}>
+ {credits.toLocaleString()}
</div>
+ <div style={{ fontSize: '11px', color: COLORS.MUTED }}>AVAILABLE CREDITS</div>
</div>
- </div>
- );
- };
-
- const renderUsageScreen = () => {
- return (
- <div style={{ backgroundColor: colors.panel, border: `1px solid ${colors.textMuted}`, padding: '4px', height: '100%', overflow: 'auto' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- API USAGE STATISTICS
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- {loading ? (
- <div style={{ color: colors.textMuted, fontSize: '12px' }}>Loading usage data...</div>
- ) : usageData ? (
- <div style={{ fontSize: '12px' }}>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>Total Requests:</span>
- <span style={{ color: colors.text, fontWeight: 'bold' }}>{usageData.total_requests?.toLocaleString() || 'N/A'}</span>
+ </DataPanel>
+
+ {session?.user_type === 'guest' && (
+ <DataPanel title="DAILY USAGE LIMIT" icon={<Activity size={16} />}>
+ <div style={{ padding: '12px 0' }}>
+ <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '8px', fontSize: '11px' }}>
+ <span style={{ color: COLORS.MUTED }}>REQUESTS TODAY</span>
+ <span style={{ color: COLORS.WHITE, fontWeight: 'bold' }}>
+ {requestsToday} / {dailyLimit}
+ </span>
</div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>Today's Requests:</span>
- <span style={{ color: colors.accent, fontWeight: 'bold' }}>{usageData.requests_today || usageData.today_requests || 0}</span>
+ <div style={{ height: '8px', backgroundColor: COLORS.HEADER_BG, position: 'relative' }}>
+ <div style={{
+ height: '100%',
+ width: `${usagePercent}%`,
+ backgroundColor: usagePercent >= 90 ? COLORS.RED : COLORS.GREEN,
+ transition: 'width 0.3s'
+ }} />
</div>
- {detailedUsage && (
- <>
- <div style={{ borderTop: `1px solid ${colors.textMuted}`, marginTop: '6px', paddingTop: '6px' }}>
- <div style={{ color: colors.warning, fontWeight: 'bold', marginBottom: '4px' }}>Detailed Usage</div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '2px' }}>
- <span style={{ color: colors.textMuted }}>This Month:</span>
- <span style={{ color: colors.text }}>{detailedUsage.this_month?.toLocaleString() || 'N/A'}</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between' }}>
- <span style={{ color: colors.textMuted }}>Last 30 Days:</span>
- <span style={{ color: colors.text }}>{detailedUsage.last_30_days?.toLocaleString() || 'N/A'}</span>
- </div>
- </div>
- </>
- )}
</div>
- ) : (
- <div style={{ color: colors.textMuted, fontSize: '12px' }}>No usage data available</div>
- )}
- </div>
- );
- };
-
- const renderPaymentsScreen = () => {
- return (
- <div style={{ backgroundColor: colors.panel, border: `1px solid ${colors.textMuted}`, padding: '4px', height: '100%', overflow: 'auto' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- PAYMENT HISTORY
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- {loading ? (
- <div style={{ color: colors.textMuted, fontSize: '12px' }}>Loading payment history...</div>
- ) : paymentHistory.length > 0 ? (
- paymentHistory.map((payment: any, idx: number) => (
- <div key={idx} style={{
- backgroundColor: idx % 2 === 0 ? 'rgba(255,255,255,0.02)' : 'transparent',
- borderLeft: `2px solid ${colors.secondary}`,
- paddingLeft: '4px',
- marginBottom: '4px',
- fontSize: '12px'
- }}>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '1px' }}>
- <span style={{ color: colors.textMuted }}>Amount:</span>
- <span style={{ color: colors.secondary, fontWeight: 'bold' }}>
- {formatCurrency(payment.amount || payment.amount_paid || 0)}
- </span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '1px' }}>
- <span style={{ color: colors.textMuted }}>Date:</span>
- <span style={{ color: colors.text }}>{formatDate(payment.created_at || payment.payment_date)}</span>
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between' }}>
- <span style={{ color: colors.textMuted }}>Status:</span>
- <span style={{ color: payment.status === 'completed' ? colors.secondary : colors.warning, fontWeight: 'bold' }}>
- {payment.status?.toUpperCase() || 'N/A'}
- </span>
- </div>
- </div>
- ))
- ) : (
- <div style={{ color: colors.textMuted, fontSize: '12px' }}>No payment history found</div>
- )}
- </div>
- );
- };
+ </DataPanel>
+ )}
+
+ {usageData && (
+ <DataPanel title="USAGE STATISTICS" icon={<BarChart size={16} />}>
+ <div style={{ display: 'grid', gridTemplateColumns: 'repeat(3, 1fr)', gap: '16px', padding: '12px 0' }}>
+ <StatBox label="TOTAL REQUESTS" value={usageData.total_requests || 0} />
+ <StatBox label="THIS MONTH" value={usageData.month_requests || 0} />
+ <StatBox label="THIS WEEK" value={usageData.week_requests || 0} />
+ </div>
+ </DataPanel>
+ )}
+ </div>
+ );
+};
- const renderSubscriptionsScreen = () => {
- return (
- <div style={{ backgroundColor: colors.panel, border: `1px solid ${colors.textMuted}`, padding: '4px', height: '100%', overflow: 'auto' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- DATABASE SUBSCRIPTIONS
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- {loading ? (
- <div style={{ color: colors.textMuted, fontSize: '12px' }}>Loading subscriptions...</div>
- ) : subscriptions.length > 0 ? (
- subscriptions.map((sub: any, idx: number) => (
- <div key={idx} style={{
- backgroundColor: idx % 2 === 0 ? 'rgba(255,255,255,0.02)' : 'transparent',
- borderLeft: `2px solid ${colors.purple}`,
- paddingLeft: '4px',
- marginBottom: '4px',
- fontSize: '12px'
- }}>
- <div style={{ color: colors.purple, fontWeight: 'bold', marginBottom: '1px' }}>
- {sub.database_name || sub.name || 'Unknown Database'}
- </div>
- <div style={{ color: colors.textMuted }}>
- Subscribed: {formatDate(sub.subscribed_at || sub.created_at)}
- </div>
- </div>
- ))
- ) : (
- <div style={{ color: colors.textMuted, fontSize: '12px' }}>No database subscriptions found</div>
- )}
- </div>
- );
- };
+// Security Section
+const SecuritySection: React.FC<{
+ session: any;
+ onRegenerateKey: () => void;
+ loading: boolean;
+ showApiKey: boolean;
+ setShowApiKey: (show: boolean) => void;
+}> = ({ session, onRegenerateKey, loading, showApiKey, setShowApiKey }) => {
+ const apiKey = session?.api_key || '';
- const renderSupportScreen = () => {
- return (
- <div style={{ backgroundColor: colors.panel, border: `1px solid ${colors.textMuted}`, padding: '4px', height: '100%', overflow: 'auto' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- SUPPORT TICKETS
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- {loading ? (
- <div style={{ color: colors.textMuted, fontSize: '12px' }}>Loading tickets...</div>
- ) : supportTickets.length > 0 ? (
- supportTickets.map((ticket: any, idx: number) => (
- <div key={idx} style={{
- backgroundColor: idx % 2 === 0 ? 'rgba(255,255,255,0.02)' : 'transparent',
- borderLeft: `2px solid ${colors.info}`,
- paddingLeft: '4px',
- marginBottom: '4px',
- fontSize: '12px'
+ return (
+ <div style={{ display: 'flex', flexDirection: 'column', gap: '16px' }}>
+ <DataPanel title="API KEY MANAGEMENT" icon={<Key size={16} />}>
+ <div style={{ padding: '12px 0' }}>
+ <div style={{ display: 'flex', gap: '8px', marginBottom: '12px' }}>
+ <div style={{
+ flex: 1,
+ padding: '10px',
+ backgroundColor: COLORS.HEADER_BG,
+ border: `1px solid ${COLORS.BORDER}`,
+ fontFamily: 'monospace',
+ fontSize: '11px',
+ color: COLORS.MUTED,
+ overflow: 'hidden',
+ textOverflow: 'ellipsis'
}}>
- <div style={{ color: colors.info, fontWeight: 'bold', marginBottom: '1px' }}>
- #{ticket.id} - {ticket.subject}
- </div>
- <div style={{ color: colors.textMuted, marginBottom: '2px', fontSize: '11px' }}>
- {ticket.description?.substring(0, 100)}...
- </div>
- <div style={{ display: 'flex', justifyContent: 'space-between' }}>
- <span style={{ color: colors.textMuted }}>Status:</span>
- <span style={{ color: ticket.status === 'closed' ? colors.secondary : colors.warning, fontWeight: 'bold' }}>
- {ticket.status?.toUpperCase()}
- </span>
- </div>
+ {showApiKey ? apiKey : apiKey.slice(0, 20) + '•'.repeat(Math.max(0, apiKey.length - 20))}
</div>
- ))
- ) : (
- <div>
- <div style={{ color: colors.textMuted, fontSize: '12px', marginBottom: '6px' }}>No support tickets found</div>
<button
- onClick={() => alert('Create ticket feature coming soon')}
+ onClick={() => setShowApiKey(!showApiKey)}
style={{
- padding: '6px',
- backgroundColor: colors.info,
- border: 'none',
- color: colors.background,
- fontSize: '12px',
- fontWeight: 'bold',
- cursor: 'pointer'
+ padding: '10px 16px',
+ backgroundColor: COLORS.HEADER_BG,
+ border: `1px solid ${COLORS.BORDER}`,
+ color: COLORS.WHITE,
+ cursor: 'pointer',
+ fontSize: '11px',
+ fontFamily: 'monospace'
}}
>
- CREATE NEW TICKET
+ {showApiKey ? <><EyeOff size={12} /> HIDE</> : <><Eye size={12} /> SHOW</>}
+ </button>
+ <button
+ onClick={onRegenerateKey}
+ disabled={loading}
+ style={{
+ padding: '10px 16px',
+ backgroundColor: COLORS.ORANGE,
+ border: `1px solid ${COLORS.ORANGE}`,
+ color: COLORS.WHITE,
+ cursor: loading ? 'not-allowed' : 'pointer',
+ fontSize: '11px',
+ fontFamily: 'monospace',
+ opacity: loading ? 0.5 : 1
+ }}
+ >
+ {loading ? 'REGENERATING...' : 'REGENERATE'}
</button>
</div>
- )}
- </div>
- );
- };
-
- const renderSettingsScreen = () => {
- return (
- <div style={{ backgroundColor: colors.panel, border: `1px solid ${colors.textMuted}`, padding: '4px', height: '100%', overflow: 'auto' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- ACCOUNT SETTINGS - DANGER ZONE
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- <div style={{ fontSize: '12px' }}>
- <div style={{ color: colors.warning, fontWeight: 'bold', marginBottom: '4px' }}>WARNING</div>
- <div style={{ color: colors.textMuted, marginBottom: '8px', lineHeight: '1.4' }}>
- Deleting your account is permanent and cannot be undone. All your data, subscriptions, payment history, and API access will be permanently removed.
- </div>
- <button
- onClick={deleteAccount}
- disabled={loading}
- style={{
- padding: '6px 12px',
- backgroundColor: colors.alert,
- border: 'none',
- color: colors.text,
- fontSize: '12px',
- fontWeight: 'bold',
- cursor: 'pointer'
- }}
- >
- DELETE ACCOUNT PERMANENTLY
- </button>
- </div>
- </div>
- );
- };
-
- const renderGuestSettingsScreen = () => {
- return (
- <div style={{ backgroundColor: colors.panel, border: `1px solid ${colors.textMuted}`, padding: '4px', height: '100%', overflow: 'auto' }}>
- <div style={{ color: colors.primary, fontSize: '12px', fontWeight: 'bold', marginBottom: '4px' }}>
- SESSION SETTINGS - DANGER ZONE
- </div>
- <div style={{ borderBottom: `1px solid ${colors.textMuted}`, marginBottom: '4px' }}></div>
- <div style={{ fontSize: '12px' }}>
- <div style={{ color: colors.warning, fontWeight: 'bold', marginBottom: '4px' }}>WARNING</div>
- <div style={{ color: colors.textMuted, marginBottom: '8px', lineHeight: '1.4' }}>
- Deleting your guest session will remove all your data. This action cannot be undone.
+ <div style={{ fontSize: '10px', color: COLORS.MUTED }}>
+ ⚠ Keep your API key secure. Never share it publicly.
</div>
- <button
- onClick={async () => {
- if (confirm('Are you sure you want to delete your guest session?')) {
- if (session?.api_key) {
- setLoading(true);
- const result = await UserApiService.deleteGuestSession(session.api_key || '');
- setLoading(false);
- if (result.success) {
- alert('Guest session deleted successfully.');
- await logout();
- } else {
- alert(`Failed to delete session: ${result.error}`);
- }
- }
- }
- }}
- disabled={loading}
- style={{
- padding: '6px 12px',
- backgroundColor: colors.alert,
- border: 'none',
- color: colors.text,
- fontSize: '12px',
- fontWeight: 'bold',
- cursor: 'pointer'
- }}
- >
- DELETE SESSION PERMANENTLY
- </button>
</div>
- </div>
- );
- };
-
- // Main render
- if (!session) {
- return (
- <div style={{ height: '100%', display: 'flex', alignItems: 'center', justifyContent: 'center', backgroundColor: colors.background, color: colors.text }}>
- <div style={{ textAlign: 'center', fontSize: '12px' }}>
- <div style={{ color: colors.alert, marginBottom: '8px', fontWeight: 'bold' }}>NO SESSION</div>
- <div style={{ color: colors.textMuted }}>Unable to load profile</div>
+ </DataPanel>
+
+ <DataPanel title="SECURITY STATUS" icon={<Shield size={16} />}>
+ <div style={{ padding: '8px 0' }}>
+ <SecurityRow
+ label="EMAIL VERIFICATION"
+ enabled={session?.user_info?.is_verified}
+ />
+ <SecurityRow
+ label="TWO-FACTOR AUTHENTICATION"
+ enabled={session?.user_info?.mfa_enabled}
+ />
</div>
- </div>
- );
- }
-
- const profileContent = session.user_type === 'guest' ? renderGuestProfile() : renderUserProfile();
+ </DataPanel>
+ </div>
+ );
+};
+// Billing Section
+const BillingSection: React.FC<{ paymentHistory: any[]; loading: boolean }> = ({ paymentHistory, loading }) => {
return (
- <div style={{ display: 'flex', flexDirection: 'column', height: '100%' }}>
- {profileContent}
-
- <TabFooter
- tabName="PROFILE"
- leftInfo={[
- { label: `Type: ${session.user_type?.toUpperCase()}`, color: colors.textMuted },
- { label: `Screen: ${currentScreen?.toUpperCase()}`, color: colors.textMuted },
- ]}
- statusInfo={session.user_info?.email || 'Guest Session'}
- backgroundColor={colors.panel}
- borderColor={colors.textMuted}
- />
- </div>
+ <DataPanel title="PAYMENT HISTORY" icon={<FileText size={16} />}>
+ {loading ? (
+ <div style={{ padding: '40px', textAlign: 'center', color: COLORS.MUTED }}>LOADING...</div>
+ ) : paymentHistory.length === 0 ? (
+ <div style={{ padding: '40px', textAlign: 'center', color: COLORS.MUTED }}>NO PAYMENT HISTORY</div>
+ ) : (
+ <table style={{ width: '100%', fontSize: '11px', fontFamily: 'monospace', borderCollapse: 'collapse' }}>
+ <thead>
+ <tr style={{ borderBottom: `1px solid ${COLORS.BORDER}` }}>
+ <th style={{ padding: '8px', textAlign: 'left', color: COLORS.MUTED }}>DATE</th>
+ <th style={{ padding: '8px', textAlign: 'left', color: COLORS.MUTED }}>PLAN</th>
+ <th style={{ padding: '8px', textAlign: 'right', color: COLORS.MUTED }}>AMOUNT</th>
+ <th style={{ padding: '8px', textAlign: 'right', color: COLORS.MUTED }}>STATUS</th>
+ </tr>
+ </thead>
+ <tbody>
+ {paymentHistory.map((payment, index) => (
+ <tr key={index} style={{ borderBottom: `1px solid ${COLORS.BORDER}` }}>
+ <td style={{ padding: '8px', color: COLORS.WHITE }}>
+ {new Date(payment.created_at).toLocaleDateString()}
+ </td>
+ <td style={{ padding: '8px', color: COLORS.WHITE }}>
+ {payment.plan_name || 'PURCHASE'}
+ </td>
+ <td style={{ padding: '8px', textAlign: 'right', color: COLORS.CYAN, fontWeight: 'bold' }}>
+ ${payment.amount}
+ </td>
+ <td style={{
+ padding: '8px',
+ textAlign: 'right',
+ color: payment.status === 'success' ? COLORS.GREEN : COLORS.RED,
+ fontWeight: 'bold'
+ }}>
+ {payment.status.toUpperCase()}
+ </td>
+ </tr>
+ ))}
+ </tbody>
+ </table>
+ )}
+ </DataPanel>
);
};
+// Helper Components
+const DataPanel: React.FC<{ title: string; icon: React.ReactNode; children: React.ReactNode }> = ({ title, icon, children }) => (
+ <div style={{
+ backgroundColor: COLORS.PANEL_BG,
+ border: `1px solid ${COLORS.BORDER}`,
+ padding: '16px'
+ }}>
+ <div style={{
+ display: 'flex',
+ alignItems: 'center',
+ gap: '8px',
+ marginBottom: '12px',
+ paddingBottom: '8px',
+ borderBottom: `1px solid ${COLORS.BORDER}`
+ }}>
+ <span style={{ color: COLORS.ORANGE }}>{icon}</span>
+ <span style={{ color: COLORS.WHITE, fontSize: '12px', fontWeight: 'bold' }}>{title}</span>
+ </div>
+ {children}
+ </div>
+);
+
+const DataRow: React.FC<{ label: string; value: string; valueColor?: string }> = ({ label, value, valueColor }) => (
+ <div style={{
+ display: 'flex',
+ justifyContent: 'space-between',
+ padding: '6px 0',
+ fontSize: '11px',
+ borderBottom: `1px solid ${COLORS.BORDER}`
+ }}>
+ <span style={{ color: COLORS.MUTED }}>{label}</span>
+ <span style={{ color: valueColor || COLORS.WHITE, fontWeight: 'bold' }}>{value}</span>
+ </div>
+);
+
+const ActionButton: React.FC<{ label: string; onClick: () => void; danger?: boolean }> = ({ label, onClick, danger }) => (
+ <button
+ onClick={onClick}
+ style={{
+ padding: '12px',
+ backgroundColor: COLORS.HEADER_BG,
+ border: `1px solid ${COLORS.BORDER}`,
+ color: danger ? COLORS.RED : COLORS.WHITE,
+ cursor: 'pointer',
+ fontSize: '10px',
+ fontFamily: 'monospace',
+ fontWeight: 'bold',
+ transition: 'all 0.2s'
+ }}
+ onMouseEnter={(e) => {
+ e.currentTarget.style.backgroundColor = COLORS.BORDER;
+ }}
+ onMouseLeave={(e) => {
+ e.currentTarget.style.backgroundColor = COLORS.HEADER_BG;
+ }}
+ >
+ {label}
+ </button>
+);
+
+const StatBox: React.FC<{ label: string; value: number }> = ({ label, value }) => (
+ <div style={{
+ padding: '12px',
+ backgroundColor: COLORS.HEADER_BG,
+ border: `1px solid ${COLORS.BORDER}`,
+ textAlign: 'center'
+ }}>
+ <div style={{ fontSize: '24px', color: COLORS.CYAN, fontWeight: 'bold' }}>{value.toLocaleString()}</div>
+ <div style={{ fontSize: '10px', color: COLORS.MUTED, marginTop: '4px' }}>{label}</div>
+ </div>
+);
+
+const SecurityRow: React.FC<{ label: string; enabled: boolean }> = ({ label, enabled }) => (
+ <div style={{
+ display: 'flex',
+ justifyContent: 'space-between',
+ alignItems: 'center',
+ padding: '10px 0',
+ borderBottom: `1px solid ${COLORS.BORDER}`
+ }}>
+ <span style={{ color: COLORS.WHITE, fontSize: '11px' }}>{label}</span>
+ <div style={{ display: 'flex', alignItems: 'center', gap: '6px' }}>
+ <span style={{
+ color: enabled ? COLORS.GREEN : COLORS.RED,
+ fontSize: '11px',
+ fontWeight: 'bold'
+ }}>
+ {enabled ? 'ENABLED' : 'DISABLED'}
+ </span>
+ {enabled ? (
+ <CheckCircle size={14} color={COLORS.GREEN} />
+ ) : (
+ <AlertCircle size={14} color={COLORS.RED} />
+ )}
+ </div>
+ </div>
+);
+
export default ProfileTab;
diff --git a/fincept-terminal-desktop/src/contexts/AuthContext.tsx b/fincept-terminal-desktop/src/contexts/AuthContext.tsx
index 682ef0df0..861e03820 100644
--- a/fincept-terminal-desktop/src/contexts/AuthContext.tsx
+++ b/fincept-terminal-desktop/src/contexts/AuthContext.tsx
@@ -136,11 +136,9 @@ interface AuthContextType {
username: string,
email: string,
password: string,
- additionalData?: {
- phone?: string;
- country_code?: string;
- country?: string;
- }
+ phone?: string,
+ country?: string,
+ country_code?: string
) => Promise<{ success: boolean; error?: string }>;
verifyOtp: (email: string, otp: string) => Promise<{ success: boolean; error?: string }>;
setupGuestAccess: () => Promise<{ success: boolean; error?: string }>;
@@ -553,20 +551,19 @@ const fetchUserProfile = async (apiKey: string): Promise<UserProfileResponse['da
username: string,
email: string,
password: string,
- additionalData?: {
- phone?: string;
- country_code?: string;
- country?: string;
- }
+ phone?: string,
+ country?: string,
+ country_code?: string
): Promise<{ success: boolean; error?: string }> => {
try {
const result = await AuthApiService.register({
username,
email,
password,
- ...(additionalData?.phone && { phone: additionalData.phone }),
- ...(additionalData?.country_code && { country_code: additionalData.country_code }),
- ...(additionalData?.country && { country: additionalData.country })
+ phone: phone || null,
+ country: country || null,
+ country_code: country_code || null,
+ preferred_currency: 'USD'
}) as ApiResponse;
if (result.success) {
diff --git a/fincept-terminal-desktop/src/services/authApi.tsx b/fincept-terminal-desktop/src/services/authApi.tsx
index 3ddb04d0d..72f0c8c65 100644
--- a/fincept-terminal-desktop/src/services/authApi.tsx
+++ b/fincept-terminal-desktop/src/services/authApi.tsx
@@ -32,9 +32,10 @@ interface RegisterRequest {
username: string;
email: string;
password: string;
- phone?: string;
- country_code?: string;
- country?: string;
+ phone?: string | null;
+ country?: string | null;
+ country_code?: string | null;
+ preferred_currency?: string | null;
}
interface VerifyOtpRequest {