Skip to content

Crypto Search API

This endpoint allows you to search for crypto-related information using natural language queries.

Endpoint

POST /trending_projects

Request Parameters

ParameterTypeRequiredDescription
num_resultsintegerYesMaximum number of results to return
time_rangestringYesTime range for the search (e.g., "1d" for one day)

Example Request

{
  "num_results": 10,
  "time_range": "1d"
}

Response Structure

FieldTypeDescription
codeintegerResponse status code
messagestringResponse message
result.projectsarrayList of trending projects
result.projects[].idintegerProject ID
result.projects[].namestringProject name
result.projects[].summarystringProject description

Example Response

{
  "code": 200,
  "message": "success",
  "result": {
    "projects": [
      {
        "id": 123456,
        "name": "Cyber",
        "summary": "Cyber is a great project",
        "tokens": [
          {
            "chain": "ETH",
            "contract_address": "0x1234567890",
            "name": "Cyber",
            "symbol": "CYBER"
          }
        ],
        "tweet_summaries": [
          {
            "summary": "Cyber is a great project",
            "timestamp": 1710384000,
            "tweets": [
              {
                "tweet_at": 1710384000,
                "tweet_id": "1234567890",
                "twitter_id": "1234567890"
              }
            ]
          }
        ],
        "twitter_id": "123456"
      }
    ]
  }
}

Response Codes

Status CodeDescription
200Successful operation
400Bad Request - Invalid parameters
500Internal Server Error