IntroductionGetting startedHow launches workFeesIndexer & bot guideContracts & eventsAPI referenceKOL partner program
Integrations
API reference
Public HTTP endpoints for market data and launch metadata.
Base URL: https://gelvx.xyz. All routes are read-only unless noted. Rate limits apply on discover and search.
Market data
| Endpoint | Description |
|---|---|
| GET /api/hood/discover | Trending HOOD tokens (GeckoTerminal + DexScreener) |
| GET /api/hood/token/{address}?chain=hood | Token detail; on-chain Gelvx fallback |
| GET /api/hood/search?q= | Search tokens by name or address |
| GET /api/hood/eth-price | ETH/USD reference price |
KOL & referrals
| Endpoint | Description |
|---|---|
| GET /api/kol/waitlist?handle= | Waitlist status for an X handle |
| POST /api/kol/waitlist | Join KOL waitlist (body: handle, tweetUrl, …) |
| GET /api/referrals/binding?wallet= | Referrer bound to a wallet |
| GET /api/referrals/me?wallet=&handle= | KOL profile + ref link if allowlisted |
Planned
- GET /api/launches — paginated Gelvx factory launches for partners
- Webhooks on Launched events
Discover is not Gelvx-filtered
/api/hood/discover returns general HOOD market data. To list only Gelvx launches, index the factory contract or use the upcoming /api/launches endpoint.