API Reference
  1. PirateCrew Blockchain API (v2)
  2. airdrops

Create an on-chain airdrop config

post
https://api.piratecrew.fun/v2/airdrops

Builds the initializeAirdrop transaction for the Pirates Anchor program. With mode: unsigned the caller signs and submits; with mode: signed the server signs via Privy and broadcasts (requires airdrop:admin scope). Replaces v1 /airdrops/init.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
^[1-9A-HJ-NP-Za-km-z]{32,44}$
string
required
length between 1 and 64
string
required
^[1-9A-HJ-NP-Za-km-z]{32,44}$
integer
required
0 to 65535
string
required

32-byte merkle root, hex (with or without 0x prefix).

string
enum
Defaults to unsigned

unsigned returns a base64 VersionedTransaction the client signs; signed has the server sign + submit via Privy (requires the relevant *:signed scope).

Allowed:
string
length between 1 and 128
^[A-Za-z0-9_\-.:]+$

Optional client-supplied identifier echoed on the response. Prefer metadata for richer reconciliation.

metadata
object

Free-form string key/value bag echoed back on responses and webhook events.

Headers
string
length between 1 and 128

Optional client-supplied request ID, echoed in X-Request-Id response header.

string
length between 1 and 255

Client-supplied key (UUID v4 recommended) for safe write retries. Server stores (key, request_hash, response) and replays. Reusing with a different body returns 409 idempotency_conflict.

Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?