> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Research

> Conduct deep market research with fundamentals, trending data, sector analysis, and onchain analytics from CoinGecko API

<CardGroup cols={2}>
  <Card title="Set up your API key" icon="key" href="/docs/setting-up-your-api-key" horizontal arrow="true" />

  <Card title="Build faster with AI" icon="robot" href="/ai-integration#coding-agents" horizontal arrow="true" />
</CardGroup>

<Note>
  **TL;DR**<br />

  Use [/coins/\{id}](/reference/coins-id) for deep-dive fundamentals, [/coins/markets](/reference/coins-markets) for bulk screening, [/search/trending](/reference/trending-search) for momentum signals, [/coins/categories](/reference/coins-categories) for sector performance, and [/global](/reference/crypto-global) for the macro view.
</Note>

> Replace `YOUR_API_KEY` in the examples below with your actual key. [Get one here →](https://www.coingecko.com/en/api/pricing)

## Research Workflow

<Steps>
  <Step title="Macro overview — /global">
    Total market cap, BTC dominance, volume, and active coins. Frame your research in the context of overall market conditions.

    <Tabs>
      <Tab title="Pro API">
        ```bash theme={null}
        curl -X GET \
          "https://pro-api.coingecko.com/api/v3/global" \
          -H "x-cg-pro-api-key: YOUR_API_KEY"
        ```

        > [Global Data →](/reference/crypto-global)
      </Tab>

      <Tab title="Demo API">
        ```bash theme={null}
        curl -X GET \
          "https://api.coingecko.com/api/v3/global" \
          -H "x-cg-demo-api-key: YOUR_API_KEY"
        ```

        > [Global Data →](/demo/reference/crypto-global)
      </Tab>
    </Tabs>

    The `market_cap_percentage` field gives BTC and ETH dominance — a key signal for market rotation.
  </Step>

  <Step title="Spot momentum — /search/trending">
    Coins, NFTs, and categories trending in CoinGecko search over the last 24 hours.

    <Tabs>
      <Tab title="Pro API">
        ```bash theme={null}
        curl -X GET \
          "https://pro-api.coingecko.com/api/v3/search/trending" \
          -H "x-cg-pro-api-key: YOUR_API_KEY"
        ```

        > [Trending Search →](/reference/trending-search)
      </Tab>

      <Tab title="Demo API">
        ```bash theme={null}
        curl -X GET \
          "https://api.coingecko.com/api/v3/search/trending" \
          -H "x-cg-demo-api-key: YOUR_API_KEY"
        ```

        > [Trending Search →](/demo/reference/trending-search)
      </Tab>
    </Tabs>
  </Step>

  <Step title="Top movers — /coins/top_gainers_losers">
    Top 30 coins with the largest price gains and losses — spot breakout or breakdown opportunities.

    <Tabs>
      <Tab title="Pro API">
        ```bash theme={null}
        curl -X GET \
          "https://pro-api.coingecko.com/api/v3/coins/top_gainers_losers?vs_currency=usd&duration=24h" \
          -H "x-cg-pro-api-key: YOUR_API_KEY"
        ```

        > [Top Gainers/Losers →](/reference/coins-top-gainers-losers)
      </Tab>

      <Tab title="Demo API">
        <Callout icon="key" color="#FFC107" iconType="regular">
          `/coins/top_gainers_losers` is not available on the Demo API.<br />
          [Upgrade to Pro →](https://www.coingecko.com/en/api/pricing)
        </Callout>
      </Tab>
    </Tabs>

    | Key param  | Use                                          |
    | ---------- | -------------------------------------------- |
    | `duration` | `1h`, `24h`, `7d`, `14d`, `30d`, `60d`, `1y` |
  </Step>

  <Step title="Analyze sectors — /coins/categories">
    Category-level market cap, volume, and 24h change. Identify which sectors are leading or lagging.

    <Tabs>
      <Tab title="Pro API">
        ```bash theme={null}
        curl -X GET \
          "https://pro-api.coingecko.com/api/v3/coins/categories?order=market_cap_change_percentage_24h_desc" \
          -H "x-cg-pro-api-key: YOUR_API_KEY"
        ```

        > [Coin Categories →](/reference/coins-categories)
      </Tab>

      <Tab title="Demo API">
        ```bash theme={null}
        curl -X GET \
          "https://api.coingecko.com/api/v3/coins/categories?order=market_cap_change_percentage_24h_desc" \
          -H "x-cg-demo-api-key: YOUR_API_KEY"
        ```

        > [Coin Categories →](/demo/reference/coins-categories)
      </Tab>
    </Tabs>

    <Tip>
      Combine with `/coins/markets?category=layer-1` to drill into individual coins within a strong sector.
    </Tip>
  </Step>

  <Step title="Screen candidates — /coins/markets">
    Bulk market data for up to 250 coins per page — rankings, sparklines, and multi-timeframe changes.

    <Tabs>
      <Tab title="Pro API">
        ```bash theme={null}
        curl -X GET \
          "https://pro-api.coingecko.com/api/v3/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=100&sparkline=true&price_change_percentage=1h,24h,7d,30d" \
          -H "x-cg-pro-api-key: YOUR_API_KEY"
        ```

        > [Coins Markets →](/reference/coins-markets)
      </Tab>

      <Tab title="Demo API">
        ```bash theme={null}
        curl -X GET \
          "https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=100&sparkline=true&price_change_percentage=1h,24h,7d,30d" \
          -H "x-cg-demo-api-key: YOUR_API_KEY"
        ```

        > [Coins Markets →](/demo/reference/coins-markets)
      </Tab>
    </Tabs>

    | Key param                 | Use                                                                        |
    | ------------------------- | -------------------------------------------------------------------------- |
    | `order`                   | `market_cap_desc`, `volume_desc`, `market_cap_asc`                         |
    | `category`                | Filter to a specific sector (e.g. `layer-1`, `decentralized-finance-defi`) |
    | `sparkline`               | 7-day sparkline data for quick visual scanning                             |
    | `price_change_percentage` | `1h,24h,7d,30d` for multi-timeframe momentum                               |
  </Step>

  <Step title="Deep-dive fundamentals — /coins/{id}">
    The most comprehensive endpoint for a single coin — ATH/ATL, supply, volume, community data, and developer activity in one call.

    <Tabs>
      <Tab title="Pro API">
        ```bash theme={null}
        curl -X GET \
          "https://pro-api.coingecko.com/api/v3/coins/bitcoin?localization=false&tickers=false&community_data=true&developer_data=true" \
          -H "x-cg-pro-api-key: YOUR_API_KEY"
        ```

        > [Coin Data →](/reference/coins-id)
      </Tab>

      <Tab title="Demo API">
        ```bash theme={null}
        curl -X GET \
          "https://api.coingecko.com/api/v3/coins/bitcoin?localization=false&tickers=false&community_data=true&developer_data=true" \
          -H "x-cg-demo-api-key: YOUR_API_KEY"
        ```

        > [Coin Data →](/demo/reference/coins-id)
      </Tab>
    </Tabs>

    | Key param        | Use                                                     |
    | ---------------- | ------------------------------------------------------- |
    | `localization`   | `false` to reduce response size                         |
    | `tickers`        | `false` if you don't need exchange ticker data          |
    | `community_data` | Twitter followers, Reddit subscribers, Telegram members |
    | `developer_data` | GitHub commits, stars, forks, contributors              |
  </Step>

  <Step title="Backtest with history — /coins/{id}/ohlc/range or /market_chart">
    OHLC candles for a custom date range, or price + volume + market cap time series.

    * **OHLC candles** for a custom range:

    <Tabs>
      <Tab title="Pro API">
        ```bash theme={null}
        curl -X GET \
          "https://pro-api.coingecko.com/api/v3/coins/ethereum/ohlc/range?vs_currency=usd&from=2024-01-01&to=2024-12-31&interval=daily" \
          -H "x-cg-pro-api-key: YOUR_API_KEY"
        ```

        > [OHLC Range →](/reference/coins-id-ohlc-range)
      </Tab>

      <Tab title="Demo API">
        <Callout icon="key" color="#FFC107" iconType="regular">
          `/coins/{id}/ohlc/range` is not available on the Demo API.<br />
          [Upgrade to Pro →](https://www.coingecko.com/en/api/pricing)
        </Callout>
      </Tab>
    </Tabs>

    * **Price + volume + market cap** over time:

    <Tabs>
      <Tab title="Pro API">
        ```bash theme={null}
        curl -X GET \
          "https://pro-api.coingecko.com/api/v3/coins/solana/market_chart?vs_currency=usd&days=365&interval=daily" \
          -H "x-cg-pro-api-key: YOUR_API_KEY"
        ```

        > [Coin Market Chart →](/reference/coins-id-market-chart)
      </Tab>

      <Tab title="Demo API">
        ```bash theme={null}
        curl -X GET \
          "https://api.coingecko.com/api/v3/coins/solana/market_chart?vs_currency=usd&days=365&interval=daily" \
          -H "x-cg-demo-api-key: YOUR_API_KEY"
        ```

        > [Coin Market Chart →](/demo/reference/coins-id-market-chart)
      </Tab>
    </Tabs>
  </Step>
</Steps>

***

## Onchain Research

<Steps>
  <Step title="Trending pools — /onchain/networks/trending_pools">
    Hottest liquidity pools across all networks — spot early DeFi momentum before it shows up in CoinGecko's main listings.

    <Tabs>
      <Tab title="Pro API">
        ```bash theme={null}
        curl -X GET \
          "https://pro-api.coingecko.com/api/v3/onchain/networks/trending_pools?include=base_token&duration=24h" \
          -H "x-cg-pro-api-key: YOUR_API_KEY"
        ```

        > [Trending Pools →](/reference/trending-pools-list)
      </Tab>

      <Tab title="Demo API">
        ```bash theme={null}
        curl -X GET \
          "https://api.coingecko.com/api/v3/onchain/networks/trending_pools?include=base_token&duration=24h" \
          -H "x-cg-demo-api-key: YOUR_API_KEY"
        ```

        > [Trending Pools →](/demo/reference/trending-pools-list)
      </Tab>
    </Tabs>

    | Key param  | Use                                                              |
    | ---------- | ---------------------------------------------------------------- |
    | `include`  | `base_token`, `quote_token`, `dex`, `network` for richer context |
    | `duration` | `1h`, `6h`, or `24h` trending window                             |
  </Step>

  <Step title="Token fundamentals — /onchain/.../tokens/{address}/info">
    Metadata for any onchain token — description, socials, websites, and GeckoTerminal analytics score.

    <Tabs>
      <Tab title="Pro API">
        ```bash theme={null}
        curl -X GET \
          "https://pro-api.coingecko.com/api/v3/onchain/networks/eth/tokens/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/info" \
          -H "x-cg-pro-api-key: YOUR_API_KEY"
        ```

        > [Token Info →](/reference/token-info-contract-address)
      </Tab>

      <Tab title="Demo API">
        ```bash theme={null}
        curl -X GET \
          "https://api.coingecko.com/api/v3/onchain/networks/eth/tokens/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/info" \
          -H "x-cg-demo-api-key: YOUR_API_KEY"
        ```

        > [Token Info →](/demo/reference/token-info-contract-address)
      </Tab>
    </Tabs>

    <Tip>
      Combine with [Pool OHLCV](/reference/pool-ohlcv-contract-address) for a complete onchain research workflow — fundamentals from token info, price action from OHLCV.
    </Tip>
  </Step>
</Steps>