# Quickstart

This page answers the most common first question directly: how do I make a correct growthepie API request right now? The examples below are complete, runnable, and use real public endpoints that do not require authentication.

## Key Facts

* Base URL: `https://api.growthepie.com/`
* Auth: No authentication required for the public endpoints documented here
* Best first endpoint: `https://api.growthepie.com/v1/master.json`
* Flat export shape: `metric_key`, `origin_key`, `date`, `value`

## curl

```bash
curl -s https://api.growthepie.com/v1/export/txcount.json
```

## Python

```python
import requests

url = "https://api.growthepie.com/v1/export/txcount.json"
response = requests.get(url, timeout=30)
response.raise_for_status()

rows = response.json()
print(f"rows={len(rows)}")
print(rows[0])
```

## JavaScript / TypeScript

```ts
const url = "https://api.growthepie.com/v1/export/txcount.json";

const response = await fetch(url);
if (!response.ok) {
  throw new Error(`Request failed with status ${response.status}`);
}

const rows = await response.json();
console.log(`rows=${rows.length}`);
console.log(rows[0]);
```

## Example Response

```json
[
  {
    "metric_key": "txcount",
    "origin_key": "arbitrum",
    "date": "2021-05-29",
    "value": 9.0
  }
]
```

## Real Task: Fetch One Chain's Transaction Count History

```python
import requests

url = "https://api.growthepie.com/v1/export/txcount.json"
rows = requests.get(url, timeout=30).json()

arbitrum_rows = [row for row in rows if row["origin_key"] == "arbitrum"]
print(arbitrum_rows[:3])
```

## FAQ

### What should I fetch before choosing an `origin_key`?

Fetch `master.json`. `master.json` is the canonical metadata file for supported chains and supported metrics.

### When should I use `fundamentals.json` instead?

Use `fundamentals.json` when you want many fundamental metrics together in one 90-day daily export.

## Related Pages

* [Choose The Right Endpoint](/getting-started/getting-started/choose-the-right-endpoint.md)
* [Endpoint: export/{metric}.json](/api-reference/api/export-metric-json.md)
* [Fetch A Metric In curl](/recipes-tutorials/recipes/fetch-a-metric-in-curl.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.growthepie.com/getting-started/getting-started/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.