# Quickstart

> From no account to your first answer in about a minute. 10,000 credits are free, with no card and no subscription.

## 1. Get a key

1. [Sign in with Google](https://app.aurelia.build/#/login). Your first sign-in creates the account.
2. On [your account page](https://app.aurelia.build/#/account), create a key and copy it. It starts with `aur_` and is shown once.

## 2. Read a token

Wrapped SOL's price, market data and security checks, curl:

```bash
curl -s -H 'Authorization: Bearer aur_YOUR_KEY' \
  'https://app.aurelia.build/api/tokens/solana/So11111111111111111111111111111111111111112'
```

Wrapped SOL's price, market data and security checks, JavaScript:

```javascript
const res = await fetch("https://app.aurelia.build/api/tokens/solana/So11111111111111111111111111111111111111112", {
  headers: { Authorization: "Bearer aur_YOUR_KEY" },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();
console.log(data);
```

Wrapped SOL's price, market data and security checks, Python:

```python
import requests

r = requests.get(
    "https://app.aurelia.build/api/tokens/solana/So11111111111111111111111111111111111111112",
    headers={"Authorization": "Bearer aur_YOUR_KEY"},
    timeout=10,
)
r.raise_for_status()
print(r.json())
```

## 3. Draw a chart

Hourly candles in USD:

```bash
curl -s -H 'Authorization: Bearer aur_YOUR_KEY' 'https://app.aurelia.build/api/tokens/solana/So11111111111111111111111111111111111111112/candles?res=1h&currency=usd'
```

More in the [OHLCV guide](https://app.aurelia.build/guides/ohlcv-candles-api).

## 4. Follow it live

Every new trade of a token:

```javascript
const ws = new WebSocket("wss://app.aurelia.build/api/live?apiKey=aur_YOUR_KEY");
ws.onopen = () => ws.send(JSON.stringify({ op: "subscribe", id: "sol", channel: "trades", chain: "solana", token: "So11111111111111111111111111111111111111112" }));
ws.onmessage = (e) => console.log(JSON.parse(e.data));
```

## If something goes wrong

| Status | What it means | What to do |
|---|---|---|
| `401` | No key, or a bad, expired or revoked one | Send `Authorization: Bearer <key>` |
| `402` | Your credits cannot pay for the request | Add credit on your [account page](https://app.aurelia.build/#/account) |
| `429` | Over the burst limit: 5 a second free, 30 a second paid | Wait `retryAfter` seconds |
| `404` | A token or pool Aurelia has not seen | Check the chain and the address |

## Next

- [What is Aurelia?](https://app.aurelia.build/guides/what-is-aurelia): everything it can do.
- [API reference](https://app.aurelia.build/docs): every endpoint, with real answers.
- [Short-lived tokens](https://app.aurelia.build/docs/auth-token): let your users' browsers call the API without showing them your key.
- [Using an AI assistant?](https://app.aurelia.build/llms.txt) Give it llms.txt and it can write the integration for you, or connect it directly with the [MCP server](https://app.aurelia.build/guides/mcp-server).
