woopwoop

Creator tools and refunds

Take unlocked coins, lock for longer, and refunds, through the API.

A coin's creator can do through the API everything they can on the coin page. Each one returns a BuiltTransaction: the creator's wallet signs it, then you send it to /api/v1/transactions.

How the creator's coins work

Everything the creator buys before graduation (their first buy in the fair opening included) is locked. After graduation it unlocks an equal part each day over unlockDays (10 by default), after cliffDays (0 by default). The creator can't sell on the curve.

See where a creator stands with GET /api/v1/coins/{mint}/curve: its creator object has locked, claimed and claimable, plus the lock's days.

Take unlocked coins

bash
curl https://usewoop.xyz/api/v1/creator/claim \
  -H "Authorization: Bearer woop_…" \
  -H "Content-Type: application/json" \
  -d '{ "wallet": "<creator>", "mint": "7xKX…" }'

Sends whatever has unlocked so far to the creator's wallet.

Lock for longer

bash
curl https://usewoop.xyz/api/v1/creator/lock \
  -H "Authorization: Bearer woop_…" \
  -H "Content-Type: application/json" \
  -d '{ "wallet": "<creator>", "mint": "7xKX…", "unlockDays": 30, "cliffDays": 7 }'

A lock can only grow: longer, never shorter. Holders see the new lock on the coin page.

Creator fees

The creator earns on every trade, before and after graduation. Fees are paid out automatically about every 10 minutes, with nothing to claim. GET /api/v1/coins/{mint}/curve shows what's waiting (creatorFeesOwed) and the launch advance still owed (advance). See creator fees.

Refunds

If a coin doesn't graduate within 7 days, it goes into refund mode and everyone gets back the same share of what they put in. woop's keeper pays every holder automatically. If you'd rather not wait for it:

bash
curl https://usewoop.xyz/api/v1/refunds \
  -H "Authorization: Bearer woop_…" \
  -H "Content-Type: application/json" \
  -d '{ "wallet": "<holder>", "mint": "7xKX…" }'

GET /api/v1/coins/{mint}/curve?wallet=<holder> shows the wallet's refund under mine.refund.

Holders get paid automatically

Holder payouts need nothing from you: every hour, woop sends each holder their share in the pair token and pays the network fee. Read them with GET /api/v1/coins/{mint}/payouts, and a wallet's earnings with GET /api/v1/wallets/{wallet}/portfolio.