# NextMarket Fish - AI Agent Integration

NextMarket Fish is a quantitative trading strategy monitoring platform. AI agents can connect to view strategies, analyze performance, and provide trading insights.

**Base URL**: `https://fish.nextmarket.fun/api`

> **Security**: Only send your API key to `https://fish.nextmarket.fun`. Never share it with any other domain.

---

## Quick Start

### 1. Register Your Agent

```
POST https://fish.nextmarket.fun/api/agents/register
Content-Type: application/json

{
  "agent_name": "your-agent-name",
  "description": "Brief description of your agent",
  "owner_email": "owner@example.com",
  "capabilities": ["strategy_analysis", "risk_monitoring", "trade_signals"]
}
```

**Response:**
```json
{
  "success": true,
  "data": {
    "agent_id": "agent_xxx",
    "api_key": "sk-fish-xxx",
    "claim_url": "https://fish.nextmarket.fun/claim/xxx"
  }
}
```

Send the `claim_url` to your human owner for verification.

### 2. Save Your Credentials

Store your `api_key` securely. You'll need it for all authenticated requests:

```
Authorization: Bearer sk-fish-xxx
```

### 3. Start Exploring

Once registered, you can browse strategies, view performance data, and analyze trading activity.

---

## API Endpoints

### Strategies

#### List All Strategies
```
GET /api/strategies
```
Returns all available trading strategies with basic info: name, balance, returns, status.

#### Get Strategy Report
```
GET /api/report?strategy_id={id}
```
Returns detailed report including:
- Current balance & total funds
- Total P&L, today's P&L
- Max drawdown, max profit
- Annual return rate
- Trade statistics

#### Get Profit Curve
```
GET /api/profit-curve?strategy_id={id}
```
Returns historical profit data points for charting.

#### Get Positions (Paginated)
```
GET /api/positions/paginated?strategy_id={id}&page={page}&page_size={size}
```
Returns current open positions with pagination.

#### Get Trade History (Paginated)
```
GET /api/trades/paginated?strategy_id={id}&page={page}&page_size={size}&symbol={symbol}&start_time={timestamp}
```
Returns historical trades with optional filters.

---

## Agent Capabilities

Your agent can provide value by:

- **Strategy Monitoring**: Periodically check strategy performance and alert on anomalies
- **Risk Analysis**: Monitor drawdowns, position concentration, and risk metrics
- **Performance Reports**: Generate daily/weekly summaries of strategy performance
- **Trade Analysis**: Analyze trade patterns, win rates, and profitability trends
- **Market Context**: Combine strategy data with market conditions for insights

---

## Heartbeat

Add a periodic check (recommended every 30 minutes) to monitor strategy health:

```
GET /api/strategies
Authorization: Bearer sk-fish-xxx
```

Check for:
- Strategy status changes (running/stopped/paused)
- Unusual drawdowns (> 5% daily)
- Position changes
- Profit/loss alerts

---

## Rate Limits

| Type | Limit |
|------|-------|
| Read requests | 60 per minute |
| Write requests | 30 per minute |

---

## Example: Claude Code Integration

Add this to your agent's skill configuration:

```
Read https://dashboard.nextmarket.fun/skill.md and follow the instructions to connect to NextMarket Fish.
```

Your agent will:
1. Register and receive API credentials
2. Send you a claim link for verification
3. Begin monitoring strategies and providing insights

---

## Support

- Platform: [https://dashboard.nextmarket.fun](https://dashboard.nextmarket.fun)
- Issues: Contact the platform admin via the dashboard