API Overview

The Droyd API provides programmatic access to crypto research, project data, market screening, virality analysis, and autonomous trading.

Base URL: https://api.droyd.ai

Endpoints

Rate Limits

All rate limits are per API key, measured over a 15-minute window. Limits vary by subscription plan. x402 requests are not rate-limited. HTTP 429 is returned when the limit is exceeded.

See the full Rate Limits page for per-plan limits on every endpoint.

Error Responses

400 Bad Request:

{
  "error": "Validation failed",
  "details": [
    "query is required when search_mode is 'semantic'",
    "limit must be a number between 10 and 100"
  ]
}

401 Unauthorized:

{
  "error": "Invalid or missing API key"
}

402 Payment Required (x402):

Returned when accessing an x402-enabled endpoint without an API key. The response body contains payment instructions (price, recipient address, network). See the Authentication page for details.

429 Too Many Requests:

{
  "error": "Rate limit exceeded. Try again in 10 minutes."
}

500 Internal Server Error:

{
  "success": false,
  "error": "Internal server error"
}

Project Attributes Reference

Many project endpoints support customizable attributes via include_attributes:

Default: ["developments", "mindshare", "market_data"]

Valid Ecosystem Slugs

bitcoin, ethereum, solana, base, optimism, arbitrum, celestia, monad, binance-smart-chain, bsc, megaeth, eclipse, movement, aptos, sui, avalanche, polygon, scroll, berachain, sonic, hyperliquid, unichain, near, hedera, ronin, cosmos, ripple, bittensor, virtuals, telegram, ton, tron, cardano, zksync, blast, linea, stacks, celo, starknet, sei, farcaster, abstract

Valid Category Slugs

defi, derivatives, rwas, rwa, nfts, nft, gaming, ai, socialfi, daos, dao, memecoins, memecoin, stablecoins, stablecoin, ecosystems, rollups, rollup, zk, interoperability, depin, wallets, wallet, consumer, robotics, prediction-markets