Glossary
Quick reference for terms used throughout Nexgent documentation.
A
Agent
An automated trading entity that monitors signals, evaluates eligibility, and executes trades based on its configuration. Each agent has its own wallet, trading config, and can operate in simulation or live mode.
API Key
A programmatic authentication credential (nex_xxxxx) used to access the Nexgent API. Supports scoped permissions (read, write, signals).
Average Price
The weighted average purchase price of a token position, recalculated after each DCA buy to track true cost basis.
B
Balance (Agent)
The SOL balance available for an agent to trade with. In simulation mode, this is virtual. In live mode, this reflects actual wallet balance.
BullMQ
A Redis-based job queue library used for processing background tasks like stale trade cleanup and position monitoring.
C
Cache Warming
The process of pre-loading frequently accessed data (agent configs, balances, positions) into Redis at startup to reduce database queries.
Commitment Level
Solana RPC parameter that determines transaction confirmation requirements. Nexgent uses confirmed for balance of speed and reliability.
D
DCA (Dollar Cost Averaging)
A trading strategy that buys more of an asset when its price drops. Nexgent supports configurable DCA levels that trigger additional purchases at specified price drops.
DCA Level
A configured price drop threshold that triggers an additional buy. Example: Level 1 at -10% drop buys 50% more tokens.
DexScreener
An external API used as an alternative price feed provider. Provides token prices, liquidity data, and trading pair information.
E
Eligibility
The evaluation process that determines if an agent should execute a trade for a given signal. Checks balance, existing positions, filters, and configuration.
EventEmitter
Node.js event system used internally for decoupling services. Events like signal_created and position_created trigger downstream actions.
F
Fixed Stop Loss
A stop loss mode where the trigger percentage remains constant regardless of price gains. Example: Always sell at -32% from purchase price.
H
Hermes
Pyth Network's price streaming service that provides real-time SOL/USD prices via Server-Sent Events (SSE).
I
Idempotency
Ensuring an operation produces the same result regardless of how many times it's executed. Used to prevent duplicate trades from the same signal.
Idempotency Key
A unique identifier (signal ID + agent ID) stored in Redis to prevent duplicate trade execution.
J
Jupiter Aggregator
Solana's leading DEX aggregator used by Nexgent for token swaps. Provides best-price routing across multiple liquidity sources.
JWT (JSON Web Token)
Authentication tokens used for dashboard sessions. Includes access tokens (15m) and refresh tokens (24h).
K
Keypair
A Solana wallet's public/private key pair. The private key (secret key) signs transactions; the public key is the wallet address.
L
Lamports
The smallest unit of SOL. 1 SOL = 1,000,000,000 lamports (10^9).
Liquidity
The amount of assets available for trading in a token's liquidity pool. Low liquidity increases slippage risk.
Live Mode
Trading mode where agents execute real on-chain transactions with actual funds.
M
Mint Address
The unique Solana address identifying a specific SPL token. Used to reference tokens in swaps and price lookups.
Monorepo
A repository containing multiple related packages. Nexgent uses pnpm workspaces with backend, frontend, and shared packages.
N
Network Fees
Transaction fees on Solana, paid in SOL. Covers prioritization and resource usage. Account storage has separate "rent" costs.
Nexgent
Open-source, self-hosted trading automation framework for Solana.
Non-Custodial
A security model where private keys remain under user control and are never stored by the application (only in memory during runtime).
P
Position
A record of tokens held by an agent, including purchase details, current value, and P&L tracking.
Price Feed
A service providing real-time token prices. Nexgent supports Jupiter and DexScreener as price providers.
Prisma
TypeScript ORM used for database access. Provides type-safe queries and handles migrations.
Pyth Network
Decentralized oracle network providing the SOL/USD price feed used to convert token values.
Q
Quote
A price estimate from Jupiter for a potential swap, including expected output amount and transaction data.
R
Redis (ioredis)
In-memory data store used for caching, token storage, and distributed locking.
Refresh Token
A long-lived token (24h) used to obtain new access tokens without re-authenticating.
RPC (Remote Procedure Call)
The interface for communicating with Solana nodes. Nexgent uses RPC for balance queries and transaction submission.
S
Signal
A trading recommendation containing a token address, action (buy/sell), and optional metadata. Signals trigger agent eligibility evaluation.
Simulation Mode
Trading mode where agents simulate trades without executing on-chain transactions. Uses virtual balances for testing.
Slippage
The difference between expected and actual execution price. Higher for low-liquidity tokens.
SOL
Solana's native cryptocurrency, used for transaction fees and as the base trading pair.
SPL Token
Solana Program Library token - the standard for fungible tokens on Solana (equivalent to ERC-20 on Ethereum).
SSE (Server-Sent Events)
A protocol for streaming real-time updates from server to client. Used by Pyth for price feeds.
Stale Trade
A position that hasn't changed for a configured period. Can be automatically closed based on agent settings.
Stop Loss
An automatic sell trigger when a position's value drops below a threshold, limiting losses.
T
Token Address
See Mint Address.
Trailing Stop Loss
A stop loss mode where the trigger percentage adjusts based on gains. As price rises, the stop loss "trails" upward to lock in profits.
Transaction
An on-chain operation on Solana. Swaps are executed as versioned transactions signed by the wallet keypair.
TTL (Time To Live)
Expiration time for cached data. After TTL expires, data is automatically removed from Redis.
U
Ultra API
Jupiter's high-performance swap API that requires an API key. Provides faster execution than the public API.
V
Versioned Transaction
Solana's modern transaction format supporting address lookup tables for more complex transactions.
W
Wallet
A Solana account identified by a public key (address) and controlled by a private key. Agents are assigned wallets for trading.
WebSocket
A protocol for real-time bidirectional communication. Nexgent uses WebSocket to push live updates to the dashboard.
Write-Through Cache
A caching pattern where data is written to both the cache and database simultaneously, ensuring consistency.
Z
Zod
TypeScript-first schema validation library used for input validation across Nexgent.