SENTINEL API (Data Endpoints)

API endpoints for providing data-driven intelligence that powers the agents.

This allows any connected agent or application to tap into real-time cryptocurrency analytics such as trending token sentiment or fundamental token statistics with a simple API call. By centralizing these heavy data tasks, the API frees the AI agents to focus on user interaction and decision-making, ensuring they always have up-to-date information at their fingertips.

Key API Endpoints

The SENTINEL API offers a variety of endpoints, each designed for a specific piece of functionality. Some of the core endpoints include:

GET /api/ping – Connectivity test to quickly check if the API service is reachable (returns a simple “pong” response).
GET /api/version – Retrieves the current API version, environment, and build info (useful for debugging and ensuring compatibility).
POST /api/keys – Generates a new API key for authentication. This allows developers to securely access the protected endpoints after obtaining a key.
POST /api/v1/sentiment – Performs a sentiment analysis on a given token or cashtag using social signals. It returns insights about market sentiment, hype levels, and social media trends for that asset.
POST /api/v1/token – Provides detailed token analytics including price, market cap, holder stats, security insights (e.g. sniper bot activity), and social metrics for a specific token address. This is a one-stop endpoint for fundamental and technical data on a cryptocurrency token.
GET /api/status – Returns the health status of various services in the ecosystem (sentiment engine, token analytics engine, database connectivity, etc.), helping monitor if all systems are operational.

These endpoints are the building blocks for higher-level features. For instance, the mobile and desktop agents call the sentiment and token endpoints to inform their market analysis dialogues, and they may use the status endpoint to adapt if a service is down. The API is truly an important part of our ecosystem’s intelligence enabling all other components to function cohesively.

How It benefits the ecosystem

Both the KATZ! Telegram Agent and the upcoming O.P.E.R.A.T.O.R agent can integrate this API to make informed decisions and perform tasks. When you ask the mobile agent for the outlook on a particular cryptocurrency, sentiment analysis route is invoked behind the scenes to provide a real-time answer.

Likewise, if O.P.E.R.A.T.O.R needs to execute a complex trading strategy or automation, it will first fetch data (prices, social sentiment, etc.) via the API to decide on the best course of action. This means that improvements or new endpoints in the API immediately benefit all frontend agents. The ecosystem’s design ensures a single source of truth for analytics – the API – which maintains consistency between what the mobile chat-bot tells you and what the desktop assistant performs.

API Access & Testing

Dexter’s AI Lab provides multiple ways for developers and power-users to access and experiment with the SENTINEL API. The API is hosted at a public endpoint (currently https://dail-agent.ngrok.app, which may transition to a permanent URL) and offers a web dashboard interface for quick previews of data.

Developers can obtain an API key by calling the /api/keys endpoint (or via the dashboard) to authorize requests. For testing and integration, Dexter’s team has provided a detailed guide including instructions for using API clients like Postman or Hoppscotch to try out each endpoint. In fact, Hoppscotch is recommended for its ease of use in quickly sending requests to the API. Using these tools, one can easily ping the service, check versions, generate keys, and invoke sentiment or token analyses with custom parameters. The figure below demonstrates an example of testing the sentiment analysis endpoint:

The API responded with aggregated sentiment scores and related data – providing an immediate read on public mood and discussions around that token. Such responses illustrate how the SENTINEL API distills complex social data into actionable insights, which the AI agents can then convey to the user in plain language.

The image above shows a snippet of the JSON output, including details like the token’s latest price and percentage change, market capitalization, liquidity pool info, security audit flags, and social buzz indicators. This rich data enables the AI agents to answer complex questions (e.g. “Is this token safe to invest in?” or “What’s the current trading volume and holder distribution?”) with factual, up-to-date information. By testing these endpoints directly, developers can verify the data and see how the AI might use it in context.

API Access Guide and Resources

To get started with the API, users can:

Visit the API Dashboard: A web dashboard (available via our official site) provides a user-friendly way to inspect endpoints and test queries in real-time. It’s a great starting point to see what data is available, without writing any code.
Read the Developer Guide: We published a Medium Guide months ago - a quick developer guide on integrating and testing the API. It walks through each endpoint with examples, showing how to make requests and interpret responses. It’s an invaluable resource for understanding features like SentimentScrub and TokenScrub (the internal codenames for the sentiment and token analysis services).
Obtain API Keys: Whether through the dashboard UI or via the API itself, generate an API key to unlock the full capabilities of the protected endpoints. The guide provides step-by-step instructions (e.g. using a Hoppscotch or Postman call to /api/keys). With a key in hand, you can authenticate your requests by adding an X-API-Key header.

This is the foundation of our intelligent data API which will cater for Crypto, Web2 and any other events modern digital consumers monitor, like stocks, sporting events, tickets, etc.

PreviousO.P.E.R.A.T.O.R NextEditor

Last updated 22 days ago