🔤API Reference Draft

Comprehensive API documentation for the AIQuant platform.

Overview

The AIQuant API provides programmatic access to AI-powered quantitative trading data, analyses, and signals for cryptocurrency markets. This API allows developers, traders, and funds to integrate AIQuant's advanced trading intelligence directly into their applications and systems.

With the AIQuant API, you can access performance reports, trade logs, evaluation results, alpha signals, and trading playbooks across multiple blockchain networks. The API is designed to support a wide range of use cases from simple data retrieval to complex trading strategy implementation.

Authentication

All API requests must be authenticated using an API key. To make authenticated requests, include your API key in the request header:

X-API-Key: your_api_key_here

Getting Your API Key

API keys are tied to your AIQuant subscription plan. To obtain an API key:

Subscribe to one of the API plans (Basic, Growth, or Enterprise)
Navigate to the API section in your profile settings
Generate a new API key

For security reasons, store your API key securely and do not share it publicly.

Rate Limits and Quotas

The AIQuant API implements daily request limits based on your subscription plan:

Plan

Daily Request Limit

Chain Access

Primaray Use Case

Basic API

100 requests/day

Up to 1 chain

Developers & Hobbyists

Growth API

500 requests/day

Up to 2 chains

Scaling Products

Enterprise API

5,000 requests/day

Unlimited chains

Quant Funds & Advanced Traders

Rate limit information is included in the response headers:

X-RateLimit-Limit: [daily limit]
X-RateLimit-Remaining: [remaining requests]
X-RateLimit-Reset: [reset timestamp]

When you exceed your daily limit, the API will return a 429 Too Many Requests response.

API Plans and Features

AIQuant offers three API subscription plans with different capabilities:

Basic API Plan

Performance reports & trade logs
Quick evaluation summaries
Support: Email

Growth API Plan

Everything in Basic, plus:
Detailed evaluation reports
Realtime alpha signals
Basic trading playbook
Support: Email + Telegram

Enterprise API Plan

Everything in Growth, plus:
Advanced trading playbook
AI-powered strategy optimizations
Support: Email + Telegram + Slack

Available Endpoints

Base URL: https://aiquant.fun/api

All endpoints should be prefixed with this base URL. For example, to access the Trade Statistics endpoint, use: https://aiquant.fun/api/trades/stats

Performance & Trades

Evaluation Results

Alpha Signals

Trading Playbook

Degen Configuration

Strategy Optimization

Performance & Trades

Trade Statistics

Trade Metrics

GET /api/trades/stats

Retrieves aggregated metrics for trades, including total trades, volume, and weekly performance changes.

Query Parameters:

quantId (integer, optional): Filter metrics by specific quant ID

Response:

{
    "metrics": {
        "totalTrades": 20624,
        "totalVolume": 11022415.867949218,
        "tradesWeeklyChange": -18.414533443435175,
        "volumeWeeklyChange": -30.29726971091618
    }
}

Trade History

Trade List

GET /api/trades

Retrieves paginated trade history with filtering options.

Query Parameters:

quantId (integer, optional): Filter by quant ID
page (integer, optional): Page number for pagination
pageSize (integer, optional): Number of trades per page
sortBy (string, optional): Field to sort by
sortOrder (string, optional): Sort direction (asc or desc)
filterStatus (string, optional): Filter by trade status
search (string, optional): Search term for tokens
startDate (string, optional): Filter by start date (ISO format)
endDate (string, optional): Filter by end date (ISO format)
chain (string, optional): Filter by blockchain network
positionClosed (string, optional): Filter by position status (true, false, or all)
isTrackingEnabled (string, optional): Filter by tracking status (true, false, or all)

Response:

{
    "trades": [
        {
            "id": "50155",
            "token_id": "54667",
            "token_name": "WE LOVE ASS",
            "token_symbol": "ASS",
            "token_image": "https://ipfs.io/ipfs/QmYqF2cRhTKKUbWjBTuNsXSSNPbzFWtwd9p4ua1xFD2sHv",
            "token_chain": "SOLANA",
            "token_address": "CfgmB9iTWABdYh3CHQQDUGtWy18rMNAEEqyp4GrJpump",
            "open_date": "2025-04-09 03:05:05",
            "close_date": "2025-04-09 03:52:08",
            "duration": "0.78",
            "buy_cost_usd": "$10",
            "sell_revenue_usd": "$10",
            "pnl_usd": "-$0.4",
            "roi": "-4.0%",
            "eth_sol_spent": "0.100000 SOL",
            "eth_sol_received": "0.096180 SOL",
            "tokens_bought": "14771.92610532857",
            "tokens_sold": "14771.92610532857",
            "avg_buy_price_solOrEth": "0.00000677",
            "status": "Closed",
            "result": "Loss",
            "price": "$0.000672",
            "price_change": "+26.53%",
            "volume24h": "$85.42K",
            "quant_name": "Premium Edge",
            "latest_evaluation": {
                "id": 6807776,
                "type": "TOKEN_BUY",
                "passed": false,
                "ai_score": 35,
                "internal_score": 50,
                "timestamp": "2025-04-09T13:48:09.929Z",
                "summary": "The token shows weak market dynamics with a bearish trend indicated by declining price changes and low buy-to-sell ratios. Community engagement data is missing, which adds uncertainty. Technical analysis reveals mixed signals, with a bearish MACD and moving average, but a strong Fibonacci score suggesting potential support. Overall, the negative indicators outweigh the positives, making it a risky investment. It is not a good time to buy this token.",
                "detection_price": 0.001866992233880762,
                "token_image": "https://ipfs.io/ipfs/QmYqF2cRhTKKUbWjBTuNsXSSNPbzFWtwd9p4ua1xFD2sHv"
            }
        }
    ],
    "summary": {
        "totalTrades": 157,
        "totalVolume": 34816.93969230225,
        "profitableTrades": 84,
        "lossTrades": 73,
        "totalProfit": 3989.0842282990784,
        "totalLoss": 2823.7555181923963,
        "winRate": 53.503184713375795,
        "accountValue": 35982.26840240895,
        "realized": {
            "trades": 150,
            "volume": 32497.442223898477,
            "profitableTrades": 83,
            "lossTrades": 67,
            "profit": 3877.258630608689,
            "loss": 2661.3419094668675,
            "pnl": 1215.9167211418214,
            "roi": 3.7415766839878914,
            "winRate": 55.333333333333336,
            "avgReturn": 8.10611147427881
        },
        "unrealized": {
            "trades": 7,
            "volume": 2319.4974684037825,
            "profitableTrades": 1,
            "lossTrades": 6,
            "profit": 111.8255976903888,
            "loss": 162.41360872552906,
            "pnl": -50.588011035140255,
            "roi": -2.180990137917831,
            "winRate": 14.285714285714285,
            "avgReturn": -7.226858719305751
        }
    },
    "pagination": {
        "total": 157,
        "page": 1,
        "pageSize": 20,
        "totalPages": 8
    }
}

Trade Details

Trade Information

GET /api/trades/:id

Retrieves detailed information about a specific trade.

Path Parameters:

id (integer, required): Trade ID

Response:

{
    "trade": {
        "id": "50208",
        "token_id": "59181",
        "token_name": "42069COIN",
        "token_symbol": "42069COIN",
        "token_image": "https://ipfs.io/ipfs/QmUzk4cQBHxCBLRH3sPxKWAsFT9CpmjsBndJGPzkEQGbkv",
        "token_chain": "SOLANA",
        "token_address": "5CxtvaR1SskwLxfzHGurx8Enu8bgSTPyWF3YP4sWpump",
        "open_date": "2025-04-09 03:46:23",
        "close_date": "2025-04-09 04:02:50",
        "duration": "0.27",
        "buy_cost_usd": "$10",
        "sell_revenue_usd": "$12",
        "pnl_usd": "$1.5",
        "roi": "+14.4%",
        "eth_sol_spent": "0.100000 SOL",
        "eth_sol_received": "0.113978 SOL",
        "tokens_bought": "23262.21112957615",
        "tokens_sold": "23262.21112957615",
        "avg_buy_price_solOrEth": "0.00000430",
        "status": "Closed",
        "result": "Profit",
        "price": "$0.000435",
        "price_change": "+525.69%",
        "volume24h": "$1.63M",
        "quant_name": "Premium Edge",
        "duration_seconds": 987,
        "buy_cost_usd_raw": 10.31736792095562,
        "sell_revenue_usd_raw": 11.799694276221217,
        "pnl_usd_raw": 1.482326355265597,
        "roi_raw": 14.367291799828537,
        "eth_sol_spent_raw": 0.1,
        "eth_sol_received_raw": 0.1139776250364365,
        "tokens_bought_raw": 23262.21112957615,
        "tokens_sold_raw": 23262.21112957615,
        "avg_buy_price_solOrEth_raw": 0.00000429881748742524,
        "price_raw": 0.0004350409701404734,
        "price_change_raw": 525.6869012910554,
        "volume24h_raw": 1634074.65679551,
        "marketCap": "$435.04K",
        "marketCap_raw": 435038.0329303403,
        "liquidity": "$77.67K",
        "liquidity_raw": 77670.61858872062,
        "transactions": [
            {
                "id": 73467,
                "action": "BUY",
                "txHash": "FAKE-dd00268f-a4ae-4a5c-b7ea-186774914e5e",
                "timestamp": "2025-04-09T03:46:23.238Z",
                "inputToken": "So11111111111111111111111111111111111111112",
                "outputToken": "5CxtvaR1SskwLxfzHGurx8Enu8bgSTPyWF3YP4sWpump",
                "inputAmount": 0.1,
                "outputAmount": 23262.21112957615,
                "inputValueUsd": 10.31736792095562,
                "outputValueUsd": 10.317367920955618,
                "pricePerTokenInUsd": 0.0004435248164280421
            },
            {
                "id": 73491,
                "action": "SELL",
                "txHash": "FAKE-0a0810a0-bfa9-49b5-91cb-5a0b424fa531",
                "timestamp": "2025-04-09T04:02:50.239Z",
                "inputToken": "5CxtvaR1SskwLxfzHGurx8Enu8bgSTPyWF3YP4sWpump",
                "outputToken": "So11111111111111111111111111111111111111112",
                "inputAmount": 23262.21112957615,
                "outputAmount": 0.1139776250364365,
                "inputValueUsd": 11.799694276221219,
                "outputValueUsd": 11.799694276221217,
                "pricePerTokenInUsd": 0.0005072473210089129
            }
        ],
        "latest_evaluation": {
            "id": 6673431,
            "type": "TOKEN_BUY",
            "passed": false,
            "ai_score": 30,
            "internal_score": 55,
            "timestamp": "2025-04-09T07:58:30.921Z",
            "summary": "The token shows significant bearish signals with a high RSI indicating overbought conditions, negative price changes, and a downtrend forecast from AI. Despite some positive community engagement and buy-to-sell ratios, the overall market dynamics and technical indicators suggest a strong sell sentiment. Given the current conditions, it is not a good time to buy this token.",
            "detection_price": 0.00004558404626886283,
            "token_image": "https://ipfs.io/ipfs/QmUzk4cQBHxCBLRH3sPxKWAsFT9CpmjsBndJGPzkEQGbkv"
        }
    }
}

Evaluation Results

Latest Evaluation Results

Evaluation Results

GET /api/eval-results

Retrieves the latest token evaluation results with filtering options.

Query Parameters:

limit (integer, optional): Maximum number of results to return
offset (integer, optional): Number of results to skip
chain (string, optional): Filter by blockchain network
search (string, optional): Search term for tokens
quantId (string, optional): Filter by quant ID
passed (string, optional): Filter by pass/fail status
uniqueTokensOnly (string, optional): Return only unique tokens
onlyScored (string, optional): Return only scored evaluations
timeTo (string, optional): End time for results (ISO format)
timeFrom (string, optional): Start time for results (ISO format)
evaluationResultType (string, optional): Filter by evaluation type

Response:

{
    "results": [
        {
            "id": 20083701,
            "tokenId": 30938,
            "userQuantId": 4,
            "createdAt": "2025-05-08T08:45:30.837Z",
            "updatedAt": "2025-05-08T08:45:30.837Z",
            "evaluationResultType": "TOKEN_BUY",
            "marketCap": 775354,
            "passed": true,
            "avgScore": 65,
            "aiScore": 65,
            "internalScore": 65,
            "aiAnalysis": "The token exhibits strong technical momentum with high MACD and bullish on-chain prediction, supported by increasing volume and buy-to-sell ratios. Despite some sell volume increases and ranging market regime, the overall technical and AI signals lean positive. The lack of verified community engagement data introduces some uncertainty, but the technical and fundamental indicators suggest a promising entry point. Therefore, it is a GOOD TIME to BUY with medium risk tolerance.",
            "aiPrompt": "...",
            "token": {
                "id": 30938,
                "symbol": "BITCOIN",
                "address": "0x2a06A17CBC6d0032Cac2c6696DA90f29D39a1a29",
                "chainName": "BASE",
                "DataFetcherResponseSnapshots": [...],
                "detectionPrice": 0.06284334598184069,
                "image": "https://dd.dexscreener.com/ds-data/tokens/base/0x2a06a17cbc6d0032cac2c6696da90f29d39a1a29.png?key=9d0df5&size=xl"
            },
            "performance": {
                "tokenId": 30938,
                "entryPriceUsd": 0.039514,
                "roi": 4.21
            }
        }
    ],
    "total": 2
}

Evaluation Timeseries

Evaluation Trends

GET /api/eval-timeseries

Retrieves evaluation data as a time series.

Query Parameters:

timeFrom (string, required): Start time for timeseries (ISO format)
timeTo (string, required): End time for timeseries (ISO format)
quantId (string, optional): Filter by quant ID
returnAllQuants (string, optional): Include all quants in results

Response:

{
    "timeseries": [
        {
            "timestamp": "2025-05-08T00:00:00.000Z",
            "evaluations": 342,
            "passed": 127,
            "failed": 215,
            "percentPassed": 37.13
        },
        // ...additional time points
    ]
}

Evaluation Count

Evaluation Counts

GET /api/eval-count

Retrieves the count of evaluations over time.

Query Parameters:

timeFrom (string, required): Start time (ISO format)
timeTo (string, required): End time (ISO format)
quantId (string, optional): Filter by quant ID
returnAllQuants (string, optional): Include all quants in count

Response:

{
    "total": 4387,
    "passed": 1634,
    "failed": 2753,
    "percentPassed": 37.25
}

Evaluation Details

Evaluation Details

GET /api/eval-details

Retrieves detailed information about a specific evaluation.

Query Parameters:

evaluationId (string, required): ID of the evaluation

Response:

{
    "token": {
        "id": 96941,
        "image": "https://ipfs.io/ipfs/QmefBnQRMLs9CKarKBPWiTXrMZ32A32zDxD7FX9FzTRS1M",
        "name": "Nice Meme",
        "symbol": "NM",
        "address": "5Q4ABNEAyg1MVXwxGAEsVzEHWNxuWZdjnZ1gDHvbaqwQ",
        "priceSnapshot": 0.0009107867837406853,
        "priceChange24h": 201.310559747887,
        "mc": 905975.3320194203,
        "liquidity": 363.5912362391309,
        "volume24h": 2879.724923089009,
        "status": "DORMANT",
        "createdAt": "2025-05-07T21:50:01.083Z",
        "chainName": "SOLANA"
    },
    "userQuant": {
        "id": 4,
        "name": "Premium Edge"
    },
    "evaluationResult": {
        "id": 20142913,
        "passed": false,
        "evaluationResultType": "TOKEN_STATUS",
        "avgScore": 0,
        "internalScore": 0,
        "aiScore": 0,
        "aiAnalysis": "Failed required criteria: Liquidity to Market Cap Ratio",
        "createdAt": "2025-05-08T15:34:49.951Z"
    },
    "evaluationResultDetails": [
        {
            "id": 767283072,
            "passed": null,
            "value": "",
            "threshold": 80,
            "weight": 0,
            "score": null,
            "criteriaScore": null,
            "criteriaId": 65,
            "createdAt": "2025-05-08T15:34:49.951Z",
            "extraInfo": {
                "operator": "V_GTE_T"
            },
            "criteria": {
                "key": "tokenSnifferScore",
                "name": "Token Sniffer Score",
                "shortDescription": "Overall security score based on audit findings.",
                "longDescription": "Aggregates various security factors into a single score, indicating the overall security health of the token."
            },
            "category": {
                "id": 4,
                "name": "Security"
            }
        },
        // ...additional criteria details
    ]
}

Evaluation History

Evaluation History

GET /api/eval-history

Retrieves the evaluation history for a specific token or evaluation.

Query Parameters:

evaluationId (string, required): ID of the evaluation
take (integer, optional): Maximum number of results to return
skip (integer, optional): Number of results to skip
excludeTypes (string, optional): Comma-separated list of evaluation types to exclude

Response:

{
    "total": 2,
    "results": [
        {
            "id": 20142913,
            "createdAt": "2025-05-08T15:34:49.951Z",
            "marketCap": 905975.3320194203,
            "evaluationResultType": "TOKEN_STATUS",
            "aiScore": 0,
            "internalScore": 0,
            "price": 0.0009107867837406853,
            "passed": false
        },
        {
            "id": 20138175,
            "createdAt": "2025-05-08T14:34:21.817Z",
            "marketCap": 905975.3320194203,
            "evaluationResultType": "TOKEN_STATUS",
            "aiScore": 0,
            "internalScore": 0,
            "price": 0.0009107867837406853,
            "passed": false
        }
    ]
}

Token OHLCV Data

Market Data

GET /api/eval-ohlcv

Retrieves open, high, low, close, volume (OHLCV) data for a token.

Query Parameters:

tokenId (string, required): ID of the token
timeframe (string, optional): Timeframe for data points (e.g., '1h', '4h', '1d')
limit (integer, optional): Maximum number of data points to return

Response:

{
    "ohlcv": [
        {
            "timestamp": 1746628800000,
            "open": 0.00092107,
            "high": 0.00095233,
            "low": 0.00089765,
            "close": 0.00091079,
            "volume": 2879.72
        },
        // ...additional data points
    ]
}

Alpha Signals

Alpha Signals List

Alpha Signals

GET /api/alpha-signals

Retrieves a list of alpha signals with filtering options.

Query Parameters:

quantId (integer, optional): Filter by quant ID
limit (integer, optional): Maximum number of results to return
chain (string, optional): Filter by blockchain network
includeTokenDetails (boolean, optional): Include detailed token information
search (string, optional): Search term for tokens

Response:

{
    "signals": [
        {
            "tokenId": 96941,
            "evaluationId": 20142913,
            "token": "Nice Meme",
            "symbol": "NM",
            "image": "https://ipfs.io/ipfs/QmefBnQRMLs9CKarKBPWiTXrMZ32A32zDxD7FX9FzTRS1M",
            "chainName": "SOLANA",
            "price": 0.0009107867837406853,
            "change": 201.310559747887,
            "volume": 2879724.923,
            "analysisProgress": 0,
            "stage": "SCREENING",
            "alert": "Failed required criteria: Liquidity to Market Cap Ratio",
            "updatedAt": "2025-05-08T15:34:49.951Z",
            "entryPriceUsd": null,
            "roi": null,
            "marketCap": 905975.3320194203,
            "liquidity": 363.5912362391309,
            "volume24h": 2879.724923089009,
            "address": "5Q4ABNEAyg1MVXwxGAEsVzEHWNxuWZdjnZ1gDHvbaqwQ",
            "passed": false,
            "evaluationResultType": "TOKEN_STATUS"
        },
        // ...additional signals
    ],
    "byChain": {
        "all": {
            "signals": [...],
            "stats": {
                "total": 12,
                "screening": 12,
                "buy": 0,
                "sell": 0,
                "watch": 0
            }
        },
        "solana": {
            "signals": [...],
            "stats": {...}
        },
        "base": {
            "signals": [...],
            "stats": {...}
        },
        "bsc": {
            "signals": [...],
            "stats": {...}
        }
    }
}

Alpha Signal Details

Signal Details

GET /api/alpha-signals/:tokenId

Retrieves detailed information about a specific alpha signal.

Path Parameters:

tokenId (integer, required): ID of the token

Query Parameters:

quantId (integer, optional): ID of the quant

Response:

{
    "tokenId": 93953,
    "evaluationId": 20142864,
    "token": "MYX",
    "symbol": "MYX",
    "image": null,
    "address": "0x38b1CD3b470db9A91eD4529297D1a3718f0c0a15",
    "chainName": "BSC",
    "price": 0.00007181090731037781,
    "change": 0,
    "volume": 0.003434320356159834,
    "marketCap": 330330.1736277379,
    "liquidity": 6.128644159233319,
    "stage": "SCREENING",
    "alert": "Failed required...",
    "aiScore": 0,
    "internalScore": 0,
    "aiAnalysis": "Failed required criteria: Min Buy Tx 1h",
    "evaluationResultType": "TOKEN_STATUS",
    "passed": false,
    "updatedAt": "2025-05-08T15:33:09.932Z",
    "entryPriceUsd": null,
    "roi": null,
    "evaluationDetails": []
}

Trading Playbook

Degen Configuration

Trading Playbook Configuration

GET /api/degen/config

Retrieves the trading playbook configuration for a quant.

Query Parameters:

quantId (integer, required): ID of the quant
configGroupId (string, optional): ID of the configuration group

Response:

[
    {
        "marketCap": "DEGEN_CAP",
        "categories": {
            "Security": [
                {
                    "rootKey": "auditRisks",
                    "criteriaName": "Audit Risks",
                    "shortDescription": "Checks multiple security aspects of the contract.",
                    "longDescription": "Conducts a comprehensive audit of the token's contract for security risks, such as disabled minting and burned liquidity tokens.",
                    "isHumanCriteria": true,
                    "configTypes": {
                        "SCANNING": {
                            "thresholds": {
                                "noTime": 1
                            },
                            "weights": {
                                "noTime": 8
                            },
                            "requireds": {
                                "noTime": false
                            },
                            "disableds": {
                                "noTime": false
                            },
                            "extraInfos": {
                                "noTime": {
                                    "options": [
                                        {
                                            "id": 0,
                                            "label": "Any"
                                        },
                                        {
                                            "id": 1,
                                            "label": "No Risks Found Only"
                                        },
                                        {
                                            "id": 2,
                                            "label": "Has Risks Found Only"
                                        }
                                    ]
                                }
                            },
                            "delegates": {
                                "noTime": false
                            },
                            "configIdsByInterval": {
                                "noTime": "3d5feae0-da93-4659-8df7-56562517ca57"
                            },
                            "configKeys": {
                                "noTime": "auditRisks"
                            }
                        }
                    }
                }
            ],
            "Market": [
                // Market criteria configurations
            ],
            "Social": [
                // Social criteria configurations
            ],
            "AI": [
                // AI criteria configurations
            ],
            "Technical Analysis": [
                // Technical Analysis criteria configurations
            ],
            "Onchain": [
                // Onchain criteria configurations
            ]
        }
    }
]

Strategy Optimization

Optimization Dashboard

Strategy Dashboard

GET /api/refine-eval/dashboard

Retrieves the strategy optimization dashboard with performance metrics and recommendations.

Query Parameters:

quantId (integer, optional): ID of the quant

Response:

{
    "success": true,
    "data": {
        "overallPerformance": {
            "totalTrades": 343,
            "completedTrades": 336,
            "activeTrades": 7,
            "winningTrades": 219,
            "losingTrades": 117,
            "winRate": 0.6517857142857143,
            "avgProfitWinningTrades": 18.23220626191062,
            "avgLossLosingTrades": -26.49156851917146,
            "totalPnL": 1345.4071517405107
        },
        "recentRecommendations": [
            {
                "id": 45,
                "criteriaId": 54,
                "criteriaKey": "volumeChangePercent24h",
                "criteriaName": "Volume Change Percent 24h",
                "oldThreshold": 60,
                "newThreshold": -61.73595809622495,
                "oldExtraInfo": {
                    "operator": "V_GTE_T"
                },
                "newExtraInfo": {
                    "operator": "V_GTE_T"
                },
                "confidence": 0.95,
                "reasoning": "Profitable trades have higher values (avg: 444475.48) than unprofitable trades (avg: 2095.70). Suggesting a threshold of -61.74 to optimize separation.",
                "applied": true,
                "appliedAt": "2025-03-29T20:49:28.468Z",
                "beforeWinRate": 0,
                "afterWinRate": 0.6260869565217392,
                "tradeDifference": 230,
                "configType": "BUY",
                "isDegenConfig": true,
                "userQuantId": 4,
                "profitableAccuracy": 1,
                "unprofitableAccuracy": 0.08823529411764706,
                "f1Score": 0.6990291262135923,
                "sampleSize": 70,
                "profitableAvg": 444475.4815665149,
                "unprofitableAvg": 2095.697533762305,
                "valueDifferenceRatio": 0.9952850098134183,
                "userFeedback": null,
                "actualImpact": 0.6260869565217392,
                "createdAt": "2025-03-26T22:05:01.363Z",
                "updatedAt": "2025-04-12T20:49:31.076Z"
            }
        ],
        "appliedRecommendations": [
            // List of applied recommendations
        ],
        "historicalTrends": {}
    }
}

Run Analysis

Analysis Executor

POST /api/refine-eval/analyze

Executes a strategy analysis to generate optimization recommendations.

Request Body:

quantId (integer, optional): ID of the quant to analyze

Response:

{
    "success": true,
    "data": {
        "tradesAnalyzed": 343,
        "recommendationsGenerated": 24,
        "recommendationsApplied": 0
    }
}

Apply Recommendation

Apply Recommendation

POST /api/refine-eval/recs/:id/apply

Applies a specific optimization recommendation to the trading strategy.

Path Parameters:

id (integer, required): ID of the recommendation to apply

Response:

{
    "success": true,
    "data": {
        "id": 45,
        "criteriaId": 54,
        "criteriaKey": "volumeChangePercent24h",
        "criteriaName": "Volume Change Percent 24h",
        "oldThreshold": 60,
        "newThreshold": -61.73595809622495,
        "applied": true,
        "appliedAt": "2025-05-08T16:45:12.468Z",
        "beforeWinRate": 0.602,
        "afterWinRate": 0.684,
        "tradeDifference": -15,
        "actualImpact": 0.082
    }
}

Getting Started

1. Create an AIQuant Account

Visit AIQuant.fun to sign up for an account.

2. Launch a Quant

Create and configure your AI-powered trading quant. This will be your primary trading agent that generates signals and evaluations.

3. Select an API Plan

Choose the API plan that best suits your needs:

Basic API: For indie builders and hobbyist developers
Growth API: For scaling products, mid-sized funds, and onchain tools
Enterprise API: For quant funds, trading platforms, and strategic innovators

4. Generate an API Key

Once subscribed to an API plan:

Navigate to the API section in your profile settings
Click "Generate New API Key"
Store your API key securely

5. Start Integrating

Add your API key to the request headers:

X-API-Key: your_api_key_here

Test your integration with a simple request:

curl -H "X-API-Key: your_api_key_here" https://aiquant.fun/api/trades/stats

Code Examples

JavaScript/Node.js

const axios = require('axios');

const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://aiquant.fun/api';

async function getAlphaSignals(chain = 'SOLANA', limit = 10) {
  try {
    const response = await axios.get(`${BASE_URL}/alpha-signals`, {
      headers: {
        'X-API-Key': API_KEY
      },
      params: {
        chain,
        limit,
        includeTokenDetails: true
      }
    });
    
    return response.data;
  } catch (error) {
    console.error('Error fetching alpha signals:', error.response?.data || error.message);
    throw error;
  }
}

// Usage
getAlphaSignals()
  .then(data => console.log(`Found ${data.signals.length} alpha signals`))
  .catch(err => console.error('Failed to fetch alpha signals'));

Python

import requests

API_KEY = 'your_api_key_here'
BASE_URL = 'https://aiquant.fun/api'

def get_trade_history(quant_id=None, days=7):
    from datetime import datetime, timedelta
    end_date = datetime.now().isoformat()
    start_date = (datetime.now() - timedelta(days=days)).isoformat()
    
    params = {
        'startDate': start_date,
        'endDate': end_date,
        'pageSize': 50,
        'page': 1
    }
    
    if quant_id:
        params['quantId'] = quant_id
        
    headers = {
        'X-API-Key': API_KEY
    }
    
    response = requests.get(f"{BASE_URL}/trades", params=params, headers=headers)
    
    if response.status_code == 200:
        return response.json()
    else:
        raise Exception(f"API request failed with status {response.status_code}: {response.text}")

# Usage
try:
    trades = get_trade_history(quant_id=4)
    print(f"Retrieved {len(trades['trades'])} trades with win rate: {trades['summary']['winRate']:.2%}")
except Exception as e:
    print(f"Error: {e}")

For urgent assistance, please contact our developer relations team at [email protected]

Last updated 1 year ago

hashtagOverview

hashtagAuthentication

hashtagGetting Your API Key

hashtagRate Limits and Quotas

hashtagAPI Plans and Features

hashtagBasic API Plan

hashtagGrowth API Plan

hashtagEnterprise API Plan

hashtagAvailable Endpoints

hashtagPerformance & Trades

hashtagEvaluation Results

hashtagAlpha Signals

hashtagTrading Playbook

hashtagStrategy Optimization

hashtagPerformance & Trades

hashtagTrade Statistics

hashtagTrade History

hashtagTrade Details

hashtagEvaluation Results

hashtagLatest Evaluation Results

hashtagEvaluation Timeseries

hashtagEvaluation Count

hashtagEvaluation Details

hashtagEvaluation History

hashtagToken OHLCV Data

hashtagAlpha Signals

hashtagAlpha Signals List

hashtagAlpha Signal Details

hashtagTrading Playbook

hashtagDegen Configuration

hashtagStrategy Optimization

hashtagOptimization Dashboard

hashtagRun Analysis

hashtagApply Recommendation

hashtagGetting Started

hashtag1. Create an AIQuant Account

hashtag2. Launch a Quant

hashtag3. Select an API Plan

hashtag4. Generate an API Key

hashtag5. Start Integrating

hashtagCode Examples

hashtagJavaScript/Node.js

hashtagPython

Overview

Authentication

Getting Your API Key

Rate Limits and Quotas

API Plans and Features

Basic API Plan

Growth API Plan

Enterprise API Plan

Available Endpoints

Performance & Trades

Evaluation Results

Alpha Signals

Trading Playbook

Strategy Optimization

Performance & Trades

Trade Statistics

Trade History

Trade Details

Evaluation Results

Latest Evaluation Results

Evaluation Timeseries

Evaluation Count

Evaluation Details

Evaluation History

Token OHLCV Data

Alpha Signals

Alpha Signals List

Alpha Signal Details

Trading Playbook

Degen Configuration

Strategy Optimization

Optimization Dashboard

Run Analysis

Apply Recommendation

Getting Started

1. Create an AIQuant Account

2. Launch a Quant

3. Select an API Plan

4. Generate an API Key

5. Start Integrating

Code Examples

JavaScript/Node.js

Python