Skip to Content
DocsAPI ReferenceOverview

API Reference

Complete reference for all Grails API endpoints. All endpoints return responses in the standard format.

Endpoint Inventory

SectionRoutesEndpointsDescription
Corehealth, auth, users, profiles~11Service health, authentication, user management
Names & Searchnames, search~8ENS name lookup, full-text and filtered search
Marketplacelistings, offers, orders, sales, brokered-listings, cart~32Full marketplace lifecycle
Socialwatchlist, clubs, votes, notifications, activity~28Social features and engagement
Discoverytrending, leaderboard, recommendations, ai-search~16Discovery and recommendation engines
Analyticsanalytics, charts, google-metrics, user-insights~22Market analytics and user insights
Systemverification, legends, personas, poap, ens-roles, subgraph, websocket~17Supporting services

Common Patterns

  • Authentication — See Authentication for the SIWE flow
  • Pagination — Most list endpoints accept page, limit, sortBy, sortOrder params
  • Caching — Cached endpoints return X-Cache: HIT/MISS headers
  • Validation — Invalid params return 400 VALIDATION_ERROR with details
Last updated on
Response FormatHealth