Trading Signals

Send trading signals to trigger automated trades across eligible agents.

Endpoints Overview

Method	Endpoint	Description	Auth
`POST`	`/api/v1/trading-signals`	Create a signal	API Key
`GET`	`/api/v1/trading-signals`	List signals	JWT
`GET`	`/api/v1/trading-signals/export`	Export as CSV	JWT
`GET`	`/api/v1/trading-signals/:id`	Get a signal	JWT
`PUT`	`/api/v1/trading-signals/:id`	Update a signal	JWT
`DELETE`	`/api/v1/trading-signals/:id`	Delete a signal	JWT
`DELETE`	`/api/v1/trading-signals/all`	Delete all signals	JWT

⚠️

Important: The POST endpoint requires API Key authentication with signals scope. All other endpoints require JWT authentication.

Create Signal

Send a trading signal. This is the primary endpoint for external integrations.

POST /api/v1/trading-signals

Authentication: API Key with signals scope

Rate Limit: 120 requests per minute per API key

Request

{
  "tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "symbol": "BONK",
  "signalType": "buy",
  "signalStrength": 4,
  "activationReason": "Volume spike detected",
  "source": "my-trading-bot"
}

Field	Type	Required	Description
`tokenAddress`	string	Yes	Solana token mint address (max 255 chars)
`symbol`	string	No	Token ticker symbol (max 50 chars)
`signalType`	string	Yes	Signal type identifier (max 50 chars)
`signalStrength`	integer	Yes	Strength 1-5 (5 = strongest)
`activationReason`	string	No	Human-readable reason
`source`	string	No	Signal source identifier (max 100 chars)

Response

Success (201)

{
  "id": 12345,
  "createdAt": "2025-01-20T10:30:00.000Z",
  "updatedAt": "2025-01-20T10:30:00.000Z",
  "tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "symbol": "BONK",
  "signalType": "buy",
  "activationReason": "Volume spike detected",
  "signalStrength": 4,
  "source": "my-trading-bot"
}

Signal Processing

When a signal is created:

Event Emitted - Signal triggers immediate processing
Agent Eligibility - Each agent is checked for eligibility
Trade Execution - Eligible agents with automation enabled execute trades
Position Created - Successful trades create open positions

Example

curl -X POST https://your-instance.com/api/v1/trading-signals \
  -H "X-API-Key: nex_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "symbol": "BONK",
    "signalType": "buy",
    "signalStrength": 4,
    "source": "my-bot"
  }'

List Signals

Get signals with optional filtering.

GET /api/v1/trading-signals

Authentication: JWT

Query Parameters

Parameter	Type	Required	Description
`tokenAddress`	string	No	Filter by token
`signalType`	string	No	Filter by type
`startDate`	ISO 8601	No	Filter from date
`endDate`	ISO 8601	No	Filter to date
`limit`	integer	No	Max results (default: 100, max: 1000)
`offset`	integer	No	Skip results (default: 0)

Response

Success (200)

[
  {
    "id": 12345,
    "createdAt": "2025-01-20T10:30:00.000Z",
    "updatedAt": "2025-01-20T10:30:00.000Z",
    "tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "symbol": "BONK",
    "signalType": "buy",
    "activationReason": "Volume spike detected",
    "signalStrength": 4,
    "source": "my-trading-bot"
  }
]

Returns signals ordered by createdAt descending.

Example

# Recent signals
curl -X GET "https://your-instance.com/api/v1/trading-signals?limit=50" \
  -H "Authorization: Bearer <access_token>"
 
# Signals for a specific token
curl -X GET "https://your-instance.com/api/v1/trading-signals?tokenAddress=DezX..." \
  -H "Authorization: Bearer <access_token>"

Export Signals

Export signals as CSV.

GET /api/v1/trading-signals/export

Authentication: JWT

Query Parameters

Same as List Signals.

Response

Returns CSV file.

Get Signal

Get a specific signal by ID.

GET /api/v1/trading-signals/:id

Authentication: JWT

Path Parameters

Parameter	Type	Description
`id`	integer	Signal ID

Delete All Signals

Delete all trading signals. Use with caution.

DELETE /api/v1/trading-signals/all

Authentication: JWT

Response

Success (200)

{
  "success": true,
  "deleted": 150
}

Signal Strength Guide

Strength	Meaning	Suggested Use
1	Weak	Low confidence signals
2	Low-Medium	Moderate confidence
3	Medium	Standard signals
4	Strong	High confidence
5	Very Strong	Highest confidence signals

Signal strength can be used by agents to filter which signals to act on via trading configuration.

Related Endpoints

API Keys - Create API keys for signals
Agents - Configure agent automation
Agent Positions - View resulting positions

Historical Swaps Wallets