API Reference

REST API

API Reference

Detailed documentation for the AirdropMatrix REST endpoints. Integrate directly with our backend to manage your projects, wallets, and matrix tasks.

AuthenticationAll API routes require authentication. Requests executed from the browser are automatically scoped to the authenticated user's active session.

Dashboard

Endpoints for retrieving aggregated data to populate the main matrix dashboard.

GET/api/dashboard-data

Fetch all projects, wallets, tasks, and completions for a given date.

Query Parameters

date	YYYY-MM-DD (e.g., 2026-03-15)

Projects

Manage airdrop project campaigns, networks, and base configurations.

POST/api/projects

Create a new project. Checks user limit before inserting.

Request Body

name	string (max 30 limits)
chain	string (e.g. Ethereum)

PUT/api/projects

Update project name or chain.

Request Body

id	uuid
name	string
chain	string

DELETE/api/projects

Archive a project and cascade the archive to its wallets and tasks. Records are preserved.

Query Parameters

uuid

POST/api/projects/duplicate

Duplicate a project with all its tasks. Promotes project wallets to global.

Request Body

uuid

Wallets

Manage your Web3 wallets across projects.

POST/api/wallets

Create a wallet. Optionally scope to a project via project_id.

Request Body

name	string
address	string (optional)
color_tag	string
project_id	uuid (optional)

PUT/api/wallets

Update wallet name, address, or color_tag.

Request Body

id	uuid
name	string
address	string
color_tag	string

DELETE/api/wallets

Archive a wallet while preserving the wallet and its completion history.

Query Parameters

uuid

Tasks

Manage actionable tasks tied to specific projects.

POST/api/tasks

Create a task. Checks both global (25) and per-project (5) limits.

Request Body

name	string
project_id	uuid
frequency	string (e.g. 1 day)
action_url	string
notes	string

PUT/api/tasks

Update task fields.

Request Body

id	uuid
name	string
frequency	string
action_url	string
notes	string
project_id	uuid

DELETE/api/tasks

Archive a task while preserving the task and its completion records.

Query Parameters

uuid

POST/api/tasks/toggle

Set, update, or clear a task completion for a specific wallet and date.

Request Body

task_id	uuid
wallet_id	uuid
date	YYYY-MM-DD
status	"done" \| "pending" \| "failed" \| null

Announcements

Retrieve platform-wide or user-specific announcements.

GET/api/announcements

Fetch active, non-expired announcements for the current user.