Developer API

create and read causes without touching the UI — wire Please bro into your bot, launchpad, or app. Reads are open, no key, go wild.

⚠ heads up: early-days API, mainnet data. reads need no auth; creates are IP rate-limited (5 per 10 min, be nice). need more headroom? an x-api-key tier exists — just ask.

GET/api/fundraisers

all causes with live stats, sorted into justLaunched / mostPopular / risingFast, plus aggregate stats.

curl https://pleasebro.fun/api/fundraisers

GET/api/fundraisers?slug=<slug>

one cause with a fresh on-chain read of its vault (raised ETH, deployment state).

POST/api/create — GoFundMe-linked

we scrape & verify the campaign (title, image, story, goal, raised) and mint the cause its own vault.

curl -X POST https://pleasebro.fun/api/create \
  -H "Content-Type: application/json" \
  -d '{
    "type": "gofundme",
    "gofundme": "https://www.gofundme.com/f/your-campaign"
  }'

POST/api/create — native

beneficiary is an X or GitHub identity; they claim by signing in, and their payout wallet locks on-chain forever.

curl -X POST https://pleasebro.fun/api/create \
  -H "Content-Type: application/json" \
  -d '{
    "type": "native",
    "title": "Help rebuild the community center",
    "description": "What happened, who it helps, why it matters…",
    "beneficiary": { "type": "github", "handle": "username" },
    "images": ["https://example.com/cover.jpg"]
  }'

the response includes fundraiser.vault (the fee address for the token) and fundraiser.fundraiserUrl (goes in the token's website field). launch the token on any Robinhood Chain launchpad with those two values and trades fund the cause automatically — linking is detected on-chain within ~2 minutes.

Embed a cause anywhere

drop a live, self-updating cause card on any site with two lines — full guide at /embed.html ↗.

<div id="pumphood" data-slug="your-cause-slug"></div>
<script src="https://pleasebro.fun/widget.js" async></script>

How attribution works

each cause has its own CREATE2 vault (funds are safe at the address before deployment). the launchpad pushes 0.5% of every trade to it in ETH; the vault forwards 90% to the cause and 10% to buy back & burn $BRO. we read balances directly from chain 4663 — no trust in our database needed: verify on the explorer ↗.