> For the complete documentation index, see [llms.txt](https://docs.engages.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.engages.io/engage-discord/social-quests/other-platforms/coinmarketcap.md).

# CoinMarketCap

Launch a CoinMarketCap quest with **`/coinmarketcap`**.

{% hint style="info" %}
**Pro plan only.** CoinMarketCap integration is part of the Pro plan. Upgrade on the [Engage Teams page](https://www.engages.io/teams) to unlock it.
{% endhint %}

## Required input

* **`post_link`** – CoinMarketCap Gravity post URL (e.g. `https://coinmarketcap.com/community/post/375571289`).
* **`type`** – Which interactions members must complete:
  * `Reaction`
  * `Repost`
  * `Comment`
  * `Reaction & Repost & Comment`
  * `Reaction & Comment`
  * `Reaction & Repost`
  * `Repost & Comment`
* **`duration`** – How long the quest stays claimable (1h / 4h / 6h / 12h / 24h / 48h / 72h).

## Optional input

* **`total-points`** – Points awarded when a user completes **every** required task.
* **`note`** – Custom note appended to the quest embed.

## What members do

When a CoinMarketCap quest is posted, members go to the CMC post and complete the required interactions (any combination of Reaction, Repost, Comment). Then they click the **Verify** button on the Engage embed.

Engage hits the CoinMarketCap API with the user's connected handle (`/set coinmarketcap`) and confirms each interaction:

* Reaction → checks the user's "Likes" feed for the target post.
* Repost → checks the user's posts feed for a repost of the target.
* Comment → checks the user's comments feed for a reply on the target.

If everything checks out, the user receives the configured `total-points` and is added to the post's claimers list. Each CoinMarketCap account and Discord ID can only claim a quest **once**.

## Setup steps for users

{% stepper %}
{% step %}

#### Connect CoinMarketCap

Run `/set coinmarketcap account:<your-cmc-username>` once. Your CMC account is global across servers.
{% endstep %}

{% step %}

#### Open the quest

Click the CMC button on the quest embed and complete every required interaction on the post.
{% endstep %}

{% step %}

#### Verify

Click the **Verify** button on the embed. Engage will tell you exactly which tasks are still missing if you click too early.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
You can't claim a CoinMarketCap quest on **your own** post — the bot blocks owners from earning points on their own content.
{% endhint %}