Docs

Everything about how socialhood works — for launchers, traders, creators on GitHub / TikTok / Instagram / X, and the bots and aggregators that want to integrate it.

Overview

socialhood is social markets on Robinhood Chain — a launchpad built on top of pons (the launch protocol on Robinhood Chain) where every coin is based on one specific social object: a GitHub profile or repo, a TikTok profile or video, an Instagram profile, post or reel, or an X account or post. Coins launch through the real pons bonding curve, but every socialhood coin ships with one guarantee: 100% of its creator rewards are redirected to the account behind the link — not to whoever launched the coin.

The launcher gets the coin and the narrative; the person who actually owns the account gets the ETH. Nothing to set up beforehand — rewards accrue automatically on Robinhood Chain and wait until the creator verifies their account.

Platforms

Four platforms, one mechanism. What you can attach, and where the verification code goes:

GitHubgithub.com/{user} · github.com/{owner}/{repo}code goes in: Settings → Public profile → Bio
TikToktiktok.com/@user · tiktok.com/@user/video/… · vm.tiktok.com/…code goes in: Profile → Edit profile → Bio
Instagraminstagram.com/{user} · instagram.com/p/… · instagram.com/reel/…code goes in: Edit profile → Bio
Xx.com/{handle} · x.com/{handle}/status/… (twitter.com works)code goes in: Edit profile → Bio

A post is attributed to its author; a repo to its owner (an org verifies through the org's bio). The creator identity is platform:handle — the same X handle and the same GitHub username are two different creators.

Coining an account

Head to Coin an account, paste a GitHub, TikTok, Instagram or X link (a bare @handle works if you pick the platform), fill in name, ticker and image (defaults to the account's own image), set an optional dev buy, and send ONE plain ETH transfer on Robinhood Chain (the pons launch fee + your dev buy + network costs — socialhood itself charges nothing). The coin launches from a fresh wallet — create and dev buy in the same transaction, so snipers can't front-run you. The dev buy rides through the pons launch-and-buy router and lands straight in yourwallet; the fresh wallet keeps only the creator-fee role, which is what routes the fees to the account's owner.

For creators

Your account got coined? You're earning. 💸

Every trade on the coin generates pons creator fees. The engine sweeps and claims them automatically and credits them to the platform + handle behind the attached link. They're yours whether you knew about the coin or not. Every creator has a public page at /u/{platform}/{handle}showing exactly what's reserved — that's the link people send you.

verify your account → withdraw anywhere

Go to Creators, pick your platform, claim your handle and drop a one-time code in your bio. Once we spot it, you'll see every coin on your account, your accrued ETH, and a withdraw button that pays out to any Robinhood Chain wallet you choose.

Account verification

Ownership is proven with a bio code — the same pattern registrars use for domain verification, adapted to social profiles. Identical on all four platforms:

  1. Pick your platform and claim your handle on the Creators page → you get a one-time code like SOCIALHOOD-3F9A2C.
  2. Paste it anywhere in your public bio and save. Your profile must be public for the check.
  3. Hit verify — we read your public profile, find the code, and issue a session. You can delete the code from your bio right after.

No password, no OAuth grant, nothing to install — we never ask for anything that could touch your account. Platforms cache public bios for a few minutes, so verification accepts any code issued in the last 24 hours — no need to rotate codes or re-edit your bio if the first try doesn't land. Remove the code from your bio once you're done logging in. A session lasts 30 days and only unlocks the rewards dashboard for that exact platform + handle. Attribution is per-link, as resolved from the platform at launch time.

Collecting the ETH

The creator share of every trade accrues on the coin's pons curve (and, after graduation, in the pons fee escrow). Every ~5 minutes the keeper sweeps and claims it into the coin's custodial wallet on Robinhood Chain and credits it to the creator's ledger. When the creator withdraws, the ETH is sent as native ETH on Robinhood Chain (chain id 4663) from those wallets to the address they typed — one transfer per coin, every transaction linked from the dashboard. Bridging out is the creator's choice; the engine never touches the funds otherwise.

Liquidity & fees

Coins trade on the pons bonding curve until it sells out, then graduate into a permanently locked Uniswap pool. socialhood charges no platform fee— you only pay the pons launch fee (0.0005 ETH) and network costs at launch, trading fees are pons' standard ones, and the creator share of them is what pays the creators. Every claim and withdrawal is a public transaction linked from the coin page and the creator dashboard.

The engine

Launches run through the official pons launch factory on Robinhood Chain (create + dev buy bundled in one transaction). Buy/sell from the coin page trade directly on the bonding curve with your own wallet — nothing custodial. The custodial part is exactly one thing: each coin's creator wallet, which exists so the dev can't dump and the creator rewards can be routed to the account's owner. Those wallets are encrypted at rest and only ever claim fees and pay creator withdrawals.

Social attribution is resolved from the platforms themselves at launch time — GitHub's API, TikTok's embed pages, X's syndication endpoints, Instagram's public profile data — and stored with the coin; only a session verified via that account's bio can withdraw its rewards.

Integrate socialhood

The REST API is public and live — no key needed.

GET /api/statsplatform totals: coins, volume, ETH reserved & paid to creators, per-platform breakdown
GET /api/tokens?sort=new|trending|mcap|volume|rewards&platform=github|tiktok|instagram|xlist coins (search, limit, offset)
GET /api/token/{mint}one coin with price, mcap, attached social object, creator rewards
GET /api/token/{mint}/rewardsreward history, live fee pot, the attachment + its creator
GET /api/creators?platform=creators leaderboard, ranked by ETH reserved
GET /api/creator/{platform}/{handle}public creator page: coins, reserved / withdrawn / available ETH
POST /api/social/resolveresolve any supported link to its object + creator
GET /api/token/{mint}/ohlc?interval=60USD candles (60 / 300 / 900 / 3600s)
GET /api/token/{mint}/tradesrecent trades
GET /api/token/{mint}/holderstop holders + curve share
GET /api/token/{mint}/commentscoin comments (POST with an EIP-191 personal_sign signature)

Every reward row links its claim transaction, so aggregators can verify the flow on-chain. The coins are regular pons launches on Robinhood Chain — anything that already indexes pons picks them up automatically.