API Reference
  1. PirateCrew Blockchain API (v2)
  2. gold-locks

Lock GOLD and mint veGOLD

post
https://api.piratecrew.fun/v2/gold-locks

Builds an unsigned tx that locks the supplied amount of GOLD for lock_duration_days and mints veGOLD to the user. The user wallet must sign; mode=signed is rejected.

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}$

User wallet locking GOLD; signs the returned tx.

string
required
length between 1 and 64
string
required
^\d+$

Amount of GOLD to lock, as a u64-safe decimal string.

integer
required
1 to 1460

Lock duration in whole days (1–1460).

integer
≥ 0
Defaults to 0
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?