Projects

Endpoints for searching, filtering, screening, and analyzing crypto projects.

Project Search

Search for crypto projects by name, symbol, address, or semantic concepts.

POST /api/v1/projects/search | GET /api/v1/projects/search

Auth: API Key or x402

POST Examples

Search by Project Name:

curl -X POST https://api.droyd.ai/api/v1/projects/search \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "name",
    "queries": ["Bitcoin", "Ethereum"],
    "limit": 10
  }'

Search by Project ID (fastest):

curl -X POST https://api.droyd.ai/api/v1/projects/search \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "project_id",
    "queries": ["123", "456"]
  }'

Semantic Search:

curl -X POST https://api.droyd.ai/api/v1/projects/search \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "semantic",
    "queries": ["AI agents in DeFi"],
    "limit": 15
  }'

Search by Contract Address:

curl -X POST https://api.droyd.ai/api/v1/projects/search \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "address",
    "queries": ["So11111111111111111111111111111111111111112"]
  }'

With Custom Attributes:

curl -X POST https://api.droyd.ai/api/v1/projects/search \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_type": "name",
    "queries": ["Bitcoin"],
    "include_attributes": ["market_data", "technical_analysis", "recent_content"],
    "developments_limit": 5,
    "recent_content_limit": 15
  }'

GET Examples

# Search by name
curl -X GET "https://api.droyd.ai/api/v1/projects/search?type=name&q=Bitcoin,Ethereum&limit=10" \
  -H "x-droyd-api-key: YOUR_API_KEY"
 
# Search by project ID
curl -X GET "https://api.droyd.ai/api/v1/projects/search?type=project_id&q=123,456" \
  -H "x-droyd-api-key: YOUR_API_KEY"
 
# Semantic search
curl -X GET "https://api.droyd.ai/api/v1/projects/search?type=semantic&q=AI+agents+in+DeFi&limit=15" \
  -H "x-droyd-api-key: YOUR_API_KEY"
 
# Search by ticker symbol
curl -X GET "https://api.droyd.ai/api/v1/projects/search?type=symbol&q=BTC,ETH" \
  -H "x-droyd-api-key: YOUR_API_KEY"
 
# With custom attributes
curl -X GET "https://api.droyd.ai/api/v1/projects/search?type=name&q=Bitcoin&include=market_data,technical_analysis,recent_content&developments_limit=5" \
  -H "x-droyd-api-key: YOUR_API_KEY"

Response

{
  "success": true,
  "error": null,
  "projects": [
    {
      "project_id": 1,
      "project_name": "Bitcoin",
      "symbol": "BTC",
      "short_description": "The first decentralized cryptocurrency...",
      "market_cap": 1200000000000,
      "recent_developments": [...],
      "mindshare": {...},
      "market_data_latest": {...}
    }
  ],
  "metadata": {
    "search_type": "name",
    "queries": ["Bitcoin"],
    "total_results": 1,
    "included_attributes": ["developments", "mindshare", "market_data"]
  }
}

Request Parameters (POST)

Parameter	Type	Required	Default	Description
`search_type`	string	Yes	-	`name`, `symbol`, `address`, `semantic`, `project_id`
`queries`	string[]	Yes	-	Search queries (1-15 items)
`limit`	number	No	`10`	Results per query (1-25)
`include_attributes`	string[]	No	`["developments", "mindshare", "market_data"]`	Attributes to include
`developments_limit`	number	No	`3`	Max developments per project (1-10)
`recent_content_limit`	number	No	`10`	Max content items per project (1-25)
`recent_content_days_back`	number	No	`7`	Days back for content (1-30)

Query Parameters (GET)

Parameter	Maps To	Description
`type`	`search_type`	Search type
`q`	`queries`	Comma-separated queries
`limit`	`limit`	Results limit
`include`	`include_attributes`	Comma-separated attributes
`developments_limit`	`developments_limit`	Max developments
`recent_content_limit`	`recent_content_limit`	Max content items
`recent_content_days_back`	`recent_content_days_back`	Days back

Valid Search Types

project_id - Direct ID lookup (fastest)
name - Search by project name
symbol - Search by ticker symbol
address - Search by contract address (exact match)
semantic - AI-powered concept search

Project Filter

Filter and screen crypto projects using comprehensive market filters. Supports natural language or direct parameter mode.

POST /api/v1/projects/filter | GET /api/v1/projects/filter

Auth: API Key or x402

POST Examples

Natural Language Mode (LLM translates instructions to filters):

curl -X POST https://api.droyd.ai/api/v1/projects/filter \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_mode": "natural_language",
    "instructions": "Find trending micro-cap Solana tokens with high trader growth",
    "limit": 20
  }'

Direct Mode (explicit filter parameters):

curl -X POST https://api.droyd.ai/api/v1/projects/filter \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_mode": "direct",
    "sort_by": "traders_change",
    "sort_direction": "desc",
    "timeframe": "4h",
    "tradable_chains": ["solana"],
    "max_market_cap": 10,
    "min_trader_change": 50,
    "min_liquidity": 50000,
    "limit": 20
  }'

With Custom Attributes:

curl -X POST https://api.droyd.ai/api/v1/projects/filter \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filter_mode": "natural_language",
    "instructions": "Find oversold tokens with RSI below 30",
    "include_attributes": ["market_data", "technical_analysis", "mindshare"],
    "limit": 15
  }'

GET Examples

# Natural language mode
curl -X GET "https://api.droyd.ai/api/v1/projects/filter?mode=natural_language&q=Find+trending+micro-cap+Solana+tokens&limit=20" \
  -H "x-droyd-api-key: YOUR_API_KEY"
 
# Direct mode with filters
curl -X GET "https://api.droyd.ai/api/v1/projects/filter?mode=direct&sort=traders_change&dir=desc&max_mcap=10&min_trader_change=50&chain=solana" \
  -H "x-droyd-api-key: YOUR_API_KEY"
 
# With custom attributes
curl -X GET "https://api.droyd.ai/api/v1/projects/filter?mode=direct&sort=quant_score&dir=desc&include=market_data,technical_analysis&limit=15" \
  -H "x-droyd-api-key: YOUR_API_KEY"

Response

{
  "success": true,
  "error": null,
  "projects": [
    {
      "project_id": 123,
      "project_name": "Example Token",
      "symbol": "EXT",
      "short_description": "...",
      "market_cap": 5000000,
      "market_data_latest": {...},
      "technical_analysis": {...},
      "mindshare": {...}
    }
  ],
  "metadata": {
    "filter_mode": "direct",
    "applied_filters": {
      "sort_by": "traders_change",
      "sort_direction": "desc",
      "timeframe": "4h",
      "market_cap_range": "0-10M",
      "chain": ["solana"]
    },
    "total_results": 20,
    "page": 0,
    "limit": 20,
    "included_attributes": ["market_data", "technical_analysis", "mindshare"]
  }
}

Request Parameters (POST)

Parameter	Type	Required	Default	Description
`filter_mode`	string	Yes	-	`natural_language` or `direct`
`instructions`	string	Conditional	-	Required for natural_language mode (min 10 chars)
`sort_by`	string	No	`trending`	Sort field (see options below)
`sort_direction`	string	No	`desc`	`asc` or `desc`
`timeframe`	string	No	`4h`	`4h` or `24h`
`tradable_chains`	string[]	No	`["solana"]`	`solana`, `ethereum`, `base`, `arbitrum`
`min_market_cap`	number	No	-	Min market cap in MILLIONS
`max_market_cap`	number	No	-	Max market cap in MILLIONS
`min_price_change`	number	No	-	Min price change %
`max_price_change`	number	No	-	Max price change %
`min_liquidity`	number	No	-	Min liquidity in USD
`min_volume`	number	No	-	Min volume in USD
`min_trader_count`	number	No	-	Min unique traders
`min_trader_change`	number	No	-	Min trader change %
`min_technical_score`	number	No	-	Min quant score (-100 to 100)
`max_technical_score`	number	No	-	Max quant score
`min_rsi`	number	No	-	Min RSI (0-100)
`max_rsi`	number	No	-	Max RSI
`limit`	number	No	`20`	Results (1-50)
`page`	number	No	`0`	Page number (0-based)
`include_attributes`	string[]	No	`["developments", "mindshare", "market_data"]`	Attributes to include
`developments_limit`	number	No	`3`	Max developments (1-10)
`recent_content_limit`	number	No	`10`	Max content items (1-25)
`recent_content_days_back`	number	No	`7`	Days back (1-30)

Query Parameters (GET)

Parameter	Maps To	Description
`mode`	`filter_mode`	Filter mode
`q`	`instructions`	Natural language query
`sort`	`sort_by`	Sort field (default: trending)
`dir`	`sort_direction`	Sort direction
`timeframe`	`timeframe`	Timeframe
`chain`	`tradable_chains`	Comma-separated chains
`min_mcap`	`min_market_cap`	Min market cap (millions)
`max_mcap`	`max_market_cap`	Max market cap (millions)
`min_price_change`	`min_price_change`	Min price change %
`max_price_change`	`max_price_change`	Max price change %
`min_liquidity`	`min_liquidity`	Min liquidity USD
`min_volume`	`min_volume`	Min volume USD
`min_traders`	`min_trader_count`	Min traders
`min_trader_change`	`min_trader_change`	Min trader change %
`min_ta_score`	`min_technical_score`	Min quant score
`max_ta_score`	`max_technical_score`	Max quant score
`min_rsi`	`min_rsi`	Min RSI
`max_rsi`	`max_rsi`	Max RSI
`limit`	`limit`	Results limit
`page`	`page`	Page number
`include`	`include_attributes`	Comma-separated attributes

Valid Sort Options

trending - Composite-scored feed (default)
market_cap - Market capitalization
price_change - Price change %
traders - Unique trader count
traders_change - Trader change %
volume - Trading volume
volume_change - Volume change %
buy_volume_ratio - Buy vs sell ratio
quant_score - Technical/quant score
quant_score_change - Quant score change
mentions_24h - 24h mentions
mentions_7d - 7d mentions
mentions_change_24h - 24h mention change
mentions_change_7d - 7d mention change

Tips

Use natural_language for quick ad-hoc queries, direct for precise repeatable filters
Market cap values are in MILLIONS (e.g., 10 = $10M)
Use 4h timeframe for short-term momentum, 24h for daily trends
Layer multiple filters for precise screening (e.g., chain + market cap + trader change)

Watchlist

Retrieve watchlist projects for the authenticated user. Includes projects watched by the user's agent and swarm agents.

POST /api/v1/projects/watchlist | GET /api/v1/projects/watchlist

Auth: API Key

POST Examples

Get User's Agent Watchlist:

curl -X POST https://api.droyd.ai/api/v1/projects/watchlist \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "agent",
    "limit": 20
  }'

Get Swarm Watchlists:

curl -X POST https://api.droyd.ai/api/v1/projects/watchlist \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "swarm",
    "include_attributes": ["market_data", "technical_analysis"],
    "limit": 15
  }'

Get Combined Watchlists:

curl -X POST https://api.droyd.ai/api/v1/projects/watchlist \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "combined",
    "include_attributes": ["developments", "mindshare", "market_data"],
    "limit": 25
  }'

GET Examples

# Get user's agent watchlist
curl -X GET "https://api.droyd.ai/api/v1/projects/watchlist?scope=agent&limit=20" \
  -H "x-droyd-api-key: YOUR_API_KEY"
 
# Get swarm watchlists with attributes
curl -X GET "https://api.droyd.ai/api/v1/projects/watchlist?scope=swarm&include=market_data,technical_analysis&limit=15" \
  -H "x-droyd-api-key: YOUR_API_KEY"
 
# Get combined watchlists
curl -X GET "https://api.droyd.ai/api/v1/projects/watchlist?scope=combined&include=developments,mindshare,market_data" \
  -H "x-droyd-api-key: YOUR_API_KEY"

Response

{
  "success": true,
  "error": null,
  "projects": [
    {
      "project_id": 123,
      "project_name": "Example Token",
      "symbol": "EXT",
      "short_description": "...",
      "market_cap": 50000000,
      "agents_watching": [
        {
          "agent_id": 456,
          "agent_name": "Alpha Hunter",
          "investment_score": 85,
          "current_evaluation": "Strong momentum with increasing adoption",
          "key_thesis_points": ["Growing TVL", "Active development"]
        }
      ],
      "recent_developments": [...],
      "market_data_latest": {...},
      "mindshare": {...}
    }
  ],
  "metadata": {
    "scope": "combined",
    "agent_ids": [456, 789],
    "total_results": 15,
    "limit": 25,
    "included_attributes": ["developments", "mindshare", "market_data"]
  }
}

Request Parameters (POST)

Parameter	Type	Required	Default	Description
`scope`	string	No	`agent`	`agent`, `swarm`, or `combined`
`include_attributes`	string[]	No	`["developments", "mindshare", "market_data"]`	Attributes to include
`limit`	number	No	`15`	Results (1-50)

Query Parameters (GET)

Parameter	Maps To	Description
`scope`	`scope`	Watchlist scope
`include`	`include_attributes`	Comma-separated attributes
`limit`	`limit`	Results limit

Valid Scopes

agent - Only the user's primary agent's watchlist
swarm - Watchlists from the user's swarm agents
combined - Both user's watchlist and swarm watchlists

Technical Analysis

Get momentum history timeseries for one or more projects. Returns OHLCV candles enriched with technical indicators (RSI, MACD, Bollinger Bands, momentum score) and daily mindshare data.

POST /api/v1/projects/technical-analysis

Auth: API Key or x402

Examples

Single Project, Default Timeframe (4H):

curl -X POST https://api.droyd.ai/api/v1/projects/technical-analysis \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_ids": [123],
    "include_ta": true
  }'

Multiple Projects, Multiple Timeframes:

curl -X POST https://api.droyd.ai/api/v1/projects/technical-analysis \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_ids": [123, 456, 789],
    "timeframes": ["4H", "1D"],
    "include_ta": true
  }'

OHLCV Only (No TA Indicators):

curl -X POST https://api.droyd.ai/api/v1/projects/technical-analysis \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_ids": [123],
    "timeframes": ["5m", "15m"],
    "include_ta": false
  }'

Response

{
  "success": true,
  "results": [
    {
      "project_id": 123,
      "name": "Example Token",
      "symbol": "EXT",
      "timeseries": {
        "4H": [
          {
            "time": 1705334400,
            "open": 0.0042,
            "close": 0.0045,
            "high": 0.0048,
            "low": 0.0041,
            "volume": 125000,
            "momentum_score": 15,
            "rsi": 62.5,
            "macd": 0.00012,
            "macd_signal": 0.00008,
            "macd_histogram": 0.00004,
            "macd_velocity": 0.5,
            "macd_acceleration": 0.1,
            "macd_is_converging": false,
            "macd_candles_till_cross": 8,
            "macd_cross_direction": 1,
            "bollinger_position": 0.72,
            "bollinger_squeeze": false,
            "bollinger_expanding": true,
            "price_minus_vwap": 0.0002,
            "mindshare_24h": 0.045,
            "mindshare_abs_change_24h": 0.003
          }
        ]
      }
    }
  ]
}

If some projects fail and others succeed, the response includes both results and errors:

{
  "success": true,
  "results": [...],
  "errors": {
    "999": "No data returned"
  }
}

Request Parameters

Parameter	Type	Required	Default	Description
`project_ids`	number[]	Yes	-	Project IDs to analyze (1-5, positive integers)
`timeframes`	string[]	No	`["4H"]`	Timeframes for candle data
`include_ta`	boolean	No	`true`	Include full technical analysis indicators

Valid Timeframes

5m - 5-minute candles
15m - 15-minute candles
4H - 4-hour candles
1D - Daily candles

Candle Fields

Field	Description
`time`	Unix timestamp (seconds)
`open`, `close`, `high`, `low`	OHLC price data
`volume`	Trading volume
`momentum_score`	Composite momentum score
`rsi`	Relative Strength Index (0-100)
`macd`	MACD line value
`macd_signal`	MACD signal line
`macd_histogram`	MACD histogram (macd - signal)
`macd_velocity`	Rate of MACD change
`macd_acceleration`	Rate of velocity change
`macd_is_converging`	Whether MACD lines are converging
`macd_candles_till_cross`	Estimated candles until MACD crossover
`macd_cross_direction`	Expected cross direction (1 = bullish, -1 = bearish)
`bollinger_position`	Price position within Bollinger Bands (0-1)
`bollinger_squeeze`	Whether bands are in a squeeze
`bollinger_expanding`	Whether bands are expanding
`price_minus_vwap`	Price deviation from VWAP
`mindshare_24h`	Daily mindshare score (merged from daily data)
`mindshare_abs_change_24h`	Daily mindshare absolute change

Notes

Max 5 projects per request (batched internally)
Results are cached for 2 minutes
Mindshare data is merged at the daily level — intra-day candles inherit the mindshare of their UTC date

Virality Analysis

Analyze the virality and social mention velocity of terms or projects. Returns trend analysis, momentum signals, z-scores, and virality indicators. Optionally includes full timeseries bucket data with MACD-style moving averages.

POST /api/v1/data/virality

Auth: API Key or x402

Examples

Analyze Terms by Name/Symbol:

curl -X POST https://api.droyd.ai/api/v1/data/virality \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": ["BTC", "ETH", "SOL"],
    "search_type": "terms"
  }'

Analyze by Project IDs:

curl -X POST https://api.droyd.ai/api/v1/data/virality \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": ["6193", "34570"],
    "search_type": "project_id"
  }'

With Full Timeseries Data:

curl -X POST https://api.droyd.ai/api/v1/data/virality \
  -H "x-droyd-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": ["BTC", "ETH"],
    "search_type": "terms",
    "lookback_days": 30,
    "bucket_interval": "8 hours",
    "viral_threshold": 2.0,
    "include_timeseries": true
  }'

Response

{
  "success": true,
  "error": null,
  "analysis": {
    "generated_at": "2025-01-15T12:00:00Z",
    "period": {
      "start": "2024-12-16T12:00:00Z",
      "end": "2025-01-15T12:00:00Z",
      "bucket_interval": "08:00:00"
    },
    "viral_threshold": 2.0,
    "queries": [
      {
        "query": "BTC",
        "current": {
          "mention_count": 142,
          "velocity": 1.8,
          "z_score": 2.45,
          "hours_ago": 3.2
        },
        "stats": {
          "total_mentions": 8420,
          "avg_per_bucket": 93.5,
          "peak_mentions": 312,
          "peak_z_score": 4.12,
          "peak_velocity": 3.1,
          "viral_buckets": 3,
          "elevated_buckets": 12
        },
        "trend": {
          "first_elevated_at": "2025-01-10T08:00:00Z",
          "is_currently_elevated": true,
          "current_streak": 2,
          "trend_duration_hours": 120
        },
        "signals": {
          "trend": "bullish",
          "momentum": "accelerating",
          "virality": "elevated",
          "velocity_direction": "above_baseline",
          "trend_maturity": "developing",
          "trend_recency": "active_now"
        },
        "alert_level": "high",
        "summary": "BTC is trending upward with 8420 mentions..."
      }
    ]
  },
  "metadata": {
    "queries": ["BTC", "ETH"],
    "lookback_days": 30,
    "bucket_interval": "8 hours",
    "viral_threshold": 2.0,
    "queries_analyzed": 2,
    "viral_queries": [],
    "elevated_queries": ["BTC"]
  }
}

Request Parameters

Parameter	Type	Required	Default	Description
`queries`	string[]	Yes	-	Terms or project IDs to analyze (max 25)
`search_type`	string	Yes	-	`project_id` or `terms`
`lookback_days`	number	No	`30`	Days to look back (1-90)
`bucket_interval`	string	No	`8 hours`	Time bucket interval (e.g., "4 hours", "8 hours", "1 day")
`viral_threshold`	number	No	`2.0`	Z-score threshold for viral detection (0.5-10)
`include_timeseries`	boolean	No	`false`	Include full time-bucketed velocity data per query

Search Types

project_id - Fetches project records and builds query sets with [name, symbol] for comprehensive coverage
terms - Searches directly for the provided terms/symbols

Signal Values

Signal	Possible Values
`trend`	`strongly_bullish`, `bullish`, `neutral`, `bearish`, `strongly_bearish`
`momentum`	`accelerating_fast`, `accelerating`, `decelerating`, `decelerating_fast`
`virality`	`viral`, `elevated`, `above_average`, `normal`
`trend_maturity`	`no_trend`, `emerging`, `developing`, `established`, `mature`
`trend_recency`	`active_now`, `recent`, `cooling`, `cold`
`alert_level`	`critical`, `high`, `medium`, `low`

Timeseries Fields (when `include_timeseries: true`)

Timeseries rows are sorted chronologically (oldest first) and nested inside each query object.

Field	Description
`mention_count`	Raw mention count for the bucket
`fast_ma`	Fast moving average (3-period default)
`slow_ma`	Slow moving average (12-period default)
`velocity`	MACD-style velocity (fast_ma - slow_ma)
`signal_line`	Smoothed signal line
`acceleration`	Rate of change of velocity
`z_score`	Statistical deviation from mean
`pct_change`	Percent change from previous bucket

Projects

Projects

Project Search

POST Examples

GET Examples

Response

Request Parameters (POST)

Query Parameters (GET)

Valid Search Types

Project Filter

POST Examples

GET Examples

Response

Request Parameters (POST)

Query Parameters (GET)

Valid Sort Options

Tips

Watchlist

POST Examples

GET Examples

Response

Request Parameters (POST)

Query Parameters (GET)

Valid Scopes

Technical Analysis

Examples

Response

Request Parameters

Valid Timeframes

Candle Fields

Notes

Virality Analysis

Examples

Response

Request Parameters

Search Types

Signal Values

Timeseries Fields (when include_timeseries: true)

Timeseries Fields (when `include_timeseries: true`)