LongPaid

Docs

How LongPaid routes long.xyz creator fees to X accounts.

Overview

Tokens launched on long.xyz earn creator fees from trading. When a token names the LongPaid treasury as its creator-fee beneficiary, we claim those fees on-chain and credit them to the X account in the token's metadata. The account owner doesn't need a wallet or a sign-up.

Launching a token

  1. Create the token on app.long.xyz as usual.
  2. Set the fee receiver to @uselongpaid. long.xyz then pays the creator fees to LongPaid.
  3. Write who earns them in the token bio: fees @alice. fees to @alice, fee send @alice and fees: @alice work too.
  4. Launch. LongPaid scans every long.xyz launch and picks yours up within a few minutes. It checks the launch transaction itself, so only tokens whose fees really reach LongPaid are counted; the bio only says who gets them.

Fee split

Where the money goes

  1. The token trades on long.xyz. Creator fees build up for our treasury.
  2. The team claims each token's fees on-chain regularly and records the claim with its transaction hash, which is checked on-chain. Claiming on every trade would cost more in gas than quiet tokens earn.
  3. Each claim is split: 80% is credited to the X account in the token's metadata, 20% buys back and burns.
  4. Everything after the claim is automatic: when the account crosses a milestone, its balance is sent in dollars to that X account through X Money.

Payouts

An account's share builds up as fees are claimed. Each time its lifetime earnings cross a milestone ($5, $10, $20, $50, $100, $250, $500, $1,000, then every $1,000), the full unpaid balance is paid out in dollars. If a payout fails (for example, the account can't receive money yet), the amount goes back to the balance and goes out with the next milestone.

Payouts are sent in dollars through X Money, straight to the @handle, from LongPaid's X Money balance. The account owner doesn't need to connect a wallet or sign up. If an account can't receive X Money yet, the payout goes back to its balance and is sent with the next milestone.

Opting out

Anyone can put any handle in token metadata, so account owners can opt out. After that, no money is credited to them: fees from tokens naming their handle are burned in full. To opt out, contact the team from your X account.

API

GET  /api/stats                     totals
GET  /api/tokens?sort=fees|new&q=   tokens routing fees
GET  /api/profile/:handle           account, tokens, payouts, claims

# Operator endpoints (Authorization: Bearer $CRON_SECRET)
POST /api/cron/distribute           send queued payouts (run from cron)
POST /api/cron/claim                automatic mode only: claim + distribute
GET  /api/admin/payouts?status=queued
POST /api/admin/payouts             {"id": 1, "ok": true, "ref": "x-money-ref"}
POST /api/admin/opt-out             {"handle": "alice", "optedOut": true}