_gammadocs
API Reference

Public endpoints

Keyless, CORS-enabled endpoints for circulating supply and the gmSTBL share-price oracle.

These two endpoints are the keyless public tier. They take no Authorization header, send Access-Control-Allow-Origin: * (browser-callable), and are edge-cached for 60 seconds. They are rate limited per client IP (20 requests / 5 seconds).

GET /api/circulating-supply

Circulating supply of the gmSTBL share token. For gmSTBL, total supply equals circulating supply (no locked tokens).

curl "https://app.gma.fi/api/circulating-supply"

{
  "circulatingSupply": 51173000.42
}

Note: this endpoint returns the bare object above, not the { success, data } envelope.

GET /api/oracle

The gmSTBL share price (NAV per share) in USD, for Switchboard and other oracle integrations. Read from the on-chain LpVault account (cached ~10s internally, plus the ~60s edge cache).

curl "https://app.gma.fi/api/oracle"

{
  "sharePrice": 1.023456
}

Note: this endpoint also returns the bare object above, not the { success, data } envelope.

Next: Request an API key