search

Coins

hashtag
1. Search Coins

GET https://api.qa.trendmoon.ai/coins/search

Description:

  • Search coins by optional filters: name, symbol, category, chain, and contract_address. If all filters are None, returns all coins sorted by market cap rank.

Parameters:

  • name (string, optional): Filter by coin name (case-insensitive).

  • symbol (string, optional): Filter by coin symbol (case-insensitive).

  • category (string, optional): Filter by coin category (case-insensitive).

  • chain (string, optional): Filter by blockchain platform (e.g., ethereum, binance-smart-chain).

  • contract_address (string, optional): Filter by contract address (works across all platforms).

Example request:

curl -X GET 'https://api.qa.trendmoon.ai/coins/search?name=solana' \
     -H 'accept: application/json' \
     -H 'Api-key: YOUR_API_KEY'

Response: 

[
  {
    "id": "solana",
    "symbol": "sol",
    "name": "Solana",
    "web_slug": "solana",
    "asset_platform_id": null,
    "platforms": {},
    "detail_platforms": {},
    "block_time_in_minutes": 0,
    "hashing_algorithm": null,
    "categories": [
      "Smart Contract Platform",
      "Solana Ecosystem",
      "Layer 1 (L1)",
      "Alleged SEC Securities",
      "FTX Holdings",
      "Multicoin Capital Portfolio",
      "Proof of Stake (PoS)",
      "Alameda Research Portfolio",
      "Andreessen Horowitz (a16z) Portfolio",
      "GMCI Layer 1 Index",
      "GMCI 30 Index",
      "Delphi Ventures Portfolio",
      "GMCI Index",
      "Polychain Capital Portfolio",
      "Made in USA"
    ],
    "preview_listing": false,
    "public_notice": null,
    "additional_notices": [],
    "description": {
      "en": "Solana is a highly functional open source project that banks on blockchain technology’s permissionless nature to provide decentralized finance (DeFi) solutions. It is a layer 1 network that offers fast speeds and affordable costs. While the idea and initial work on the project began in 2017, Solana was officially launched in March 2020 by the Solana Foundation with headquarters in Geneva, Switzerland."
    },
    "links": {
      "homepage": [
        "https://solana.com/"
      ],
      "whitepaper": null,
      "blockchain_site": [
        "https://solscan.io/",
        "https://platform.arkhamintelligence.com/explorer/token/solana",
        "https://xray.helius.xyz/",
        "https://solana.fm/",
        "https://solanabeach.io/",
        "https://www.oklink.com/sol",
        "https://explorer.solana.com/"
      ],
      "official_forum_url": [],
      "chat_url": [],
      "announcement_url": [],
      "twitter_screen_name": "solana",
      "facebook_username": null,
      "telegram_channel_identifier": "solana",
      "subreddit_url": "https://www.reddit.com/r/solana",
      "repos_url": {
        "github": [
          "https://github.com/solana-labs/solana"
        ]
      }
    },
    "image": {
      "thumb": "https://coin-images.coingecko.com/coins/images/4128/thumb/solana.png?1718769756",
      "small": "https://coin-images.coingecko.com/coins/images/4128/small/solana.png?1718769756",
      "large": "https://coin-images.coingecko.com/coins/images/4128/large/solana.png?1718769756"
    },
    "country_origin": null,
    "genesis_date": null,
    "contract_address": null,
    "sentiment_votes_up_percentage": 74.58,
    "sentiment_votes_down_percentage": 25.42,
    "market_cap_rank": 5,
    "community_data": {
      "twitter_followers": 3249125,
      "telegram_channel_user_count": 71662,
      "reddit_subscribers": 0
    },
    "developer_data": {
      "forks": 3516,
      "stars": 11071,
      "subscribers": 276,
      "total_issues": 5177,
      "closed_issues": 4611,
      "pull_requests_merged": 23614,
      "pull_request_contributors": 411,
      "code_additions_deletions_4_weeks": {
        "additions": 10193,
        "deletions": -5277
      },
      "commit_count_4_weeks": 171
    },
    "last_updated": "2025-02-11T16:07:46.626000Z",
    "total_supply": 593782049.1795594,
    "max_supply": null,
    "circulating_supply": 488074401.5869571,
    "market_cap": 97248794346,
    "fully_diluted_valuation": 118311036595,
    "market_cap_fdv_ratio": 0.8200000000000001,
    "mcap_to_tvl_ratio": null,
    "fdv_to_tvl_ratio": null
  }
]

Response Fields:

  • id (string): Unique identifier for the coin, typically matching the Coingecko ID.

  • name (string): Full name of the cryptocurrency (e.g., "Bitcoin", "Ethereum").

  • symbol (string): Trading symbol of the cryptocurrency (e.g., "BTC", "ETH").

  • market_cap_rank (integer): Market capitalization rank among all cryptocurrencies.

  • contract_address (string or null): The primary blockchain contract address if the coin is a token. Null for native blockchain coins like Bitcoin.

  • platforms (array of strings): List of blockchain platforms where this coin/token is available.

  • categories (array of strings): Categories that describe the coin's use case or technology (e.g., "Layer 1", "DeFi", "Smart Contract Platform").

  • image (object): URLs to various sizes of the coin's logo image.

    • thumb (string): URL to thumbnail-sized image.

    • small (string): URL to small-sized image.

    • large (string): URL to large-sized image.

  • market_data (object): Current market information about the coin.

    • current_price (object): Current trading price in different currencies.

      • usd (number): Price in US dollars.

      • Additional currencies may be included.

    • market_cap (object): Total market capitalization in different currencies.

      • usd (number): Market cap in US dollars.

      • Additional currencies may be included.

    • total_volume (object): Trading volume in different currencies.

      • usd (number): 24-hour trading volume in US dollars.

      • Additional currencies may be included.

    • price_change_percentage_24h (number): Price change percentage in the last 24 hours.

    • price_change_percentage_7d (number): Price change percentage in the last 7 days.

    • Additional time periods may be included.

  • description (object): Textual descriptions of the cryptocurrency.

    • en (string): English description of the coin, its technology, and use cases.

    • Additional languages may be included.

  • links (object): Various web links related to the project.

    • homepage (array of strings): Official website URLs.

    • blockchain_site (array of strings): Block explorer URLs.

    • twitter_screen_name (string): Twitter handle without the @ symbol.

    • telegram_channel_identifier (string): Telegram channel name.

    • subreddit_url (string): URL to the project's subreddit.

    • Additional social media and community links may be included.

  • contracts (object, optional): Detailed contract addresses across multiple platforms.

    • Each key is a platform name (e.g., "ethereum", "binance-smart-chain").

    • Each value is the corresponding contract address on that platform.

  • community_data (object, optional): Statistics about the project's community.

    • twitter_followers (integer): Number of Twitter followers.

    • telegram_channel_user_count (integer): Number of Telegram channel members.

    • reddit_subscribers (integer): Number of subreddit subscribers.

    • Additional community metrics may be included.

  • developer_data (object, optional): Statistics about development activity.

    • github_stats (object): GitHub repository statistics.

    • commit_count_4_weeks (integer): Number of commits in the last 4 weeks.

    • Additional development metrics may be included.

Note: Some fields may be null or missing if the data is not available for a particular coin.

hashtag

hashtag
2. Get Platforms

Description:

  • Get a list of all blockchain platforms that have coins in the index. This can be used to populate dropdown menus for the chain parameter in the search endpoint.

Example request:

Example Response:

Telegram-related metrics:

  • hour_social_perc_diff: Percentage change in social mentions over the last hour in Telegram groups

  • day_social_perc_diff: Percentage change in social mentions over the last 24 hours in Telegram groups

  • sentiment_score: Aggregated sentiment analysis score from Telegram messages (0-1, where 1 is most positive)

  • symbol_count: Number of times the coin's symbol was mentioned in Telegram

  • name_count: Number of times the coin's name was mentioned in Telegram

  • social_mentions: Total number of mentions (both symbol and name) in Telegram

  • social_dominance: Percentage of all crypto discussions that mention this coin (0-1)

  • relative_social_dominance: Social dominance compared to the average of all tracked coins

LunarCrush metrics (prefixed with lc_):

  • lc_posts_created: Number of new social media posts about the coin

  • lc_posts_active: Number of active discussions about the coin

  • lc_interactions: Total social media engagements (likes, comments, shares)

  • lc_contributors_created: Number of unique users creating content about the coin

  • lc_contributors_active: Number of unique users engaging with content about the coin

  • lc_sentiment: LunarCrush's sentiment analysis score (0-1)

  • lc_social_dominance: LunarCrush's social dominance metric

  • lc_social_volume_24h: Total social media volume in the last 24 hours

  • lc_galaxy_score: LunarCrush's proprietary scoring (0-100)

  • lc_galaxy_score_previous: Previous period's galaxy score

  • lc_alt_rank: Alternative ranking based on social metrics

  • lc_alt_rank_previous: Previous period's alt rank

hashtag
3. Get Coin Details

Description:

  • Retrieves comprehensive information about a specific cryptocurrency or token. This endpoint provides detailed data including market statistics, social metrics, project description, and links to relevant resources. You can identify the coin using one of several identifiers, with the system trying them in order of specificity.

Parameters:

  • contract_address (string, optional): The blockchain contract address of the token. This is the most specific identifier for tokens and works across all supported platforms.

  • coin_id (string, optional): The Coingecko coin ID. This is a very specific identifier that uniquely identifies a coin in the database.

  • symbol (string, optional): The trading symbol of the coin (e.g., BTC, ETH). Note that symbols are not always unique; if multiple coins share the same symbol, the endpoint will return the one with the highest market cap.

  • project_name (string, optional): The full name of the project (e.g., Bitcoin, Ethereum). This is the least specific identifier.

Note: At least one of these parameters must be provided.

Example request:

Response:

Same response fields as Coins search endpoint

PreviousChatsNextProcessed Insights

Last updated