> For the complete documentation index, see [llms.txt](https://docs.alphanume.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alphanume.com/documentation/getting-started/quickstart.md).

# Quickstart

{% hint style="info" %}
This page shows you how to make your first request and begin working with our datasets in under a minute.
{% endhint %}

<figure><img src="/files/bHM0CKZ2p98OKpKM1SS7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Alphanume supports unauthenticated requests for exploration.\
Requests made without an API key are limited (e.g. max records per request).\
To remove limits and access the full dataset, create an account and generate an API key.
{% endhint %}

### 1. (Optional) Create an Account & Receive Your API Key

To use **Alphanume** without limits, start by creating a subscription.

1. Visit [**alphanume.com**](https://alphanume.com) and choose a plan
2. Complete checkout
3. Your API key will be **automatically emailed** to you after signup

API keys authenticate requests and unlock:

* higher request limits
* full historical coverage
* production usage

Keep your API key private. Treat it like a password.

### **2. Make Your First Request**

Below is the simplest possible example using `requests` + `pandas`.\
This retrieves dilution filings and loads them into a clean dataframe.

{% tabs %}
{% tab title="JavaScript" %}

```javascript
async function main() {
  const response = await fetch(
    `https://api.alphanume.com/v1/dilution?limit=5`
  );

  const data = await response.json();
  console.log(data.data);
}

main();
```

{% endtab %}

{% tab title="Python" %}

```python
import pandas as pd
import requests

data_request = requests.get(f"https://api.alphanume.com/v1/dilution?limit=5").json()
dataframe = pd.json_normalize(data_request["data"])

print(dataframe)
```

{% endtab %}

{% tab title="cURL" %}

```shellscript
curl -X GET "https://api.alphanume.com/v1/dilution?limit=5"
```

{% endtab %}
{% endtabs %}

You now have Alphanume data inside a pandas dataframe — ready for analysis, modeling, or downstream usage in your trading or research pipeline.

### **3. What’s Next?**

Once you’re receiving data successfully, explore:

* **Dilution Dataset** — full schema, theory, and use-cases
* **API Reference** — parameters, pagination, and endpoints
* **Integration Examples** — Python, JS, and automation patterns