gate-exchange-candydrop

Original：🇺🇸 English

Translated

1 scripts

Gate CandyDrop activity operations guide. Use this skill whenever users want to browse CandyDrop activities, view activity rules, register for activities, check task completion progress, or query participation and airdrop records. Trigger phrases include: candydrop, candydrop activities, activity list, register for candydrop, task progress, participation records, airdrop records.

4installs

Sourcegate/gate-skills

Added on2026-08-25

NPX Install

npx skill4agent add gate/gate-skills gate-exchange-candydrop

SKILL.md Content

View Translation Comparison →

Resolving

gate-cli

(binary path)

Resolve gate-cli
in order: (1) command -v gate-cli
and gate-cli --version
succeeds; (2) ${HOME}/.local/bin/gate-cli
if executable; (3) ${HOME}/.openclaw/skills/bin/gate-cli
if executable. Canonical rules:

exchange-runtime-rules.md

§4 (or

gate-runtime-rules.md

§4).

Gate Exchange CandyDrop

Authoring language: This skill’s instructions and reference prose are written in English (Gate skill standard). End-user replies still follow Language adaptation (match the user’s locale).

General Rules

⚠️ STOP — You MUST read and strictly follow the shared runtime rules before proceeding. Do NOT select or call any tool until all rules are read. These rules have the highest priority. → Read gate-runtime-rules.md

Only use the
gate-cli
commands explicitly listed in this skill. Commands not documented here must NOT be run for these workflows, even if other interfaces expose them.

Skill Dependencies

gate-cli commands used

Query Operations (Read-only, Public)

gate-cli cex launch candy-drop activities

```
gate-cli cex launch candy-drop rules
```

Query Operations (Read-only, Auth Required)

```
gate-cli cex launch candy-drop progress
```

gate-cli cex launch candy-drop participations

```
gate-cli cex launch candy-drop airdrops
```

Execution Operations (Write)

```
gate-cli cex launch candy-drop register
```

Authentication

Interactive file setup: when GATE_API_KEY
and GATE_API_SECRET
are not both set on the host, run gate-cli config init
to complete the wizard for API key, secret, profiles, and defaults (see gate-cli).
Env / flags: gate-cli config init
is not required when credentials are already supplied — e.g. both GATE_API_KEY
and GATE_API_SECRET
set on the host, or --api-key
/ --api-secret
where supported — never ask the user to paste secrets into chat.
Permissions: Launch:Write
Portal: create or rotate keys outside the chat: https://www.gate.com/myaccount/profile/api-key/manage

Installation Check

Required: Gate (main), Gate (trading); gate-cli
when using CLI-backed flows (install via
```
setup.sh
```
from this skill when applicable).

Install (MCP / IDE): Run installer skill for your environment — Cursor:

gate-mcp-cursor-installer

; Codex:

gate-mcp-codex-installer

; Claude:

gate-mcp-claude-installer

; OpenClaw:

gate-mcp-openclaw-installer

Credentials: When GATE_API_KEY
and GATE_API_SECRET
are both set (non-empty) for the host, do not require gate-cli config init
— that is equivalent valid config for
```
gate-cli
```
. When both are unset or empty, remind the operator to run gate-cli config init
or to configure GATE_API_KEY
/ GATE_API_SECRET
in the matching skill from the skill library (never ask the user to paste secrets into chat).
Sanity check: Before authenticated or mutating calls, confirm the runtime works (e.g. gate-cli --version
or a read-only check appropriate to this skill); resolve credentials before registration or write operations.

Execution mode

Read and strictly follow

references/gate-cli.md

, then execute this skill's CandyDrop workflow.

```
SKILL.md
```
keeps routing and product semantics.
```
references/gate-cli.md
```
is the authoritative
```
gate-cli
```
execution contract for activity/rule queries, registration confirmation gates, progress/record queries, and result verification.

Module overview

Module	Description	Trigger keywords
Activity List	Browse CandyDrop activities, filter by status/coin/task type	`candydrop` , `candydrop activities` , `activity list` , `ongoing candydrop` , `USDT candydrop`
Activity Rules	View activity rules, prize pools, and tasks	`activity rules` , `task rules` , `prize pool` , `reward rules` , `candydrop rules`
Register	Register for a CandyDrop activity	`register` , `join activity` , `candydrop register` , `participate candydrop`
Task Progress	Query task completion progress for enrolled activities	`task progress` , `completion progress` , `progress query` , `task progress`
Participation Records	Query registration/participation history	`participation records` , `registration records` , `history records` , `participation records`
Airdrop Records	Query airdrop/reward distribution records	`airdrop records` , `reward records` , `received records` , `airdrop records`

Domain Knowledge

CandyDrop concepts

Concept	Description
CandyDrop	A Gate activity platform where users complete tasks (trading, depositing, etc.) to earn airdrop rewards from prize pools.
Activity ( `currency` / `activity_id` )	A CandyDrop campaign for a specific token. Identified by `currency` (token symbol) or `activity_id` (numeric ID).
Activity Status	Lifecycle: `upcoming` (upcoming) → `ongoing` (ongoing) → `ended` (ended).
Registration Status	`registered` (already registered) or `unregistered` (not yet registered).
Record Status	For participation records: `ongoing` (in progress), `awaiting_draw` (awaiting draw), `won` (won), `not_win` (not won).
Prize Pool	Each activity has one or more prize pools, each with a total prize amount ( `prize_all` ), per-user cap ( `prize_limit` ), and a list of tasks.
Task	Individual challenges within a prize pool (e.g. spot trading, futures trading, deposit, invite). Each has a name ( `task_name` ), description ( `task_desc` ), and exclusive label ( `exclusive_label` ).
Task Progress	The user's current completion value for a task (e.g. trading volume, deposit amount). Only shown for registered tasks ( `task_status > 0` ).

Timestamp formatting

API returns time fields (e.g.
```
start_time
```
,
```
end_time
```
,
```
register_time
```
,
```
airdrop_time
```
) as pre-formatted UTC strings in the format
```
YYYY-MM-DD HH:MM:SS(UTC)
```
.
Tables / lists: Put
```
(UTC)
```
in the column header when the time is UTC. If the header already says
```
(UTC)
```
(ASCII or full-width punctuation variants), do not repeat it on every cell: strip a trailing
```
(UTC)
```
from the API value and show YYYY-MM-DD HH:MM:SS
only (example:
```
2026-04-13 04:04:10
```
, not
```
2026-04-13 04:04:10(UTC)
```
). If the header does not mark UTC, keep the API string as-is so the zone is not lost.
Other surfaces (e.g. inline sentences without a UTC-labeled header): you may keep the API form or use header + stripped cell style consistently within one reply.
Query parameters
```
start_time
```
/
```
end_time
```
for records are integer unix timestamps (seconds). See Timestamp strategy in
```
references/records.md
```
for correct computation.

Number formatting

Category	Precision	Examples
Amounts (rewards, progress values)	8 decimals, trailing zeros removed	`1.23` not `1.23000000`
Airdrop `rewards` (display)	Same numeric formatting, then append + row `currency`	`4.02032 ETH` not `4.02032`
Percentage-like fields	2 decimals, trailing zeros retained	`5.20%` not `5.2%`

Dual-parameter resolution

Activity query interfaces support locating an activity by either

activity_id

currency

```
currency
```
(e.g. "USDT"): API auto-matches the nearest active activity for that token.
```
activity_id
```
: Precise numeric ID lookup.
Priority:
```
currency
```
is preferred. If user provides both, use both. If only
```
activity_id
```
is given, use it directly. If neither is provided for rules/progress, ask the user for
```
currency
```
.

Routing rules

Intent	Example phrases	Route to
Browse activities	"Show CandyDrop activities", "ongoing candydrop events", "USDT candydrop"	Read `references/activities.md`
Activity rules	"Show CandyDrop rules", "what tasks are in this candydrop", "prize pool details"	Read `references/activities.md`
Register	"Register for CandyDrop USDT", "join this candydrop activity"	Read `references/register.md`
Task progress	"My CandyDrop task progress", "check my candydrop task progress"	Read `references/progress.md`
Participation records	"My CandyDrop participation history", "registration records"	Read `references/records.md`
Airdrop records	"My CandyDrop airdrop rewards", "view airdrop records"	Read `references/records.md`
Unclear	"CandyDrop"	Clarify: browse / rules / register / progress / records, then route. If defaulting to browse/list, reply with minimal activity list only (see `references/activities.md` → Activity list — answer directly).

Execution

1. Intent and parameters

Determine module (Activity List / Activity Rules / Register / Task Progress / Participation Records / Airdrop Records).
Register intent: Route to
```
references/register.md
```
. Requires
```
currency
```
(required) and optionally
```
activity_id
```
. Must follow Preview-Confirm flow.

Records intent: Route to

references/records.md

. Extract

currency

status

start_time

end_time

page

limit

Extract parameters:

currency

activity_id

status

rule_name

register_status

limit

offset

page

start_time

end_time

Missing: If user says "CandyDrop" without specifying intent, ask which operation or show activities by default — if showing the list, use concise output (title + table, no glossary; see
```
references/activities.md
```
).

2. Tool selection

Module	MCP tool	Required params	Optional params
Activity List	`gate-cli cex launch candy-drop activities`	—	`currency` , `status` , `rule_name` , `register_status` , `limit` , `offset`
Activity Rules	`gate-cli cex launch candy-drop rules`	`currency` or `activity_id` (at least one)	—
Register	`gate-cli cex launch candy-drop register`	`currency`	`activity_id`
Task Progress	`gate-cli cex launch candy-drop progress`	`currency` or `activity_id` (at least one)	—
Participation Records	`gate-cli cex launch candy-drop participations`	—	`currency` , `status` , `start_time` , `end_time` , `page` , `limit`
Airdrop Records	`gate-cli cex launch candy-drop airdrops`	—	`currency` , `start_time` , `end_time` , `page` , `limit`

Register: Show registration preview, wait for confirmation, then call
```
gate-cli cex launch candy-drop register
```
.
Records: Follow the Timestamp strategy in
```
references/records.md
```
for time parameter computation.

3. Format response

Use the Response Template and field names from the reference file for the chosen module.
Activity List: Optional one-line title + data table; for browse / “what activities are there” intents, no tutorial, field glossary, or pasting the task-type map — localize
```
rule_name
```
only inside cells. Fields:
```
currency
```
,
```
total_rewards
```
,
```
start_time
```
,
```
end_time
```
,
```
rule_name
```
,
```
participants
```
,
```
user_max_rewards
```
.

Activity Rules: show

currency

total_rewards

start_time

end_time

, and per prize pool:

prize_all

prize_limit

tasks

Task Progress: show

currency

total_rewards

start_time

end_time

, and per task:

task_name

task_desc

value

Participation Records: show
```
currency
```
,
```
status
```
,
```
register_time
```
,
```
id
```
(time cells: strip trailing
```
(UTC)
```
when the table header already marks UTC — see Timestamp formatting above).
Airdrop Records: show
```
currency
```
,
```
airdrop_time
```
, rewards
with token unit (
```
{rewards} {currency}
```
) only — do not show flash-convert / USDT (
```
convert_amount
```
) (see
```
references/records.md
```
).

Report template

After each operation, output a short standardized result consistent with the reference (e.g. activity list, rules, registration confirmation, progress, records). Activity list answers stay minimal (see

references/activities.md

). Use the API field names and semantic values; where the reference requires localization (e.g. rule_name
task types), render in the user’s language per

references/activities.md

without embedding the whole mapping as user-visible prose.

Language adaptation: Always respond in the same language as the user's input. The Response Templates in reference files define the structure and fields to display, not the literal output language. Translate all display labels to match the user's language.

Must localize (not tickers / not “keep English”):

rule_name
entries in the activity list (and anywhere shown as “task type”): use the Task types mapping table in
```
references/activities.md
```
— these strings describe product task categories (e.g. Futures, Simple Earn), not token symbols.

Do NOT translate (keep as-is regardless of language):

Product name:
```
CandyDrop
```
Currency symbols from API: USDT, GT, BTC, DOGE, etc.
Technical IDs and their values:
```
id
```
,
```
activity_id
```
(internal use, do NOT display unless relevant)
Timestamp layout
```
YYYY-MM-DD HH:MM:SS
```
and the literal
```
(UTC)
```
token when it must remain visible (e.g. no UTC in header); do not drop timezone information in those cases
API error labels:
```
INVALID_PARAM_VALUE
```
,
```
SERVER_ERROR
```
Numeric values, percentages, and the unit
```
USD
```
in thresholds

All other display labels should be translated to match the user's language.

Error Handling

API error labels

The API returns structured errors with a

label

field. Map them as follows:

API label	User-facing message
`INVALID_PARAM_VALUE`	"Invalid request parameters. Please check your input and try again."
`SERVER_ERROR`	"System busy. Please try again later."
`Activity not found`	"Activity not found. Please check the currency or activity ID."
`currency is required`	"Please provide a currency name (e.g. USDT)."
`Device token is required`	"Registration requires a device token. Please try from the Gate app or website."

Empty result handling

Scenario	Action
Empty activity list	"No CandyDrop activities match your criteria. Try different filters or check back later."
Empty participation records	"You have no CandyDrop participation records. Browse active activities to get started."
Empty airdrop records	"No airdrop rewards found. Rewards are typically distributed after the activity ends."
Compliance restriction	"Due to compliance restrictions, CandyDrop is not available in your region."
API error / 401	"Unable to fetch CandyDrop data. Please log in and try again."

Safety rules

Confirmation required

Register is a write operation. Before calling
```
gate-cli cex launch candy-drop register
```
, MUST show a registration preview and wait for explicit user confirmation.
Preview format: activity currency, activity ID (if known).
Ask user to reply "confirm" to proceed or "cancel" to abort.
Only call the API after receiving explicit confirmation.

Compliance

When the API returns a compliance or region restriction error, display a friendly message: "Due to compliance restrictions, CandyDrop is not available in your region." Do NOT retry.

Data integrity

Preserve
```
currency
```
and
```
activity_id
```
exactly as the user provided.
Do NOT fabricate activity data, reward amounts, or task progress.
Only display data returned by actual API responses.