Nova Bot - Introduction
Nova is a sophisticated AI-powered Telegram bot ecosystem with deep blockchain integration on
Aptos. Nova provides advanced group management, AI-driven conversations with tool-calling
capabilities, automated payment systems, content moderation, and decentralized governance
features. It's designed for Telegram users and groups that need intelligent automation,
financial operations, and comprehensive administrative controls.
What is Nova Bot?
Nova Bot combines cutting-edge AI technology with blockchain transparency to deliver:
- AI-Powered Conversations: Access to advanced language models (GPT-5,
GPT-5-mini) with tool-calling capabilities
- Blockchain Integration: Multi-chain support across Aptos, Solana, and 20+ EVM-compatible blockchains for transparent payments and transactions
- Multi-Token Support: Work with native tokens and ERC-20 tokens across all supported chains (APT, USDC, USDT, GUI, ETH, and more)
- Market Data Tools: Real-time cryptocurrency prices, trending pools, DEX
data, price predictions, and more
- Image Generation: AI-powered image creation capabilities
- Conversation Management: Automatic summarization for long conversations
- DAO Vote Proposals: Guide community direction through on-chain proposals and voting
- Sentinel Protection: Guard your group from bad actors with automated moderation
- User Payments: Send tokens seamlessly between group members in chat
- Real-time Info: Get live updates such as price feeds right inside the conversation
- Scheduled AI Prompts: Automatically deliver insights or reminders (e.g., price updates)
- Scheduled Payments: Automate moderator or community manager remuneration
- Automatic Bot Answers: Engage members with instant responses and helpful prompts
- Sponsorships: Let members sponsor access so others can use AI tools
- Multi-Chain Wallet Support: Manage wallets across Aptos, Solana, and 20+ EVM-compatible blockchains. Send tokens seamlessly across different networks with automatic gas handling
Getting Started with Nova Bot
To start using Nova Bot:
- Open Telegram and search for @NovaInferencoBot
- Click "Start" to begin
- Send
/loginuser to authenticate
- Get your wallet address with
/walletaddress
- Fund your account with APT, USDC, USDT, or GUI tokens
- Start using commands like
/c for personal AI chat or /g for group AI chat
Continue to the section to learn about all available commands.
Nova Bot - Commands
Nova Bot provides a comprehensive set of commands for both personal and group use. Here are all available commands:
Basic Commands
/start
Start interacting with the bot. Use this command to begin your Nova Bot experience.
/help
Display help text with information about available commands.
/aptosconnect
Open the Aptos Connect app for wallet connection.
/tutorial
Watch the quick start tutorial video to learn how to use Nova Bot.
Authentication Commands
/loginuser
Log in as a user. This command can only be used in direct messages (DM). Required before using most features.
/logingroup
Group login (under development).
AI Chat Commands
/c
Prompt to chat with AI in a private conversation. Use this command followed by your question or request. The AI can use various tools to help you.
Example: /c What's the price of Bitcoin?
/g
Prompt to chat with AI in a group. Only group admins can use this command. The AI will respond in the group chat.
Example: /g Show trending pools on Aptos
/newchat
Start a new conversation thread. This clears the conversation history and starts fresh.
Wallet & Balance Commands
/walletaddress
Get your Nova wallet address. Use this address to fund your account with tokens.
/balance [symbol]
Get your balance of a token. If no symbol is provided, shows your full portfolio snapshot.
Example: /balance APT or /balance for full portfolio
/groupwalletaddress
Get the group's wallet address. Use this to fund the group's account.
/groupbalance [symbol]
Get the group's balance of a token. If no symbol is provided, shows the group's full portfolio snapshot.
/supportedchains
List all supported EVM blockchain mainnets. Use this command to see which chains you can deposit tokens to.
Settings Commands
/usersettings
Open user settings menu. This command can only be used in direct messages (DM). Access model selection, payment settings, API keys, document library, and more.
/groupsettings
Open group settings menu. Only group administrators can use this command. Configure payment tokens, DAO preferences, moderation, sponsor settings, welcome protection, command settings, filters, and summarization settings.
Scheduling Commands
/scheduleprompt
Schedule a recurring or one-shot group prompt. Only admins can use this command. Useful for automated announcements or regular updates.
/listscheduled
List active scheduled prompts. Only admins can use this command.
/schedulepayment
Schedule a token payment to a user. Only admins can use this command. Useful for automating moderator or community manager payments.
/listscheduledpayments
List scheduled token payments. Only admins can use this command.
Group Management Commands
/report
Moderate content by replying to a message. Sends a report to the admin if content is found to be inappropriate, muting the user in this case.
/rules
Show core and custom rules for this group.
Information Commands
/prices
Display model pricing information for AI services.
/globalannouncement
Send a global announcement. Only authorized users can use this command.
Nova Bot - Settings
Nova Bot provides comprehensive settings for both individual users and groups. Configure your preferences to customize your Nova experience.
User Settings (/usersettings)
User settings can only be accessed in direct messages (DM). Send /usersettings to open the settings menu.
Available User Settings
🧠 Select Model
Choose which AI model to use for your conversations. Available models include:
- GPT-5: Most advanced model for complex tasks ($0.00410 per 1k tokens)
- GPT-5-mini: Faster, more cost-effective option ($0.00082 per 1k tokens)
- Sentinel (GPT-5-nano): Lightweight model for moderation ($0.00016 per 1k tokens)
You can also configure reasoning mode and other model preferences.
💳 Payment Settings
Configure your preferred payment token and currency. Choose from:
- APT - Aptos native token
- USDC - USD Coin
- USDT - Tether USD
- GUI - GUI token
This setting determines which token will be used for billing your AI requests.
🔑 API Key
Generate and manage API keys for integrating Nova's capabilities into your applications. Each API key can have:
- Different application prompts
- Specific tool permissions
- Custom token limits
- Different payment currencies
See the section for detailed instructions.
📁 Document Library
Upload and manage documents for your personal knowledge base. These documents are used by the AI when you make requests using /c.
Supported file types include: .txt, .md, .pdf, .docx, and various code files.
Upload files through the Document Library interface, and the AI will automatically search through them when answering your questions.
📋 View My Settings
View your current settings summary, including model preferences, payment settings, and other configurations.
🧾 Summarization Settings
Configure conversation summarization preferences:
- Enable/Disable: Turn summarization on or off
- Token Limit: Set the token threshold before summarization triggers (default: 20,000 tokens)
When enabled, long conversations are automatically summarized to maintain context while reducing token usage.
Group Settings (/groupsettings)
Group settings can only be accessed by group administrators. Send /groupsettings in a group chat to open the settings menu.
Available Group Settings
💳 Payment Settings
Configure the group's preferred payment token and currency. Same options as user settings (APT, USDC, USDT, GUI).
This determines which token will be used for billing group AI requests made with /g.
🏛️ DAO Preferences
Configure decentralized autonomous organization (DAO) settings:
- DAO Token: Set the default token for DAO proposals
- Vote Duration: Configure default duration for voting periods
- Notifications: Enable/disable DAO proposal notifications
These settings are used when creating DAO proposals with the create_proposal tool.
🛡️ Moderation
Configure content moderation settings:
- Moderation Mode: Enable/disable automated content moderation
- Moderation Overrides: Configure custom moderation rules
- Sentinel Protection: Enable automated protection against bad actors
Moderation helps keep your group safe from spam and inappropriate content.
🎯 Sponsor Settings
Configure sponsorship features:
- Enable Sponsorships: Allow members to sponsor AI access for others
- Request Limits: Set limits on sponsored requests
Sponsorships allow community members to help others access AI features even when they've reached their usage limits.
👋 Welcome Settings
Configure welcome messages and new member protection:
- Welcome Message: Customize the message sent to new members
- Protection Period: Set a time period where new members have restricted access
🔍 Filters
Configure message filters for automated actions:
- Keyword Filters: Set up automatic responses or actions for specific keywords
- Pattern Matching: Create custom filter patterns
Filters allow you to automate responses or actions based on message content.
📁 Group Document Library
Upload and manage documents for the group's knowledge base. These documents are used by the AI when group members make requests using /g.
Group documents are separate from user documents and are only accessible in group contexts.
⚙️ Command Settings
Configure command behavior and permissions:
- Command Permissions: Set who can use specific commands
- Command Behavior: Customize how commands work in your group
📋 Summarization Settings
Configure conversation summarization for group chats:
- Enable/Disable: Turn summarization on or off for group conversations
- Token Limit: Set the token threshold before summarization triggers
Group summarization helps manage long conversations in group chats.
Nova Bot - Prompts
Nova Bot provides powerful AI capabilities through prompts. You can use /c for personal conversations and /g for group conversations. The AI can automatically call various tools to help answer your questions.
Available Tools
Nova Bot has access to a wide range of tools that the AI can use automatically based on your prompts. These tools are categorized into built-in tools and MCP (Model Context Protocol) tools.
Built-in Tools
These tools are always available and work with both /c and /g commands:
🖼️ Image Generation
Create images from text descriptions using AI. The AI will automatically use this tool when you ask for image generation.
Cost: $0.16 per image
🌐 Web Search Preview
Search the web for real-time information. The AI uses this tool to find current information not in its training data.
Cost: $0.016 per call
📂 File Search (RAG)
Search your uploaded documents for context-aware answers. The AI automatically searches your document library (user library for /c, group library for /g) when relevant.
Cost: $0.004 per call
MCP Tools (Blockchain & Data)
These tools are available through the MCP server and provide blockchain and market data capabilities:
Cost: $0.00082 per 1k tokens (output) — same rate as GPT-5-mini. Pricing is based on output tokens with a minimum charge per request.
📈 Get Trending Pools
Fetch top trending DEX pools on networks like Aptos, Solana, Ethereum, BSC, Polygon, Avalanche, Fantom, Cronos, Arbitrum, Base, etc.
🔍 Search Pools
Find specific DEX pools by token symbol, contract address, or pool address. Always specify the network to avoid confusion.
🆕 Get New Pools
Discover the latest pool creations on supported networks.
💰 Get Token Price
Retrieve focused token price data from BitcoinTry exchange. Use when tokens are unavailable on DEX pools or when you need BitcoinTry-specific data.
📊 Get Fear & Greed Index
Check current crypto market sentiment. Returns an index from 0-100 indicating market fear or greed.
🧮 Calculator
Evaluate mathematical expressions and financial formulas. Supports arithmetic, percentages, and finance functions (NPV, IRR, PV, FV, PMT, NPER).
🕒 Get Current Time
Get precise time for any timezone. Essential for time-sensitive operations like creating DAO proposals.
📜 Coindesk History
Retrieve historical crypto price data (OHLC) for specified date ranges.
📉 Dexscreener API
Access comprehensive DEX data via Dexscreener. Get current prices, token profiles, boosts, orders, and pair metadata.
🔮 Price Predictions
Get AI-powered cryptocurrency price forecasts. Supports both short-term forecasts (15 minutes, 1 hour, 4 hours) using hybrid ensemble models and long-term forecasts (1 day to 4 years) using Monte Carlo simulations.
Forecast Types:
- Short-term: 15 minutes, 1 hour, 4 hours
- Long-term: 1 day, 3 days, 1 week, 1 month, 3 months, 6 months, 1 year, 4 years
Returns expected price, confidence level, and optionally historical OHLC chart data for visualization.
📱 Social Insights
Get crypto social media intelligence and sentiment analysis. Provides Twitter/X and Telegram social analytics specifically for cryptocurrency discussions. Use this for:
- Trending Tokens: Get tokens trending on social media with mention counts and sentiment
- Top Mentions: Find the most significant mentions for any ticker symbol
- Smart Account Stats: Analyze Twitter account engagement and smart following metrics
- Mentions Search: Search mentions by keywords or account name
- Event Summary: Get AI-generated summaries of events from keyword mentions (5 credits)
- Trending Narratives: Discover trending crypto narratives on Twitter/X (5 credits)
- Token News: Find news mentions related to specific tokens
- Trending Contracts: Track contract addresses trending on Twitter/X or Telegram
Note: This tool is specifically for social media analytics, not price data or DEX pools. Use GeckoTerminal/DexScreener tools for market data. User profiles in responses are returned as clickable profile links (e.g., [username](https://x.com/username)) instead of @username tags to avoid confusion in other apps.
Bot-Specific Tools
These tools are specific to Nova Bot functionality:
💰 Get Balance
Get the current account balance for a user or group. Available for both /c and /g.
🔑 Get Wallet Address
Get the wallet address for a user or group. Available for both /c and /g.
💸 Fund Account
Fund the resource account with tokens from the main wallet. Available for both /c and /g.
💸 Withdraw Funds
Withdraw funds from the account. Available for both /c and /g.
🌐 Multi-Chain Wallet
Nova supports wallets across multiple blockchains including Aptos, Solana, and 20+ EVM-compatible chains (Ethereum, Arbitrum, Base, Optimism, Polygon, Avalanche, and more). You can send tokens to users on different blockchains.
Supported Chains: Use /supportedchains to see all supported EVM blockchain mainnets.
Important: To send tokens on EVM chains (Ethereum, Arbitrum, Base, etc.) or Solana, you must have native tokens (e.g., ETH for Ethereum, SOL for Solana) in your wallet to pay for gas fees. Aptos is the exception—you can send tokens on Aptos without needing APT for gas. Make sure to deposit native tokens before attempting to send tokens on EVM chains or Solana.
💱 Pay Users
Send tokens to multiple Telegram users by username. Available for both /c and /g.
🗳️ Create Proposal
Create a new DAO voting proposal. Only available for /g (group commands). Requires group DAO settings to be configured.
💬 Get Recent Messages
Retrieve the most recent messages (up to 30) from the Telegram group chat. Only available for /g (group commands).
Tools Available for /c (User Prompts)
When using /c or /prompt in a private chat, the AI can use:
- All built-in tools (Image Generation, Web Search, File Search)
- All MCP tools (Trending Pools, Search Pools, Token Price, Fear & Greed Index, Calculator, Current Time, Coindesk History, Dexscreener API, Price Predictions, Social Insights)
- User-specific bot tools (Get Balance, Get Wallet Address, Fund Account, Withdraw Funds, Pay Users)
- Your personal document library (uploaded via User Settings > Document Library)
Tools Available for /g (Group Prompts)
When using /g in a group chat (admin only), the AI can use:
- All built-in tools (Image Generation, Web Search, File Search)
- All MCP tools (Trending Pools, Search Pools, Token Price, Fear & Greed Index, Calculator, Current Time, Coindesk History, Dexscreener API, Price Predictions, Social Insights)
- Group-specific bot tools (Get Balance, Get Wallet Address, Fund Account, Withdraw Funds, Pay Users, Create Proposal, Get Recent Messages)
- Group document library (uploaded via Group Settings > Group Document Library)
Example Prompts
Here are some example prompts you can use with Nova Bot:
Wallet & Balance Examples
/c What's my wallet address?
/c Show my balance
/c Check my APT balance
/c How much do I have in USDC?
/c Show my balance on Ethereum
/c What's my wallet address on Arbitrum?
/c Check my USDC balance on Base
Transaction Examples
/c Send 10 APT to @username
/c Send 0.1 ETH to @username on Ethereum
/c Send 50 USDC to @user1 on Arbitrum
/c Send 100 USDT to @user2 on Base network
/c Withdraw 5 USDC
/c Fund my account with 100 APT
Note: When sending tokens on EVM chains (Ethereum, Arbitrum, Base, etc.) or Solana, you need native tokens (ETH, SOL, etc.) in your wallet to pay for gas fees. Aptos is the exception—you can send tokens on Aptos without needing APT for gas. The AI will automatically use the correct chain based on your request.
Market Data Examples
/c What's the current price of Bitcoin?
/c Show me trending pools on Aptos
/c Find pools for APT/USDC on Aptos
/c What's the Fear & Greed Index?
/c Get historical price data for Ethereum for the last 7 days
Price Prediction Examples
/c Predict Bitcoin price in 1 hour
/c What will Ethereum price be in 1 week?
/c Forecast APT price for 1 month
/c Get a 4-hour price forecast for Solana
/c Show me a 1-year price prediction for Bitcoin with chart data
Social Intelligence Examples
/c What tokens are trending on Twitter right now?
/c Show me the top mentions of Bitcoin on X in the last 24 hours
/c Get smart stats for the Twitter account @elonmusk
/c Search for mentions of "Aptos" on Twitter
/c What are the trending narratives in crypto right now?
/c Find trending contract addresses on Telegram
/c Get an event summary about "Bitcoin halving" from social media
DAO & Group Examples (for /g)
/g Create a DAO proposal to vote on adding a new moderator
/g What have we discussed recently in this group?
/g Send 50 APT to @user1, @user2, and @user3
/g Send 0.05 ETH to @moderator1 on Ethereum
/g Send 100 USDC to @member1, @member2 on Arbitrum
Note for Group Admins: When sending tokens to group members on EVM chains or Solana, ensure the group wallet has native tokens (ETH, SOL, etc.) to cover gas fees. Aptos is the exception—you can send tokens on Aptos without needing APT for gas. The AI will automatically handle multi-chain transactions.
Image Generation Examples
/c Generate an image of a futuristic city with flying cars
/c Create a logo for a crypto project called "Nova"
Document Search Examples
/c What does my documentation say about API integration?
/c Search my documents for information about pricing
General AI Examples
/c What can you help me with?
/c Explain how this bot works
/c Calculate the ROI if I invest $1000 at 8% annual return for 5 years
Tip: Use /c for personal chat and /g for group chat (admin only)!
Nova API - Introduction
Developers can integrate Nova's AI and blockchain capabilities into their applications through
API key generation, enabling seamless access to its powerful features in third-party projects.
What is Nova API?
Nova API is a RESTful API that provides programmatic access to Nova's AI and blockchain capabilities. The API offers:
- RESTful Endpoints: Simple HTTP-based API with JSON request/response format. Base URL:
https://gateway.inferenco.com
- API Key Authentication: Secure Bearer token authentication for all requests. Generate and manage multiple API keys with different configurations
- AI Model Access: Programmatic access to advanced language models (GPT-5, GPT-5-mini) with configurable parameters (verbosity, reasoning mode, token limits)
- Automatic Tool Calling: AI automatically selects and calls appropriate tools based on your prompts, including market data, price predictions, social intelligence, image generation, web search, and more
- Knowledge Base Integration (RAG): Upload documents to your API key's vector store for context-aware responses. The API automatically searches your knowledge base when relevant
- Streaming Responses: Support for Server-Sent Events (SSE) for real-time streaming of AI responses
- Custom Configuration: Configure custom prompts, tool permissions, token limits, and payment currencies per API key
- Conversation Management: Maintain conversation context with reference IDs and automatic summarization for long conversations
- Pay-Per-Use Billing: Transparent, on-chain billing in APT, USDC, USDT, or GUI tokens. Pay only for what you use
- Multi-Environment Support: Create separate API keys for development and production with different settings
Use Cases for Integration
AI-Powered Applications
Integrate Nova's AI capabilities into web applications, mobile apps, or backend services via REST API calls. Use the /ai endpoint for customer support chatbots, content generation, data analysis, or any application that needs intelligent conversational AI with automatic tool calling.
Trading & DeFi Platforms
Access real-time cryptocurrency market data through AI prompts that automatically call tools like trending pools, DEX pool search, token prices, price predictions, Fear & Greed Index, social intelligence, and historical price data. Perfect for building trading dashboards, portfolio trackers, or DeFi analytics tools that need intelligent market analysis combined with social sentiment.
Price Prediction Services
Integrate AI-powered price forecasting into your applications. The API can automatically use the price prediction tool to provide short-term forecasts (15 minutes to 4 hours) or long-term forecasts (1 day to 4 years) for any cryptocurrency. Ideal for trading bots, portfolio management tools, or market analysis platforms.
Social Intelligence & Sentiment Analysis
Integrate crypto social media intelligence into your applications. Track trending tokens on Twitter/X and Telegram, analyze top mentions for any ticker, get smart account statistics, search mentions by keywords, discover trending narratives, and monitor contract addresses trending on social media. Perfect for sentiment analysis platforms, social trading tools, influencer tracking, or market research applications that need to understand crypto community discussions and trends. User profiles in responses are returned as clickable profile links (e.g., [username](https://x.com/username)) instead of @username tags.
Content Creation Platforms
Use Nova's image generation capabilities via API calls. The AI automatically calls the image generation tool when needed, allowing you to integrate AI-powered image creation into content management systems, social media tools, or creative applications without managing image generation infrastructure.
Knowledge-Based Applications
Build applications with custom knowledge bases using Nova's RAG (Retrieval-Augmented Generation) capabilities. Upload documents to your API key's vector store, and the AI will automatically search and use your knowledge base when answering questions. Perfect for documentation assistants, FAQ systems, or domain-specific AI applications.
Automation & Workflow Tools
Create automated workflows that combine AI analysis with real-time data. Use the API to build scheduled jobs, reporting tools, or business intelligence applications that leverage AI reasoning, web search, market data, and calculations. The API supports streaming responses for real-time updates.
Developer Tools & SDKs
Build SDKs, libraries, or developer tools that wrap Nova's API. Create language-specific clients, CLI tools, or integrations for popular frameworks. The RESTful API design makes it easy to create wrappers in any programming language.
Getting Started
To start integrating Nova into your application:
- Create an account in the Nova Telegram bot
- Fund your account with supported tokens
- Generate an API key through the bot interface
- Use the API key to authenticate your requests
- Start making API calls to access Nova's features
Continue to the section for
detailed instructions.
Generate API Key
To use Nova's API in your applications, you need to generate an API key through the Nova Telegram
bot. Follow these steps:
Prerequisites
Step-by-Step Guide
-
Start the Nova Bot
Open Telegram and search for @NovaInferencoBot, then
click "Start" to begin.
-
Login to Your Account
Send the command /loginuser in the bot chat. This will initiate the
authentication process.
/loginuser
-
Get Your Wallet Address
Send the command /walletaddress to retrieve your Nova wallet address. You'll
need this to fund your account.
/walletaddress
-
Fund Your Account
Send funds to your Nova wallet address using one of the supported tokens on Aptos:
- APT - Aptos native token
- USDC - USD Coin
- USDT - Tether USD
- GUI - GUI token
You can send tokens using any Aptos-compatible wallet or exchange. The funds will be
available in your Nova account for API usage.
-
Access API Key Settings
Send the command /usersettings to open the user settings menu.
/usersettings
-
Select API Key Option
In the settings menu, click on "🔑 API Key" to start the API key
creation process.
-
Follow the Creation Wizard
The bot will guide you through a 6-step process:
- App Type: Choose between Frontend (Web App) or Backend (Server)
- Domain (Frontend only): Enter your application's domain (e.g.,
inferenco.com)
- Prompt: Define your application's general prompt and rules
- Tools: Select which tools your API key will have access to
- Token Limit: Set the token limit for conversation summarization
(default: 20,000)
- Currency: Choose the payment currency (APT, USDC, USDT, or GUI)
-
Save Your API Key
Once the wizard completes, you'll receive your API key. Important: Save
this key securely as it won't be shown again. You can view and manage your API keys
anytime through the settings menu.
Managing API Keys
You can create multiple API keys for different applications or environments. Each API key can
have different:
- Application prompts
- Tool permissions
- Token limits
- Payment currencies
To manage your API keys:
- Go to
/usersettings
- Click "🔑 API Key"
- View all your keys, create new ones, or delete existing ones
Security Best Practices
- Never share your API key publicly or commit it to version control
- Store keys securely using environment variables or secure vaults
- Use different keys for development and production environments
- Revoke keys immediately if they're compromised or no longer needed
- Monitor usage to detect any unauthorized access
Next Steps
Once you have your API key, you can add knowledge to it by uploading documents. Continue to the
section to
learn how to upload files, or proceed to the section to learn how to make API requests.
Tools
Nova provides a suite of powerful tools that the AI can autonomously call to answer queries.
Built-in Tools
- 🖼️ Image Generation: Create images from text descriptions.
- 🌐 Web Search Preview: Search the web for real-time information.
- 📂 File Search (RAG): Search your uploaded documents for
context-aware answers.
MCP Tools (Blockchain & Data)
- 📈 Get Trending Pools: Fetch top trending DEX pools on networks like Aptos,
Solana, Ethereum, BSC, etc.
- 🔍 Search Pools: Find specific DEX pools by token symbol, contract, or pool
address.
- 🆕 Get New Pools: Discover the latest pool creations on supported networks.
- 💰 Get Token Price: Retrieve focused token price data from BitcoinTry exchange.
- 📊 Get Fear & Greed Index: Check current crypto market sentiment.
- 🧮 Calculator: Evaluate mathematical expressions and financial formulas.
- 🕒 Get Current Time: Get precise time for any timezone (essential for
time-sensitive operations).
- 📜 Coindesk History: Retrieve historical crypto price data.
- 📉 Dexscreener API: Access comprehensive DEX data via Dexscreener.
- 🔮 Price Predictions: Get AI-powered cryptocurrency price forecasts. Supports both short-term forecasts (15 minutes, 1 hour, 4 hours) using hybrid ensemble models and long-term forecasts (1 day to 4 years) using Monte Carlo simulations. Returns expected price, confidence level, and optionally historical OHLC chart data for visualization.
- 📱 Social Insights: Get crypto social media intelligence and sentiment analysis. Provides Twitter/X and Telegram social analytics including trending tokens, top mentions, smart account stats, mentions search, event summaries, trending narratives, token news, and trending contract addresses. Perfect for social sentiment analysis and tracking crypto discussions on social media. User profiles are returned as clickable profile links (e.g.,
[username](https://x.com/username)) instead of @username tags.
MCP Tools Pricing: $0.00082 per 1k tokens (output) — same rate as GPT-5-mini. Pricing is based on output tokens with a minimum charge per request.
Example Prompts Using Tools
Here are example prompts you can use with the Nova API to trigger different tools:
Price Prediction Examples
{
"input": "Predict Bitcoin price in 1 hour",
"model": "gpt-5",
"verbosity": "Medium",
"max_tokens": 2000,
"reasoning": false
}
{
"input": "What will Ethereum price be in 1 week? Show me a forecast with chart data",
"model": "gpt-5",
"verbosity": "High",
"max_tokens": 2000,
"reasoning": false
}
{
"input": "Get a 4-hour price forecast for Solana",
"model": "gpt-5-mini",
"verbosity": "Medium",
"max_tokens": 1500,
"reasoning": false
}
{
"input": "Forecast APT price for 1 month with confidence intervals",
"model": "gpt-5",
"verbosity": "High",
"max_tokens": 2000,
"reasoning": false
}
Market Data Examples
{
"input": "Show me trending pools on Aptos",
"model": "gpt-5-mini",
"verbosity": "Medium",
"max_tokens": 1500,
"reasoning": false
}
{
"input": "Find pools for APT/USDC on Aptos network",
"model": "gpt-5-mini",
"verbosity": "Low",
"max_tokens": 1000,
"reasoning": false
}
{
"input": "What's the current Fear & Greed Index?",
"model": "gpt-5-mini",
"verbosity": "Low",
"max_tokens": 500,
"reasoning": false
}
{
"input": "Get historical price data for Ethereum for the last 7 days",
"model": "gpt-5-mini",
"verbosity": "Medium",
"max_tokens": 1500,
"reasoning": false
}
Image Generation Examples
{
"input": "Generate an image of a futuristic city with flying cars",
"model": "gpt-5",
"verbosity": "Medium",
"max_tokens": 1000,
"reasoning": false
}
Document Search Examples
{
"input": "What does my documentation say about API integration?",
"model": "gpt-5",
"verbosity": "High",
"max_tokens": 2000,
"reasoning": false
}
Web Search Examples
{
"input": "Search for the latest news about Aptos blockchain",
"model": "gpt-5",
"verbosity": "Medium",
"max_tokens": 2000,
"reasoning": false
}
Calculator Examples
{
"input": "Calculate the ROI if I invest $1000 at 8% annual return for 5 years",
"model": "gpt-5-mini",
"verbosity": "Low",
"max_tokens": 500,
"reasoning": false
}
Social Intelligence Examples
{
"input": "What tokens are trending on Twitter right now?",
"model": "gpt-5-mini",
"verbosity": "Medium",
"max_tokens": 1500,
"reasoning": false
}
{
"input": "Show me the top mentions of Bitcoin on X in the last 24 hours",
"model": "gpt-5-mini",
"verbosity": "Medium",
"max_tokens": 1500,
"reasoning": false
}
{
"input": "Get smart stats for the Twitter account @elonmusk",
"model": "gpt-5-mini",
"verbosity": "Low",
"max_tokens": 1000,
"reasoning": false
}
{
"input": "What are the trending narratives in crypto right now?",
"model": "gpt-5",
"verbosity": "High",
"max_tokens": 2000,
"reasoning": false
}
{
"input": "Search for mentions of Aptos on Twitter and summarize the sentiment",
"model": "gpt-5",
"verbosity": "Medium",
"max_tokens": 2000,
"reasoning": false
}
Note: The AI will automatically select and use the appropriate tools based on your input. You don't need to specify which tools to use - just describe what you want, and the AI will handle the rest!
Add Knowledge to Your API Key
Nova supports Retrieval-Augmented Generation (RAG) by allowing you to upload documents to your
API key's vector store. These documents are automatically indexed and used to provide
context-aware responses when making AI requests through your API key.
What is Knowledge Base?
Each API key has its own document library (vector store) where you can upload files that contain
information relevant to your application. When you make AI requests using that API key, Nova
will:
- Search through your uploaded documents for relevant information
- Use that information to provide more accurate and context-aware responses
- Combine your knowledge base with the AI's general knowledge
This is perfect for applications that need to answer questions about specific topics, company
documentation, product information, or any domain-specific knowledge.
Uploading Files via Telegram Bot
The easiest way to manage your API key's knowledge base is through the Nova Telegram bot
interface:
-
Access API Key Settings
Open the Nova bot and send /usersettings to access your settings menu.
/usersettings
-
Open API Key Management
Click on "🔑 API Key" in the settings menu to view your API keys.
-
Select Document Library
For each API key, you'll see a "📁 Document Library" button. Click it to
open the document library for that specific API key.
-
Upload Files
Click the "📎 Upload Files" button, then attach one or more documents in
your next message. Supported file types include:
- Text files:
.txt, .md
- Code files:
.py, .js, .ts, .rs,
etc.
- Documents:
.pdf, .docx
- And many other document formats
You can upload multiple files in a single message. After upload, the document library
will automatically refresh to show all your files.
-
Manage Your Files
In the document library, you can:
- View all uploaded files
- Delete individual files by clicking the delete button next to each file
- Clear all files at once using the "🗑️ Clear All Files" button
- Upload more files anytime
Uploading Files via API
You can also manage your knowledge base programmatically using the Nova Gateway API endpoints.
All requests should be made to:
https://gateway.inferenco.com
Upload files to your API key's vector store - Add documents to your
knowledge base.
Headers
| Header |
Type |
Required |
Description |
| Authorization |
string |
Yes |
Bearer token with your API key |
| Content-Type |
string |
Yes |
application/json |
Request Body
| Parameter |
Type |
Required |
Description |
| file_contents |
array[object] |
Yes |
Array of file objects with base64-encoded content |
| file_contents[].filename |
string |
Yes |
Name of the file (e.g., "document.pdf") |
| file_contents[].content |
string |
Yes |
Base64-encoded file content |
Example Request
{
"file_contents": [
{
"filename": "documentation.txt",
"content": "SGVsbG8gV29ybGQ="
}
]
}
Response
{
"vector_store_id": "vs_abc123...",
"message": "Files uploaded successfully to vector store vs_abc123..."
}
List all files in your API key's vector store - View all documents in your
knowledge base.
Headers
| Header |
Type |
Required |
Description |
| Authorization |
string |
Yes |
Bearer token with your API key |
Response
{
"files": [
{
"id": "file_abc123...",
"name": "documentation.txt",
"status": "completed"
}
]
}
Delete a specific file from your vector store - Remove a document from your
knowledge base.
Query Parameters
| Parameter |
Type |
Required |
Description |
| file_id |
string |
Yes |
ID of the file to delete (obtained from list files endpoint) |
Response
{
"message": "File deleted successfully"
}
Delete entire vector store - Remove all files from your API key's knowledge
base.
Headers
| Header |
Type |
Required |
Description |
| Authorization |
string |
Yes |
Bearer token with your API key |
Response
{
"message": "Vector store deleted successfully"
}
How Knowledge Base Works
When you make an AI request using your API key, Nova automatically:
- Searches through your uploaded documents for relevant information
- Retrieves the most relevant sections based on your query
- Includes that information as context in the AI request
- Returns responses that combine your knowledge base with the AI's general knowledge
This enables your application to provide accurate, context-aware answers about your specific
domain, products, services, or documentation without needing to include all that information in
every request.
Best Practices
- Organize your documents: Upload well-structured documents with clear
headings and sections for better retrieval
- Keep files updated: Regularly update your knowledge base as your
information changes
- Use appropriate file formats: Text-based formats (TXT, MD) are often more
reliable than complex formats (PDF, DOCX)
- Test your knowledge base: After uploading, test with sample queries to
ensure the AI can find and use your information
- Monitor file count: While there's no strict limit, very large knowledge
bases may take longer to search
Next Steps
Now that you know how to add knowledge to your API key, proceed to the section to learn how
to make AI requests that will use your knowledge base.
API Templates
Jump-start your integration with prebuilt examples tailored for Nova Gateway. Templates include
environment samples, deployment guides, and best practices so you can ship faster.
Nova Gateway Telegram Bot
A Teloxide-based Rust bot that relays Telegram chats to the Nova Gateway /ai
endpoint and streams responses back to the user.
- Clone the repository and copy
.env.sample to .env.
- Populate
TELEGRAM_BOT_TOKEN and NOVA_API_KEY with your
credentials ().
- Run
cargo run, or use the provided Dockerfile / Cloud Run instructions for
deployment.
- Use the
/reset command in Telegram to clear the conversation history when
needed.
View
template on GitHub
API Documentation
All API requests should be made to the Nova Gateway endpoint. Include your API key in the
Authorization header as a Bearer token.
Authorization: Bearer YOUR_API_KEY
Base URL
The base URL for all API requests is:
https://gateway.inferenco.com
Authentication
Most endpoints require authentication using your API key. Include it in the request header:
Authorization: Bearer nova_your_api_key_here
AI Endpoints
Send AI request - Submit a request to Nova's AI with optional tool calling
and image inputs.
Headers
| Header |
Type |
Required |
Description |
| Authorization |
string |
Yes |
Bearer token with your API key |
| Content-Type |
string |
Yes |
application/json |
Request Body
| Parameter |
Type |
Required |
Description |
| ref_id |
string |
No |
Optional reference ID for conversation tracking |
| input |
string |
Yes |
The user's message or prompt |
| model |
string |
Yes |
AI model to use (e.g., "gpt-5", "gpt-5-mini") |
| verbosity |
string |
Yes |
Response verbosity level ("Low", "Medium", "High") |
| max_tokens |
integer |
Yes |
Maximum tokens in the response |
| reasoning |
boolean |
Yes |
Enable reasoning mode |
| reasoning_params |
object |
No |
Reasoning parameters if reasoning is enabled |
| image_urls |
array[string] |
No |
Array of image URLs to include in the request |
| streaming |
boolean |
No |
Enable streaming response (Server-Sent Events) |
Response
{
"text": "AI response text",
"model": "gpt-5",
"image_data": null,
"tool_calls": [],
"total_tokens": 150,
"web_search": 0,
"file_search": 0,
"image_generation": 0,
"code_interpreter": 0
}
Streaming Response (TypeScript Example)
When streaming: true is set, the API returns a stream of Server-Sent Events
(SSE). Here is an example of how to consume it using TypeScript:
async function streamAIResponse(apiKey: string, prompt: string) {
try {
const response = await fetch('https://gateway.inferenco.com/ai', {
method: 'POST',
headers: {
'Authorization': `Bearer ${apiKey}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'gpt-5',
input: prompt,
max_tokens: 2000,
verbosity: 'Medium',
reasoning: false,
streaming: true
})
});
if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
if (!response.body) throw new Error('Response body is null');
const reader = response.body.getReader();
const decoder = new TextDecoder();
while (true) {
const { done, value } = await reader.read();
if (done) break;
const chunk = decoder.decode(value);
const lines = chunk.split('\n');
for (const line of lines) {
if (line.startsWith('data: ')) {
const data = line.slice(6);
// Handle text content
process.stdout.write(data);
} else if (line.startsWith('event: error')) {
console.error('Stream error:', line);
}
}
}
} catch (error) {
console.error('Streaming failed:', error);
}
}
Clear conversation history - Remove conversation context for a specific
reference ID.
Query Parameters
| Parameter |
Type |
Required |
Description |
| ref_id |
string |
No |
Reference ID to clear. If omitted, clears default conversation. |
Call MCP tools directly - Execute MCP (Model Context Protocol) tools directly without AI. This endpoint allows you to call specific tools by name with custom arguments, bypassing the AI's automatic tool selection. Useful for direct tool execution when you know exactly which tools to call.
Headers
| Header |
Type |
Required |
Description |
| Authorization |
string |
Yes |
Bearer token with your API key |
| Content-Type |
string |
Yes |
application/json |
Request Body
| Parameter |
Type |
Required |
Description |
| tools |
array[object] |
Yes |
Array of tool objects to execute. Each tool object must have name (string) and arguments (object) fields. |
| tools[].name |
string |
Yes |
Name of the MCP tool to call (e.g., "get_trending_pools", "get_token_price", "get_forecast", "social_intelligence") |
| tools[].arguments |
object |
Yes |
JSON object containing the arguments for the tool. Structure depends on the specific tool being called. |
Example Request
Call a single tool:
curl -X POST https://gateway.inferenco.com/mcp-tools \
-H "Authorization: Bearer nova_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"tools": [
{
"name": "get_token_price",
"arguments": {
"symbol": "BTC",
"network": "aptos"
}
}
]
}'
Call multiple tools:
curl -X POST https://gateway.inferenco.com/mcp-tools \
-H "Authorization: Bearer nova_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"tools": [
{
"name": "get_trending_pools",
"arguments": {
"network": "aptos",
"limit": 10
}
},
{
"name": "get_token_price",
"arguments": {
"symbol": "APT",
"network": "aptos"
}
}
]
}'
Example with forecast tool:
curl -X POST https://gateway.inferenco.com/mcp-tools \
-H "Authorization: Bearer nova_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"tools": [
{
"name": "get_forecast",
"arguments": {
"asset_id": "bitcoin",
"forecast_type": "short",
"duration": "one_hour",
"vs_currency": "usd",
"include_chart": false
}
}
]
}'
Note: For get_forecast, use asset_id (CoinGecko format like "bitcoin", "ethereum", "stohn-coin") not ticker symbols. forecast_type should be "short" or "long". duration for short-term: "fifteen_minutes", "one_hour", "four_hours". For long-term: "one_day", "three_days", "one_week", "one_month", "three_months", "six_months", "one_year", "four_years".
Response
Returns an array of tool execution results. Each result contains the tool's response content.
[
{
"content": [
{
"type": "text",
"text": "Tool execution result here..."
}
],
"isError": false
}
]
Available MCP Tools
The following MCP tools are available (same tools that can be called automatically via the /ai endpoint):
Market Data Tools
- get_trending_pools - Get trending DEX pools on various networks
- search_pools - Search for specific DEX pools
- get_new_pools - Get newly created pools
- get_token_price - Get token price from BitcoinTry exchange
- get_fear_and_greed_index - Get crypto market sentiment index
- get_coindesk_history - Get historical crypto price data
- dexscreener_api - Access Dexscreener DEX data
AI & Prediction Tools
- get_forecast - Get AI-powered price predictions
- social_intelligence - Get social media insights and sentiment analysis
Utility Tools
- calculate_expression - Evaluate mathematical expressions
- get_current_time - Get current time for any timezone
Tool Examples
get_trending_pools
{
"tools": [{
"name": "get_trending_pools",
"arguments": {
"network": "aptos",
"limit": 10,
"page": 1,
"duration": "24h"
}
}]
}
search_pools
{
"tools": [{
"name": "search_pools",
"arguments": {
"network": "aptos",
"token_symbol": "APT",
"limit": 5
}
}]
}
get_token_price
{
"tools": [{
"name": "get_token_price",
"arguments": {
"symbol": "BTC"
}
}]
}
get_forecast
Important: Use CoinGecko asset IDs (e.g., "bitcoin", "ethereum") not ticker symbols. Duration values: short-term: "fifteen_minutes", "one_hour", "four_hours"; long-term: "one_day", "three_days", "one_week", "one_month", "three_months", "six_months", "one_year", "four_years".
{
"tools": [{
"name": "get_forecast",
"arguments": {
"asset_id": "bitcoin",
"forecast_type": "short",
"duration": "one_hour",
"vs_currency": "usd",
"include_chart": false
}
}]
}
social_intelligence
{
"tools": [{
"name": "social_intelligence",
"arguments": {
"operation": "trending_tokens",
"time_period": 24,
"limit": 10,
"min_mentions": 5
}
}]
}
Other operations: "smart_stats" (requires account), "top_mentions" (requires ticker), "mentions_search" (requires keywords), "event_summary", "trending_narratives", "token_news", "trending_contracts_twitter", "trending_contracts_telegram".
Note: User profiles in responses are returned as clickable profile links (e.g., [username](https://x.com/username)) instead of @username tags to avoid confusion in other apps.
get_fear_and_greed_index
{
"tools": [{
"name": "get_fear_and_greed_index",
"arguments": {}
}]
}
calculate_expression
{
"tools": [{
"name": "calculate_expression",
"arguments": {
"expression": "1000 * (1 + 0.08) ^ 5"
}
}]
}
get_current_time
{
"tools": [{
"name": "get_current_time",
"arguments": {
"timezone": "UTC"
}
}]
}
get_coindesk_history
{
"tools": [{
"name": "get_coindesk_history",
"arguments": {
"symbol": "BTC",
"start_date": "2024-01-01",
"end_date": "2024-01-31"
}
}]
}
dexscreener_api
{
"tools": [{
"name": "dexscreener_api",
"arguments": {
"operation": "search",
"query": "APT/USDC"
}
}]
}
Usage: Use this endpoint when you need to call specific tools directly without AI interpretation. The AI endpoint (/ai) automatically selects and calls appropriate tools based on your prompt, while this endpoint gives you direct control over tool execution.
Error Responses
All endpoints may return standard HTTP error codes:
- 400 Bad Request - Invalid request parameters
- 401 Unauthorized - Missing or invalid API key
- 403 Forbidden - Insufficient permissions
- 404 Not Found - Resource not found
- 500 Internal Server Error - Server error
Error responses follow this format:
{
"message": "Error description",
"status": 401
}
Rate Limiting
API requests are subject to rate limiting based on your account tier and usage patterns. If you
exceed the rate limit, you'll receive a 429 Too Many Requests response.
Support
For API support, questions, or issues, contact the Nova team through our Telegram group or visit the
Nova documentation.
