Frequently Asked Questions

Common questions about Nexgent setup, usage, and troubleshooting.

General

What is the Nexgent AI open-source trading platform?

The Nexgent AI open-source trading platform is a self-hosted trading automation framework for Solana. It allows you to deploy your own instance, create trading agents, and execute trades with ultra-low latency.

Is Nexgent free?

Yes. Nexgent is open-source and free to use. You only pay for:

• Your own infrastructure (hosting, database, Redis)
• Solana network fees for transactions
• Optional: Jupiter API key for higher limits

Do I need coding skills to use Nexgent?

Basic technical knowledge is required for:

• Deploying the application (Docker or manual setup)
• Configuring environment variables
• Understanding trading concepts

The dashboard itself is user-friendly and doesn't require coding.

Is my money safe?

Nexgent uses a non-custodial model:

• Private keys stay on your infrastructure
• Keys are only held in memory, never stored in database
• You control your own funds

However, trading cryptocurrencies carries inherent risk. Only trade with funds you can afford to lose.

Setup & Installation

What are the minimum requirements?

Plus PostgreSQL and Redis (can be hosted separately). Node.js 18+ required.

Do I need a Jupiter API key?

Yes, a Jupiter API key is required for swap execution. The good news is it's free to obtain.

Get one at jup.ag (opens in a new tab) and add it to your environment variables.

Agents & Trading

What's the difference between simulation and live mode?

Can one wallet be used by multiple agents?

Yes, but not recommended. Each agent should have its own dedicated wallet to:

• Avoid balance conflicts
• Enable independent tracking
• Simplify accounting

How do I fund my trading wallet?

1. Create a new wallet in Phantom/Solflare
2. Copy the public address
3. Send SOL from your main wallet or exchange
4. Export the private key and add to .env

What happens if a trade fails?

• Position is not created
• Agent balance remains unchanged
• Error is logged
• Idempotency key prevents retry duplicates

Can I manually close positions?

Yes, through the dashboard or API. Manual closes bypass stop loss and DCA rules.

What's the minimum trade size?

Configurable per agent via minimumAgentBalance. Default is 0.5 SOL minimum balance required to trade.

Signals

How do I send signals to Nexgent?

Via the REST API:

curl -X POST https://your-instance.com/api/v1/signals \
  -H "X-API-Key: nex_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "tokenAddress": "So11111111111111111111111111111111111111112",
    "action": "buy",
    "score": 4
  }'

What signal sources are supported?

Nexgent accepts signals from any source via API:

• Custom scripts
• Trading bots
• Webhooks from external services
• Manual input via dashboard

What does the signal score mean?

Score (1-5) indicates signal strength/confidence. You can configure agents to only act on signals above a certain score threshold.

Can I filter signals by token?

Yes, agents can be configured with allowlists or blocklists to filter which tokens they trade.

Stop Loss & DCA

How does stop loss work?

When a position's value drops below the configured percentage (e.g., -32%), an automatic sell is triggered.

Modes:

• Fixed: Always -32% from purchase price
• Trailing: Adjusts upward as price rises

What's the difference between fixed and trailing stop loss?

How does DCA work?

When a position drops to a configured level (e.g., -10%), an additional buy is triggered to lower the average cost.

Example DCA levels:

• Level 1: -10% drop → Buy 50% more
• Level 2: -25% drop → Buy 100% more
• Level 3: -40% drop → Buy 150% more

Can I disable stop loss or DCA?

Yes, both are optional and can be enabled/disabled per agent.

Performance & Scaling

How fast is signal processing?

• Signal to execution: < 500ms typical
• Stop loss evaluation: < 1ms
• WebSocket broadcast: < 10ms

How many agents can I run?

Depends on your infrastructure. A single instance can handle:

• 50+ agents comfortably
• 100+ with adequate resources
• More with horizontal scaling

Does Nexgent support multiple instances?

The current architecture is designed for single-instance deployment. Redis is used for coordination, but full horizontal scaling requires additional configuration.

Security

Where are my private keys stored?

Private keys are:

• Loaded from environment variables at startup
• Stored only in memory (never database)
• Never logged or transmitted

How do I rotate API keys?

1. Generate a new API key via dashboard
2. Update your integrations with the new key
3. Delete the old API key

What if my server is compromised?

1. Immediately transfer funds to a new wallet
2. Revoke all API keys
3. Rotate all secrets (JWT, database passwords)
4. Review access logs

See Security Overview for more details.

Troubleshooting

Why isn't my agent trading?

Common causes:

1. Agent not active - Check status in dashboard
2. Insufficient balance - Below minimum threshold
3. Already has position - One position per token per agent
4. Signal filtered - Check score threshold and filters

Why is my balance showing 0?

1. Check wallet has funds on-chain
2. Verify wallet address is correct in .env
3. Check RPC connection is working
4. Try cache reset: pnpm --filter backend cache:reset

Trades are failing with "slippage" errors

Increase slippage tolerance or reduce trade size. Low-liquidity tokens require higher slippage.

See Troubleshooting for more solutions.

Still Have Questions?

• Check Troubleshooting for common issues
• Open a GitHub Discussion (opens in a new tab)
• Review GitHub Issues (opens in a new tab)