Gully Social
On this page
Live
Live on testnet in the GullyChain app. The API is at https://social.gullychain.xyz.
Gully Social is the social layer of the GullyChain app. Your profile is your wallet: the avatar, banner, bio and links are text records on your .gully name, so they live on chain. The social service stores only the social graph (follows, posts, likes) and the image files you upload.
| App | app.gullychain.xyz: Explore, the Following feed, Invites, Get verified |
| API | https://social.gullychain.xyz (browser CORS: the app only; public reads work from any server) |
| Health | GET https://social.gullychain.xyz/healthz |
| Sign-in | a device key in the browser, authorised once by your wallet or passkey account. No invite code needed |
| Verified badge | GullyVerified 0xE521eCfb4F0385f1eb674b26Cb504dCCA128B198 |
#What you can do
- Follow people and read the Following feed, or browse everyone on Explore (most followed, newest, verified, points).
- Post up to 280 characters with an image, reply and like.
- Invite friends with your five codes. Invites earn points and the early badge; they never gate anything.
- Get verified: post a code from your X account, pay through Gully Pay (card checkout, or x402 on GullyChain in ETH, WETH, glUSD or USDC.e), and the attester signs your badge, which can be recorded on chain in GullyVerified. Payments go straight to Gully Pay's settlement address: the service and the contract never hold funds.
- Share a profile or post on X:
app.gullychain.xyz/s/<kind>/<id>serves a page with a 1200x630 card in the GullyChain kit.
#Public read API
No key needed. Addresses are GullyChain accounts.
| Request | Returns |
|---|---|
GET /v1/profiles/:address |
followers, following, posts, points, early, the active verified badge or null |
POST /v1/profiles/batch with { "addresses": [...] } (up to 100) |
{ [address]: { followers, verified, early } } |
GET /v1/people?sort=followers&limit=50 |
people for Explore (sort: followers, new, verified, points) |
GET /v1/posts?author=&feed=&cursor= |
top-level posts, 30 a page (feed=<address>: who that address follows, plus itself) |
GET /v1/posts/:id |
a post and its replies |
GET /v1/verified/:address |
the badge, or 404 |
GET /v1/verify/config |
badge plans, prices and accepted payment assets |
curl -s "https://social.gullychain.xyz/v1/people?sort=followers&limit=5"Writes (follow, post, like, upload, verify) need the app's signed device-key header, so build on the app or ask in Support for an integration.
#Limits
Posts: 20 an hour per account. Uploads: 30 an hour; avatar up to 1 MB and 1024 px a side, banner up to 2 MB, post images up to 2 MB and 2048 px (PNG, JPEG, WebP or GIF, checked from the file bytes).
The service is on the status board (opens in a new tab).