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

# Developer overview

> Read gHypurr public datasets with a scoped Bearer API key.

The gHypurr API exposes read-only product datasets over HTTPS.

**Base URL:** `https://ghypurr.com`

## Quick request

```bash theme={"dark"}
curl "https://ghypurr.com/api/v1/news?limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

<Warning>
  Replace `YOUR_API_KEY` locally. Never commit an API key or paste it into public
  issues, documentation, screenshots, or chat.
</Warning>

## Available endpoints

| Method and path             | Required scope       | Purpose                                |
| --------------------------- | -------------------- | -------------------------------------- |
| `GET /api/v1/news`          | `news:read`          | Read the published news dataset.       |
| `GET /api/v1/smart-wallets` | `smart-wallets:read` | Read the paginated Smart Money list.   |
| `GET /api/v1/meme-signals`  | `meme:read`          | Read published meme-token alerts.      |
| `GET /api/v1/ai-signals`    | `ai-signals:read`    | Read the published AI signal snapshot. |
| `GET /api/v1/usage`         | Any active API key   | Read account-level API usage.          |

All dataset endpoints are read-only. The AI Signals endpoint returns an already
published snapshot; it does not generate a new signal or submit an order.

<CardGroup cols={2}>
  <Card title="Create an API key" icon="key" href="/developers/api-keys">
    Choose scopes and optional IP restrictions.
  </Card>

  <Card title="Copy examples" icon="code-xml" href="/developers/examples">
    Use cURL, JavaScript, or Python from your own machine.
  </Card>
</CardGroup>