Getting Started

Welcome to the Nexgent Public API! The API is designed to help you programmatically interact with Nexgent's platform and services.

This guide will walk you through the basics — authentication, rate limits, available API endpoints, and where to find additional platform documentation.


Authentication

All API requests require authentication using an API key.

Include your API key in the Authorization header using the Bearer schema:

Authorization: Bearer {api_key}

You can generate and manage your API keys in the Integrations section of the Nexgent Portal under Agent Configuration.

  • Each user can create up to 10 active API keys.
  • API keys are secret — ensure they are stored securely.
  • Quotas are linked to the user, not individual API keys — all API keys for a user share the same quota and rate limits.

Learn more about API authentication →


Rate Limits and Quotas

To ensure fair usage and consistent performance for all developers, Nexgent applies two types of limits:

Limit TypeLimitScopeReset Interval
Monthly Quota1,000 requestsPer user (API key)Monthly (1st, 00:00 UTC)
Per-Minute Rate30 requests/minutePer user (API key)Every rolling minute
  • Quotas reset monthly at 00:00 UTC on the first day of each month.
  • Rate limits are enforced in rolling windows of 1 minute.
  • If you exceed a limit, a 429 Too Many Requests error will be returned.

Learn more about rate limits →


Base URL

All API requests are made against the following base URL:

https://api.nexgent.ai/

Available API Endpoints

Platform

MethodEndpointDescription
GET/v1/healthHealth check for platform availability.

Agents

MethodEndpointDescription
GET/v1/agents/Retrieve all agents for the authenticated user.
GET/v1/agents/{agentId}Retrieve agent details by agent ID.
GET/v1/agents/{agentId}/walletRetrieve the wallet balance for an agent.
GET/v1/agents/{agentId}/live-tradesRetrieve live trades for an agent.
GET/v1/agents/{agentId}/historical-tradesRetrieve historical trades for an agent.

Prices

MethodEndpointDescription
GET/v1/price/solRetrieve the latest SOL token price.
GET/v1/price/{tokenAddress}Retrieve the latest token price by address.

Signals

MethodEndpointDescription
GET/v1/signals/latestRetrieve the latest trading signals.
GET/v1/signals/{signalId}Retrieve a specific trading signal by ID.

Whale Trades

MethodEndpointDescription
GET/v1/whale-trades/latestRetrieve the latest whale trade transactions.
GET/v1/whale-trades/{tokenAddress}Retrieve whale trades filtered by token address.

Example API Request

Here’s an example of how to make an authenticated request to list all agents:

curl https://api.nexgent.ai/v1/agents/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Support

For help with API integration, authentication issues, or quota limits, please contact Nexgent support.