Kolect API

The Kolect API is Eurybia's computation layer. It runs strategy backtests, serves KOL leaderboards, grid-search scores and Twitter sentiment queries.

Property	Value
Framework	Quart (async Flask)
Base URL	https://eurybia.xyz/kolect/api
Auth	Bearer (sentiment query only)
Data stores	PostgreSQL (twitter, quant_data)
Interactive reference	Kolect API reference

Architecture

Kolect is deployed as 9 independent services behind a single public surface. The backtest proxy is the single entry point for all strategy backtests; it routes requests to the correct strategy backend by strategy.strategyType.

                /kolect/api/backtests/execute  ──►  backtest_proxy (:1230)
                         │  routes by strategyType
                         ├──► KOL_SENTIMENT / KOL_POOL  ──► :1251
                         ├──► KOL_MEME                   ──► :1252
                         ├──► KOL_VOLUME                 ──► :1253
                         └──► KOL_SENTIMENT_PRO / KOL_POOL_PRO ──► :1351

/kolect/api/kols/leaderboard      ──► :1260
/kolect/api/strategies/grid_scores──► :1261
/kolect/api/key_request|key_query ──► :1270
/kolect/api/query/sentiment       ──► :1280

Strategy types

strategyType	Backend port	Description
KOL_SENTIMENT	1251	Sentiment factor backtest
KOL_POOL	1251	Sentiment backtest over an explicit KOL list (requires kolList)
KOL_MEME	1252	Meme strategy backtest
KOL_VOLUME	1253	Volume factor backtest
KOL_SENTIMENT_PRO	1351	TP/SL sentiment backtest
KOL_POOL_PRO	1351	TP/SL sentiment backtest over a KOL list

Backtest request

All backtests share a single endpoint with a nested strategy object:

POST /kolect/api/backtests/execute
{
  "strategy": {
    "strategyID": "kol-sentiment-btc-001",
    "strategyType": "KOL_SENTIMENT",
    "targetAsset": "BTC",
    "parameters": {
      "positiveThreshold": 0.3,
      "negativeThreshold": 0.4,
      "neutralThreshold": 0.8,
      "kolList": ["elonmusk"]
    }
  }
}

• targetAsset is one of BTC or ETH.
• kolList is required for KOL_POOL / KOL_POOL_PRO, optional otherwise.
• The response always contains three periods (7d, 30d, 90d), each with kpis (pnl, mdd, apr, winRate, sharpeRatio, volatility), timeseries and dailyRevenue.

Sentiment query

POST /kolect/api/query/sentiment
Authorization: Bearer <api_key>
{
  "cryptocurrency": "bitcoin",
  "time_window": "7d"
}

• time_window is one of 1h, 1d, 7d.
• Returns positive / negative / neutral percentages.

API keys

Self-service key management:

• POST /kolect/api/key_request — request an API key
• POST /kolect/api/key_query — look up key status
• GET /kolect/api/key_management/health — service health