> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gigabrain.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication & Basics

> API key, rate limits, and response format

Everything you need before hitting the endpoints below.

## Base URL

```
https://api.gigabrain.gg
```

All endpoints are prefixed with `/v1`.

## Authentication

Sign in and go to [Profile → API Keys](https://gigabrain.gg/profile?tab=api) to generate your key. Keys start with `gb_sk_`.

Include it in the `Authorization` header with every request:

```bash theme={null}
Authorization: Bearer gb_sk_<your-key>
```

You can also use the `X-API-Key` header:

```bash theme={null}
X-API-Key: gb_sk_<your-key>
```

## Rate Limits

**60 requests per minute.**

Every response includes headers showing your current usage:

```
X-RateLimit-Limit-Minute: 60
X-RateLimit-Remaining-Minute: 59
X-RateLimit-Reset-Minute: 2026-01-07T13:21:00.000Z
```

When you exceed the limit, you'll get a `429` response with a `Retry-After` header (seconds to wait).

## Response Format

All chat responses return analysis in the `content` field:

```json theme={null}
{
  "session_id": "uuid",
  "content": "The analysis or JSON data goes here",
  "timestamp": "2026-01-07T12:00:00Z"
}
```

> [!NOTE]
>
> The response field is `content` (not `message`).

For structured data, add "Respond as JSON with:" to your query and specify the fields. The `content` field will contain parseable JSON instead of markdown.

## Response Times

| Query Type | Typical Response Time |
| - | - |
| Simple data lookups (prices, funding rates, Fear & Greed) | 40-60 seconds |
| Multi-domain analysis (trade setups, protocol deep dives) | 60-120 seconds |
| Complex aggregations (yield opportunities, perp DEX rankings) | 120-180 seconds |
| Maximum timeout | \~600 seconds |

> [!WARNING]
>
> Set your HTTP client timeout to at least 600 seconds. If a query times out (504), break it into smaller, more specific requests.

## HTTP Status Codes

| Status | Meaning |
| - | - |
| `200` | Success |
| `201` | Resource created |
| `400` | Bad request |
| `401` | Invalid or revoked API key |
| `404` | Resource not found |
| `429` | Rate limit exceeded |
| `500` | Server error |
| `504` | Query timeout (try a simpler query) |

## Support

* **Email:** [support@gigabrain.gg](mailto:support@gigabrain.gg)
* **Telegram:** [t.me/gigabraingg](https://t.me/gigabraingg)

When contacting support, include:

* Your API key (first 10 characters only)
* Session ID from error responses


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.