ASCN.AI API Documentation

Written By Team ASCN.AI

Last updated 3 months ago

✨ Introduction

Welcome to the ASCN.AI Assistant API! Our mission is to provide programmatic access to institutional-grade, real-time crypto intelligence. The API transforms complex on-chain data from over 20 blockchains, social media, and news sources into actionable insights, accessible through simple, natural language queries.

Whether you're building sophisticated trading bots, data-rich portfolio trackers, or AI-powered community management tools, our API delivers the speed, accuracy, and depth you need to stay ahead. Go from raw data to actionable insights in seconds.

🚀 Getting Started

This section provides everything you need to start using the ASCN.AI API.

Make Your First API Call

Step 1: Get Your API Key

There are two ways to obtain a Free API key. The quick option is to request directly to Support in Telegram

The more useful option is to register on the website, review all available subscription plans, and select the Free plan. By doing so, you gain access to detailed logs of your requests, visibility into how many “credits” each request consumes, and the ability to upgrade instantly to any paid plan when needed.

Please note that the quick method of receiving a Free key through Telegram may not be guaranteed in the future.

Step 2: Run the cURL Command

Open your terminal and paste the following command. Replace YOUR_API_KEY with the key you just copied.

curl --request POST \
     --url https://b2b.api.arbitragescanner.io/api/ai-assistant/v1/invoke_assistant \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' \
     --data '{
         "message": "Please perform an analysis of the coin PEPE, including a chart, market data, and technical analysis"
     }'

Step 3: See the Response

You will receive a JSON response containing a detailed, real-time analysis of the PEPE coin. Congratulations, you've successfully queried the ASCN.AI Assistant!

🔓 Authentication

All requests to the ASCN.AI API must be authenticated. We use a single API key for authentication.

Pass your API key in the X-API-Key header of every request.

X-API-Key: YOUR_API_KEY

Important: Your API key is a secret! Do not share it or expose it in any client-side code (browsers, mobile apps ). All API requests should be made from a secure server environment.

🌐 API Structure & Base URL

All interactions with the ASCN.AI API occur via HTTPS requests to our base URL.

Base URL: https://b2b.api.arbitragescanner.io/api/ai-assistant/v1/

The API is organized around REST principles. Our endpoints use standard HTTP methods (GET, POST ) and return predictable JSON-formatted responses.

🟢 Understanding Responses and Handling Errors

The API uses standard HTTP status codes to indicate the success or failure of a request.

Status Code	Meaning	Description
`200`	OK	The request was successful.
`400`	Bad Request	The request was malformed or missing required parameters.
`401`	Unauthorized	Your API key is incorrect or missing.
`403`	Forbidden	Your API key does not have permission for this action.
`429`	Too Many Requests	You have exceeded your rate limit.
`500`	Internal Server Error	We had a problem with our server. Please try again later.

A successful response will contain the requested data in the content field. An error response will include a detail field with more information about the error.

Example Error Response:

{ "detail": "Authentication credentials were not provided." }

🧠 Features

The ASCN.AI Assistant unlocks a wide range of crypto intelligence through natural language prompts. This section details the core features you can access.

Real-time Market Data

Access up-to-the-second market data from over 20 blockchains. Get price charts, volume, capitalization, and technical analysis for any token

What it helps to answer:

•What is the current price and market cap of a token?

•What are the key support and resistance levels?

•How has the token performed over the last 24 hours?

Token Analysis

Go deep on any token with our Token . Analyze token flows (CEX), holder balances (top addresses, whales, funds), top transfers, and recent buyer/seller activity.

What it helps to answer:

•Who are the top holders of this token?

•Is smart money buying or selling?

•What are the largest recent transfers for this token?

On-chain Analysis

Monitor DeFi positions, track DEX trades, and identify profitable wallets across 20+ blockchains, including EVM chains and Solana. See historical token holdings and DCA activities.

What it helps to answer:

•What are the recent DEX trades for a specific token?"

•Which wallets have been most profitable trading this coin?

•What are the active DeFi positions for a given wallet address?

Perp Trades (DEX)

Gain real-time insights into the DEX futures market. Track top traders on platforms like Hyperliquid, analyze their strategies, and see their open positions, leverage, P/L, and trade history.

What it helps to answer:

•Who are the most profitable traders on SOL and ETH right now?

•What are their entry/exit patterns and win rates?

•Can I backtest a trading strategy based on their historical performance?

Sentiment Analysis

Understand the market mood with our sentiment analysis engine. We analyze Telegram communities and news media to give you a clear picture of positive and negative sentiment for any coin.

What it helps to answer:

•What is the current sentiment around a specific token on Telegram?

•Is the news coverage for a project positive or negative?

•What are the key topics being discussed in the community?

Web Search

Our AI assistant can perform advanced web searches to gather public information about projects, teams, and market trends, combining it with on-chain data for a complete 360-degree view.

What it helps to answer:

•What is the latest news about a specific crypto project?

•Who are the founders and key team members?

•What are the tokenomics and roadmap for this project?

📜 Use Case Templates

Explore these templates to see how you can leverage the ASCN.AI Assistant API to build powerful crypto applications. Each template includes a description of the use case and the key features utilized.

Use Case	Description	Key Features Used
Automated Trading Bot	A bot that executes trades based on real-time market data, on-chain events, and sentiment analysis powered by AI.	`Real-time Market Data`, `On-chain Analysis`, `Sentiment Analysis,` `Perp Trades`
Portfolio Tracker	An application that provides a comprehensive overview of a user's crypto assets, including DeFi positions and historical performance with AI-powered insights.	`On-chain Analysis`, `Wallet Portfolio Tracking`
Sentiment Dashboard	A dashboard that visualizes market sentiment for specific coins or the market as a whole, based on social media and news analysis.	`Sentiment Analysis`
Community Management	An AI assistant for Telegram or Discord that answers user questions about the market, specific tokens, or project updates.	`Web Search`, `Real-time Market Data`
Due Diligence Tool	A tool that provides in-depth analysis of new tokens, including holder distribution, smart money flows, and top transfers, powered by AI insights.	`Token Analysis`, `Holder Balances`
Token Research Assistant	An AI-powered research tool that combines on-chain data, market metrics, sentiment, and web information to provide comprehensive token analysis.	`Token Analysis`, `Web Search`, `Sentiment Analysis`, `Real-time Market Data`

📚 API Reference

This section provides a detailed reference for all available API endpoints, organized by feature. This is the core of the API, allowing you to interact with the AI assistant using natural language.

Invoke Assistant

POST /invoke_assistant

This endpoint sends a message to the AI assistant and returns a complete, structured analysis in a single response. It is best for scenarios where a complete response is needed before proceeding.

What it helps to answer:

•Get a full market overview for a specific token.

•Perform deep on-chain analysis in one go.

•Analyze historical data and sentiment for a project.

Request Body

Parameter	Type	Description
`message`	string	Required. The natural language message or question for the AI assistant.
`chat_id`	uuid	Optional. The ID of an existing chat to continue a conversation. If not provided, a new chat is created.
`model`	string	Optional. The AI model to use. Defaults to ascn_v1.2.

Example Request

{ "message": "Provide me deep onchain and market analytics for DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK)", "model": "ascn_v1.2" }

Invoke Assistant Stream

POST /invoke_assistant_stream

For real-time applications, this endpoint establishes a Server-Sent Events (SSE) stream to deliver parts of the response as they are generated. This is ideal for creating interactive, responsive user experiences.

What it helps to answer:

•How can I show analysis progress to my users in real time?

•How do I build a live-updating dashboard?

•How can I create a chatbot-like experience?

Stream Events

The stream sends a sequence of events, allowing you to update your UI progressively.

Event	Data	Description
`chat`	`{"chat_id": "...", "chat_title": "..."}`	Sent at the beginning of the stream to provide the chat context.
`pending_tool_call`	`{"call_id": "...", "title": {"en": "Analyzing smart money trades.."}}`	Sent when a specific internal tool is called to gather data.
`finished_tool_call`	`{"call_id": "..."}`	Sent when the internal tool has finished its execution.
`message_start`	`{"t": "..."} (multiple times)`	Streams the message content as it's being generated.
`message_end`	`{"message_id": "..."}`	Indicates that the current message has finished.
`finish`	`null`	Marks the end of the entire stream session.

📌 About

This section provides important information about API usage, pricing, and our supported blockchains.

🔴 Rate Limits

To ensure a high-quality experience for all users, the ASCN.AI API enforces rate limits. Our rate limits are designed to be generous and scale with your needs.

•Free Tier: 60 requests per minute

•Pro Tier: 300 requests per minute

•Enterprise: Custom rate limits

If you exceed your rate limit, you will receive an HTTP 429 Too Many Requests error. We recommend implementing a retry mechanism with exponential backoff in your application..

For detailed information on our pricing plans and credit system, please visit our Pricing Page .

⛓️ Chain Coverage

Our platform provides real-time data and analytics across more than 20 blockchains, and we are constantly adding more. Our current coverage includes:

Category	Supported Chains
EVM Chains	Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche, Base, and more.
Solana	Full support for Solana on-chain data, DEX trades, and DeFi analysis.
Other	We also support various other popular blockchains.

For a complete and up-to-date list of our supported chains, please refer to our platform dashboard or contact our support team.

🙋 Frequently Asked Questions

How do I get started?

Follow the Getting Started guide above. You'll need to sign up for an account, get your API key, and make your first API call.

What programming languages are supported?

The ASCN.AI API is language-agnostic. You can use any programming language that supports HTTP requests. We provide code examples in cURL, Python, JavaScript, and more.

Can I use the API for commercial purposes?

Yes! Our API is designed for both personal and commercial use. Please review our Terms of Service for more details.

How accurate is the data?

We source our data directly from blockchain nodes, major exchanges, and verified social media channels. Our data is processed in real-time and is among the most accurate in the industry.

What is the difference between invoke_assistant and invoke_assistant_stream?

invoke_assistant returns a complete response in one go, while invoke_assistant_stream uses Server-Sent Events (SSE) to stream the response as it's being generated. Use streaming for interactive, real-time applications.

Do you offer support?

Yes! We offer support via email (info@ascn.ai), Telegram , and our community forum. Enterprise customers receive priority support with dedicated account managers.

🔗 Useful Links

•Website: https://ascn.ai

•Platform Dashboard: https://ascn.ai/ai

•Pricing: https://arbitragescanner.io/crypto-api

🚀 Start Building Today

Ready to unlock the power of real-time crypto intelligence? Sign up for your free API key and start building the future of crypto applications today.

Last Updated: November 2025

API Version: v1.2

Documentation Version: 1.0