Authentication¶

The Sera GraphQL API is publicly accessible and does not require authentication.

Public Access¶

# No API key required
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"query": "{ markets(first: 5) { id } }"}' \
  https://api.goldsky.com/api/public/project_cmicv6kkbhyto01u3agb155hg/subgraphs/sera-pro/1.0.9/gn

Best Practices¶

Rate Limiting¶

While no authentication is required, please follow these guidelines:

• Add delays between requests (recommended: 500ms)
• Batch queries when possible
• Cache responses for frequently accessed data

Request Headers¶

Include a descriptive User-Agent for debugging:

const response = await fetch(SUBGRAPH_URL, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'User-Agent': 'MyApp/1.0.0'
  },
  body: JSON.stringify({ query })
});

CORS¶

The API supports CORS for browser-based applications:

// Works directly from browser
fetch(SUBGRAPH_URL, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ query: '{ markets(first: 1) { id } }' })
});

WebSocket Subscriptions¶

For real-time data, consider:

• Polling at regular intervals
• Subscribing to on-chain events via WebSocket RPC