API reference

API overview

Base URL, conventions and error shape for the socials.capital API.

The API is a JSON REST service. The dashboard uses it exclusively; there is nothing the UI can do that you cannot do with these endpoints.

Base URL
# productionhttps://api.socials.capital# local developmenthttp://localhost:4000

Conventions

  • Lamport amounts are strings so they survive JSON without precision loss.
  • Shares are basis points: 10,000 = 100% of the creator share.
  • Timestamps are ISO-8601 in UTC.
  • Transactions are base64-encoded v0 transactions unless version is 'legacy'.

Errors

Errors return a non-2xx status with a JSON body. The client throws ApiError with the status, message and optional code.

json
{  "error": "routes_invalid",  "message": "Route shares must sum to 10000 bps"}

Health

GET/health

RPC and database status plus the operator and treasury keys.

GET/v1/solana/status

Health, slot and latency of every RPC node in the pool.