### Chain Overview Example Request

Source: https://docs.growthepie.com/api-reference/api/chain-overview-json.md

A concrete example of a request for the Arbitrum chain.

```http
GET https://api.growthepie.com/v1/chains/arbitrum/overview.json
```

--------------------------------

### Query documentation via HTTP GET

Source: https://docs.growthepie.com/llms.txt

Perform an HTTP GET request to the documentation index using the ask and goal parameters to receive a direct answer.

```http
GET https://docs.growthepie.com/recipes-tutorials/recipes/plot-a-timeseries.md?ask=<question>&goal=<end_goal>
```

--------------------------------

### GET /v1/master.json

Source: https://docs.growthepie.com/api-reference/api.md

Retrieves the master configuration file containing supported origin keys and metric IDs. This should be the starting point for API interactions.

```APIDOC
## GET /v1/master.json

### Description
Retrieves the master configuration file. Use this to verify supported `origin_key` and `metric_id` values before querying specific endpoints.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/master.json
```

--------------------------------

### Example Metric Request

Source: https://docs.growthepie.com/api-reference/api/export-metric-json.md

A concrete example of requesting the transaction count metric.

```http
GET https://api.growthepie.com/v1/export/txcount.json
```

--------------------------------

### API Request Example

Source: https://docs.growthepie.com/api-reference/api/metric-detail-json.md

A concrete example of a request for the transaction count metric on the Arbitrum chain.

```http
GET https://api.growthepie.com/v1/metrics/chains/arbitrum/txcount.json
```

--------------------------------

### Example Response

Source: https://docs.growthepie.com/api-reference/api/export-metric-json.md

The structure of the JSON array returned by the endpoint.

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

--------------------------------

### Example owner_project data structure

Source: https://docs.growthepie.com/core-concepts/what-is-owner-project.md

A sample JSON array representing the structure of project metadata associated with an owner_project.

```json
[
  "uniswap",
  "Uniswap",
  "Uniswap is a decentralized exchange protocol."
]
```

--------------------------------

### GET /recipes-tutorials/recipes/plot-a-timeseries.md

Source: https://docs.growthepie.com/llms.txt

Performs a natural language query against the documentation index to retrieve an answer and relevant excerpts.

```APIDOC
## GET /recipes-tutorials/recipes/plot-a-timeseries.md

### Description
Perform an HTTP GET request on the documentation index with the `ask` parameter to retrieve a direct answer and relevant excerpts from the documentation.

### Method
GET

### Endpoint
https://docs.growthepie.com/recipes-tutorials/recipes/plot-a-timeseries.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The immediate question to ask, written in natural language.
- **goal** (string) - Optional - Describes the broader end goal to help tailor the answer.
```

--------------------------------

### GET /v1/export/{metric}.json

Source: https://docs.growthepie.com/getting-started/getting-started/quickstart.md

Fetches historical data for a specific metric. The example uses 'txcount' as the metric.

```APIDOC
## GET /v1/export/{metric}.json

### Description
Fetches historical data for a specific metric. This endpoint returns a flat list of objects containing metric keys, origin keys, dates, and values.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/export/{metric}.json

### Parameters
#### Path Parameters
- **metric** (string) - Required - The metric identifier (e.g., txcount)

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric
- **origin_key** (string) - The identifier for the chain
- **date** (string) - The date of the record
- **value** (number) - The recorded value

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

--------------------------------

### Example Response for labels/projects_filtered.json

Source: https://docs.growthepie.com/api-reference/api/labels-projects-filtered-json.md

The response is structured as a typed table containing project metadata and associated metrics.

```json
{
  "last_updated_utc": "2026-03-27 05:40:42",
  "data": {
    "types": [
      "owner_project",
      "display_name",
      "description",
      "main_github",
      "twitter",
      "website",
      "logo_path",
      "token_symbol",
      "txcount",
      "active_on",
      "ecosystem_rank",
      "sub_category",
      "main_category",
      "sub_categories",
      "features"
    ],
    "data": [
      [
        "polymarket",
        "Polymarket",
        "Polymarket is a decentralized blockchain-based prediction market platform.",
        "polymarket",
        "Polymarket",
        "https://polymarket.com/",
        "polymarket.png",
        null,
        125438595.0,
        {
          "polygon_pos": 125438595
        },
        1,
        "Prediction Markets",
        "Finance",
        [
          "erc4337",
          "prediction_markets"
        ],
        [
          "Dummy",
          "Swap",
          "Lending",
          "Bridge",
          "Trading"
        ]
      ]
    ]
  }
}
```

--------------------------------

### GET v1/labels/projects.json

Source: https://docs.growthepie.com/api-reference/api.md

Retrieves project metadata as a typed table.

```APIDOC
## GET v1/labels/projects.json

### Description
Retrieves project metadata as a typed table.

### Method
GET

### Endpoint
v1/labels/projects.json
```

--------------------------------

### Example of origin_key in data export

Source: https://docs.growthepie.com/core-concepts/what-is-origin-key.md

Shows how the origin_key field appears within a flat export data structure.

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

--------------------------------

### Example App Details Response

Source: https://docs.growthepie.com/api-reference/api/app-detail-json.md

A sample JSON response structure showing the fields returned for a project, including first-seen dates and metric time series.

```json
{
  "last_updated_utc": "2026-03-27 05:40:34",
  "first_seen": {
    "polygon_pos": "2020-10-01",
    "ethereum": "2021-01-01",
    "optimism": "2021-11-11",
    "arbitrum": "2022-04-18",
    "base": "2023-07-29"
  },
  "metrics": {
    "txcount": {
      "metric_name": "Transaction Count",
      "avg": true,
      "over_time": {
        "arbitrum": {
          "daily": {
            "types": ["unix", "value"]
          }
        }
      }
    }
  },
  "contracts_table": {
    "7d": {
      "types": []
    }
  }
}
```

--------------------------------

### Example txcosts JSON response

Source: https://docs.growthepie.com/metric-reference/metric-reference/txcosts.md

Structure of the returned data containing median costs in USD and ETH.

```json
[
  {
    "metric_key": "txcosts_median_usd",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 0.0041
  },
  {
    "metric_key": "txcosts_median_eth",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 0.0000013
  }
]
```

--------------------------------

### GET /v1/master.json

Source: https://docs.growthepie.com/getting-started/getting-started/quickstart.md

Fetches the canonical metadata file for supported chains and metrics.

```APIDOC
## GET /v1/master.json

### Description
Retrieves the master metadata file which lists all supported chains and metrics. This is recommended to be fetched before choosing an origin_key.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/master.json
```

--------------------------------

### Example master.json response

Source: https://docs.growthepie.com/api-reference/api/master-json.md

A sample JSON response structure containing versioning, update timestamps, chain definitions, and metric configurations.

```json
{
  "current_version": "v1",
  "last_updated_utc": "2026-03-27 05:30:09",
  "chains": {
    "arbitrum": {
      "name": "Arbitrum One",
      "url_key": "arbitrum",
      "supported_metrics": [
        "tvl",
        "txcount",
        "daa",
        "stables_mcap",
        "fees",
        "rent_paid",
        "profit",
        "txcosts",
        "fdv",
        "market_cap",
        "throughput",
        "app_revenue"
      ]
    }
  },
  "metrics": {
    "txcount": {
      "name": "Transaction Count",
      "metric_keys": ["txcount"],
      "hourly_available": true
    }
  }
}
```

--------------------------------

### Request labels/projects.json

Source: https://docs.growthepie.com/api-reference/api/labels-projects-json.md

Perform a GET request to retrieve the project metadata table.

```http
GET https://api.growthepie.com/v1/labels/projects.json
```

--------------------------------

### Example Response for labels/projects.json

Source: https://docs.growthepie.com/api-reference/api/labels-projects-json.md

The response structure includes a last_updated_utc timestamp and a data object containing column types and row data.

```json
{
  "last_updated_utc": "2026-03-27 05:35:04",
  "data": {
    "types": [
      "owner_project",
      "display_name",
      "description",
      "main_github",
      "twitter",
      "website",
      "logo_path",
      "token_symbol",
      "sub_category",
      "main_category",
      "sub_categories"
    ],
    "data": [
      [
        "adsbaazar",
        "Adsbaazar",
        "Adsbaazar is an India-based vehicle branding and outdoor advertising service provider.",
        null,
        null,
        "https://www.adsbaazar.com/",
        null,
        null,
        "Stablecoin",
        "Token Transfers",
        ["stablecoin"]
      ]
    ]
  }
}
```

--------------------------------

### Example response structure

Source: https://docs.growthepie.com/api-reference/api/fundamentals-json.md

The response is an array of objects containing metric keys, origin keys, dates, and values.

```json
[
  {
    "metric_key": "aa_last7d",
    "origin_key": "arbitrum",
    "date": "2026-01-01",
    "value": 907687.0
  },
  {
    "metric_key": "txcount",
    "origin_key": "arbitrum",
    "date": "2026-01-01",
    "value": 2525170.0
  }
]
```

--------------------------------

### GET /v1/export/app_revenue.json

Source: https://docs.growthepie.com/metric-reference/metric-reference/app-revenue.md

Retrieves the app_revenue metric data for supported chains.

```APIDOC
## GET /v1/export/app_revenue.json

### Description
Retrieves the app_revenue metric, which measures app-oriented fee generation. This is useful for comparing app-oriented monetization across different chains.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/export/app_revenue.json

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric (e.g., app_fees_usd, app_fees_eth)
- **origin_key** (string) - The chain identifier
- **date** (string) - The date of the metric record
- **value** (number) - The numerical value of the revenue

#### Response Example
[
  {
    "metric_key": "app_fees_usd",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 51420.89
  },
  {
    "metric_key": "app_fees_eth",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 16.74
  }
]
```

--------------------------------

### GET chains/{origin_key}/overview.json

Source: https://docs.growthepie.com/api-reference/api/chain-overview-json.md

Retrieves a rich summary for a specific chain identified by its origin_key.

```APIDOC
## GET chains/{origin_key}/overview.json

### Description
Returns a rich summary for one chain, including highlights, events, rankings, KPI cards, achievements, and ecosystem context.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/chains/{origin_key}/overview.json

### Parameters
#### Path Parameters
- **origin_key** (string) - Required - The unique identifier for the chain.

### Response
#### Success Response (200)
- **last_updated_utc** (string) - Timestamp of the last update.
- **data** (object) - The chain overview data containing chain_id, chain_name, highlights, events, ranking, kpi_cards, achievements, blockspace, and ecosystem.

#### Response Example
{
  "last_updated_utc": "2026-03-27 05:35:04",
  "data": {
    "chain_id": "arbitrum",
    "chain_name": "Arbitrum One",
    "highlights": [
      {
        "metric_id": "txcount",
        "metric_name": "Transaction Count",
        "type": "lifetime_level_up",
        "date": "2026-03-24"
      }
    ],
    "ecosystem": {
      "active_apps": {
        "7d": 0
      }
    }
  }
}
```

--------------------------------

### Market Cap API response structure

Source: https://docs.growthepie.com/metric-reference/metric-reference/market-cap.md

Example of the JSON structure returned by the market_cap endpoint.

```json
[
  {
    "metric_key": "market_cap_usd",
    "origin_key": "optimism",
    "date": "2026-03-01",
    "value": 6200000000.0
  },
  {
    "metric_key": "market_cap_eth",
    "origin_key": "optimism",
    "date": "2026-03-01",
    "value": 2070000.0
  }
]
```

--------------------------------

### GET /v1/export/fees.json

Source: https://docs.growthepie.com/metric-reference/metric-reference/fees.md

Retrieves the fees metric data for supported chains.

```APIDOC
## GET /v1/export/fees.json

### Description
Retrieves the canonical fees metric data, which represents the fees paid by users on various chains. This metric is also referred to as Revenue in metadata.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/export/fees.json

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the fee unit (e.g., fees_paid_usd, fees_paid_eth)
- **origin_key** (string) - The chain identifier
- **date** (string) - The date of the record
- **value** (number) - The fee amount

#### Response Example
[
  {
    "metric_key": "fees_paid_usd",
    "origin_key": "arbitrum",
    "date": "2026-03-01",
    "value": 315245.11
  },
  {
    "metric_key": "fees_paid_eth",
    "origin_key": "arbitrum",
    "date": "2026-03-01",
    "value": 102.74
  }
]
```

--------------------------------

### GET labels/projects.json

Source: https://docs.growthepie.com/api-reference/api/labels-projects-json.md

Retrieves a comprehensive list of project metadata including display names, descriptions, and category information.

```APIDOC
## GET https://api.growthepie.com/v1/labels/projects.json

### Description
Returns project metadata as a typed table, useful for mapping owner_project identifiers to human-readable names, descriptions, websites, categories, and other project attributes.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/labels/projects.json

### Response
#### Success Response (200)
- **last_updated_utc** (string) - Timestamp of the last update.
- **data** (object) - Contains the project metadata table.
  - **types** (array) - List of column headers for the data table.
  - **data** (array) - List of rows containing project attribute values.

#### Response Example
{
  "last_updated_utc": "2026-03-27 05:35:04",
  "data": {
    "types": [
      "owner_project",
      "display_name",
      "description",
      "main_github",
      "twitter",
      "website",
      "logo_path",
      "token_symbol",
      "sub_category",
      "main_category",
      "sub_categories"
    ],
    "data": [
      [
        "adsbaazar",
        "Adsbaazar",
        "Adsbaazar is an India-based vehicle branding and outdoor advertising service provider.",
        null,
        null,
        "https://www.adsbaazar.com/",
        null,
        null,
        "Stablecoin",
        "Token Transfers",
        ["stablecoin"]
      ]
    ]
  }
}
```

--------------------------------

### Example JSON Response

Source: https://docs.growthepie.com/api-reference/api/metric-detail-json.md

A sample response payload showing the structure of metric details, including timeseries, changes, and summary data.

```json
{
  "last_updated_utc": "2026-03-27 07:15:02",
  "details": {
    "metric_id": "txcount",
    "metric_name": "Transaction Count",
    "timeseries": {
      "daily": {
        "types": ["unix", "value"]
      },
      "hourly": {
        "types": ["unix", "value"]
      }
    },
    "changes": {
      "daily": {},
      "hourly": {}
    },
    "summary": {
      "last_1d": {
        "types": ["value"],
        "data": [2525170.0]
      }
    }
  }
}
```

--------------------------------

### GET /v1/export/market_cap.json

Source: https://docs.growthepie.com/metric-reference/metric-reference/market-cap.md

Retrieves the market capitalization data for covered chains.

```APIDOC
## GET /v1/export/market_cap.json

### Description
Retrieves the market capitalization data for covered chains. Use this when you want circulating-value style valuation.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/export/market_cap.json

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric (e.g., market_cap_usd, market_cap_eth)
- **origin_key** (string) - The chain identifier
- **date** (string) - The date of the record
- **value** (number) - The market capitalization value

#### Response Example
[
  {
    "metric_key": "market_cap_usd",
    "origin_key": "optimism",
    "date": "2026-03-01",
    "value": 6200000000.0
  },
  {
    "metric_key": "market_cap_eth",
    "origin_key": "optimism",
    "date": "2026-03-01",
    "value": 2070000.0
  }
]
```

--------------------------------

### GET /apps/details/{owner_project}.json

Source: https://docs.growthepie.com/api-reference/api.md

Fetches detailed information for a specific project. It is recommended to verify the project exists in labels/projects_filtered.json first.

```APIDOC
## GET /apps/details/{owner_project}.json

### Description
Fetches app-level details for a specific project. The `owner_project` should be validated against the list provided in `labels/projects_filtered.json`.

### Method
GET

### Endpoint
/apps/details/{owner_project}.json

### Parameters
#### Path Parameters
- **owner_project** (string) - Required - The unique identifier for the project.
```

--------------------------------

### App Revenue JSON Response Structure

Source: https://docs.growthepie.com/metric-reference/metric-reference/app-revenue.md

Example of the data structure returned by the app_revenue endpoint, showing metric keys, origin chains, dates, and values.

```json
[
  {
    "metric_key": "app_fees_usd",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 51420.89
  },
  {
    "metric_key": "app_fees_eth",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 16.74
  }
]
```

--------------------------------

### Request labels/projects_filtered.json

Source: https://docs.growthepie.com/api-reference/api/labels-projects-filtered-json.md

Perform a GET request to retrieve the filtered list of projects.

```http
GET https://api.growthepie.com/v1/labels/projects_filtered.json
```

--------------------------------

### Perform a GET request using curl

Source: https://docs.growthepie.com/api-reference/api/authentication.md

Use this command to fetch the master JSON file from the public API endpoint.

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

--------------------------------

### Example daa API response

Source: https://docs.growthepie.com/metric-reference/metric-reference/daa.md

Shows the structure of the JSON response returned by the daa endpoint.

```json
[
  {
    "metric_key": "daa",
    "origin_key": "arbitrum",
    "date": "2026-01-01",
    "value": 907687.0
  }
]
```

--------------------------------

### Uniswap API Response Structure

Source: https://docs.growthepie.com/use-cases/use-cases/how-to-fetch-app-level-metrics-for-uniswap.md

Example of the JSON structure returned by the Uniswap details endpoint.

```json
{
  "last_updated_utc": "2026-03-27 05:40:34",
  "metrics": {
    "txcount": {
      "metric_name": "Transaction Count",
      "avg": true
    }
  },
  "first_seen": {
    "ethereum": "2021-01-01"
  }
}
```

--------------------------------

### TVL API Response Structure

Source: https://docs.growthepie.com/metric-reference/metric-reference/tvl.md

Example of the JSON structure returned by the TVL endpoint, showing both USD and ETH values.

```json
[
  {
    "metric_key": "tvl",
    "origin_key": "arbitrum",
    "date": "2026-03-01",
    "value": 2450000000.0
  },
  {
    "metric_key": "tvl_eth",
    "origin_key": "arbitrum",
    "date": "2026-03-01",
    "value": 820000.0
  }
]
```

--------------------------------

### Retrieve App Details via HTTP GET

Source: https://docs.growthepie.com/api-reference/api/app-detail-json.md

Use this endpoint to fetch detailed metrics for a specific project. Replace {owner_project} with a valid project identifier found in labels/projects_filtered.json.

```http
GET https://api.growthepie.com/v1/apps/details/{owner_project}.json
```

```http
GET https://api.growthepie.com/v1/apps/details/uniswap.json
```

--------------------------------

### Request fundamentals.json data

Source: https://docs.growthepie.com/api-reference/api/fundamentals-json.md

Perform a GET request to retrieve the daily export of fundamental metrics.

```http
GET https://api.growthepie.com/v1/fundamentals.json
```

--------------------------------

### Example JSON response structure

Source: https://docs.growthepie.com/api-reference/api/fees-table-json.md

The response is keyed by chain and contains hourly series data for various metrics including transaction costs and throughput.

```json
{
  "chain_data": {
    "arbitrum": {
      "hourly": {
        "txcosts_median": {
          "types": ["unix", "value_eth", "value_usd", "normalized"],
          "data": [
            [1775037600000, 0.00000149534307, 0.0031, 0.37],
            [1775034000000, 0.00000125168, 0.0026, 0.24]
          ]
        },
        "tps": {
          "types": ["unix", "value", "normalized"],
          "data": [
            [1775037600000, 18.63083333333333, 0.9],
            [1775034000000, 19.433333333333334, 0.87]
          ]
        }
      }
    }
  }
}
```

--------------------------------

### GET apps/details/{owner_project}.json

Source: https://docs.growthepie.com/api-reference/api/app-detail-json.md

Retrieves detailed application-level metrics and data for a specific project identified by its owner_project slug.

```APIDOC
## GET apps/details/{owner_project}.json

### Description
Returns a rich project-level response for a covered app whose contracts have mapped activity. Use this endpoint for app-level metrics, KPI cards, first-seen dates by chain, and contract tables.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/apps/details/{owner_project}.json

### Parameters
#### Path Parameters
- **owner_project** (string) - Required - The unique identifier for the project, which must exist in labels/projects_filtered.json.

### Response
#### Success Response (200)
- **last_updated_utc** (string) - Timestamp of the last update.
- **metrics** (object) - Application-level metrics.
- **kpi_cards** (object) - KPI card data.
- **first_seen** (object) - First-seen dates by chain.
- **chains_by_size** (object) - Chain-by-chain activity data.
- **contracts_table** (object) - Contract-level tables.

### Response Example
{
  "last_updated_utc": "2026-03-27 05:40:34",
  "first_seen": {
    "polygon_pos": "2020-10-01",
    "ethereum": "2021-01-01",
    "optimism": "2021-11-11",
    "arbitrum": "2022-04-18",
    "base": "2023-07-29"
  },
  "metrics": {
    "txcount": {
      "metric_name": "Transaction Count",
      "avg": true,
      "over_time": {
        "arbitrum": {
          "daily": {
            "types": ["unix", "value"]
          }
        }
      }
    }
  },
  "contracts_table": {
    "7d": {
      "types": []
    }
  }
}
```

--------------------------------

### rent_paid API response structure

Source: https://docs.growthepie.com/metric-reference/metric-reference/rent-paid.md

Example JSON structure showing the format of the rent_paid data, including metric keys, origin chains, dates, and values.

```json
[
  {
    "metric_key": "rent_paid_usd",
    "origin_key": "optimism",
    "date": "2026-03-01",
    "value": 84521.33
  },
  {
    "metric_key": "rent_paid_eth",
    "origin_key": "optimism",
    "date": "2026-03-01",
    "value": 27.58
  }
]
```

--------------------------------

### GET fees/table.json

Source: https://docs.growthepie.com/api-reference/api/fees-table-json.md

Retrieves the latest hourly transaction-cost metrics, TPS, and throughput for supported chains.

```APIDOC
## GET https://api.growthepie.com/v1/fees/table.json

### Description
Returns per-chain hourly series for transaction-cost metrics, TPS, and throughput. This endpoint is designed for cross-chain fee comparison.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/fees/table.json

### Response
#### Success Response (200)
- **chain_data** (object) - Object keyed by origin_key, containing hourly metrics for each chain.

#### Response Example
{
  "chain_data": {
    "arbitrum": {
      "hourly": {
        "txcosts_median": {
          "types": ["unix", "value_eth", "value_usd", "normalized"],
          "data": [
            [1775037600000, 0.00000149534307, 0.0031, 0.37],
            [1775034000000, 0.00000125168, 0.0026, 0.24]
          ]
        },
        "tps": {
          "types": ["unix", "value", "normalized"],
          "data": [
            [1775037600000, 18.63083333333333, 0.9],
            [1775034000000, 19.433333333333334, 0.87]
          ]
        }
      }
    }
  }
}
```

--------------------------------

### GET v1/master.json

Source: https://docs.growthepie.com/api-reference/api.md

Retrieves metadata and coverage information including chains, metrics, DA layers, sources, and canonical metadata.

```APIDOC
## GET v1/master.json

### Description
Retrieves metadata and coverage information including chains, metrics, DA layers, sources, and canonical metadata.

### Method
GET

### Endpoint
v1/master.json
```

--------------------------------

### Interpret a flat export data object

Source: https://docs.growthepie.com/core-concepts/how-to-interpret-values-units-and-dates.md

Example of a JSON object representing a daily metric value for a specific chain.

```json
{
  "metric_key": "fees_paid_usd",
  "origin_key": "arbitrum",
  "date": "2026-03-01",
  "value": 123456.78
}
```

--------------------------------

### GET https://api.growthepie.com/v1/fundamentals.json

Source: https://docs.growthepie.com/api-reference/api/fundamentals-json.md

Retrieves a daily export of fundamental metrics including metric keys, origin keys, dates, and values for the last 90 days.

```APIDOC
## GET https://api.growthepie.com/v1/fundamentals.json

### Description
Retrieves a broad daily export of public fundamental metrics. The response is an array of flat rows containing metric keys, origin keys, dates, and values for covered chains, filtered to the last 90 days.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/fundamentals.json

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric.
- **origin_key** (string) - The identifier for the chain.
- **date** (string) - The date of the metric record.
- **value** (number) - The numerical value of the metric.

#### Response Example
[
  {
    "metric_key": "aa_last7d",
    "origin_key": "arbitrum",
    "date": "2026-01-01",
    "value": 907687.0
  },
  {
    "metric_key": "txcount",
    "origin_key": "arbitrum",
    "date": "2026-01-01",
    "value": 2525170.0
  }
]
```

--------------------------------

### GET /v1/chains/arbitrum/overview.json

Source: https://docs.growthepie.com/use-cases/use-cases/how-to-get-chain-overview-data-for-arbitrum.md

Retrieves the summary overview data for the Arbitrum chain, including highlights, events, rankings, KPI cards, achievements, and ecosystem information.

```APIDOC
## GET /v1/chains/arbitrum/overview.json

### Description
Retrieves the growthepie summary view for Arbitrum, including highlights, rankings, KPI cards, achievements, and ecosystem context.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/chains/arbitrum/overview.json

### Response
#### Success Response (200)
- **highlights** (object) - Key highlights for the chain
- **events** (object) - Relevant events
- **ranking** (object) - Ranking data
- **kpi_cards** (object) - KPI card data
- **achievements** (object) - Chain achievements
- **ecosystem** (object) - Ecosystem context
```

--------------------------------

### Profit API Response Structure

Source: https://docs.growthepie.com/metric-reference/metric-reference/profit.md

Example of the JSON structure returned by the profit endpoint, showing USD and ETH values per chain.

```json
[
  {
    "metric_key": "profit_usd",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 126430.91
  },
  {
    "metric_key": "profit_eth",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 41.22
  }
]
```

--------------------------------

### Fees API Response Structure

Source: https://docs.growthepie.com/metric-reference/metric-reference/fees.md

Example of the JSON structure returned by the fees endpoint, showing metric keys and values per chain.

```json
[
  {
    "metric_key": "fees_paid_usd",
    "origin_key": "arbitrum",
    "date": "2026-03-01",
    "value": 315245.11
  },
  {
    "metric_key": "fees_paid_eth",
    "origin_key": "arbitrum",
    "date": "2026-03-01",
    "value": 102.74
  }
]
```

--------------------------------

### GET https://api.growthepie.com/v1/master.json

Source: https://docs.growthepie.com/api-reference/api/master-json.md

Retrieves the canonical metadata index for the growthepie API, including information on chains, metrics, and data availability layers.

```APIDOC
## GET https://api.growthepie.com/v1/master.json

### Description
Retrieves the canonical metadata index for the growthepie API. This endpoint is used for discovery, metadata, coverage, and schema-aware clients.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/master.json

### Response
#### Success Response (200)
- **current_version** (string) - The API version.
- **last_updated_utc** (string) - Timestamp of the last metadata update.
- **chains** (object) - Map of supported chains and their metadata.
- **metrics** (object) - Map of supported metrics and their configurations.
- **da_layers** (object) - Data availability layers.
- **da_metrics** (object) - Data availability metrics.
- **sources** (object) - Data sources.
- **maturity_levels** (object) - Maturity levels for chains.

#### Response Example
{
  "current_version": "v1",
  "last_updated_utc": "2026-03-27 05:30:09",
  "chains": {
    "arbitrum": {
      "name": "Arbitrum One",
      "url_key": "arbitrum",
      "supported_metrics": [
        "tvl",
        "txcount",
        "daa",
        "stables_mcap",
        "fees",
        "rent_paid",
        "profit",
        "txcosts",
        "fdv",
        "market_cap",
        "throughput",
        "app_revenue"
      ]
    }
  },
  "metrics": {
    "txcount": {
      "name": "Transaction Count",
      "metric_keys": ["txcount"],
      "hourly_available": true
    }
  }
}
```

--------------------------------

### Request the fee table data

Source: https://docs.growthepie.com/api-reference/api/fees-table-json.md

Perform a GET request to retrieve the latest cross-chain fee and performance metrics.

```http
GET https://api.growthepie.com/v1/fees/table.json
```

--------------------------------

### GET v1/fundamentals.json

Source: https://docs.growthepie.com/api-reference/api.md

Retrieves a broad daily export of flat daily rows for supported fundamental metrics in the last 90 days.

```APIDOC
## GET v1/fundamentals.json

### Description
Retrieves a broad daily export of flat daily rows for supported fundamental metrics in the last 90 days.

### Method
GET

### Endpoint
v1/fundamentals.json
```

--------------------------------

### GET v1/export/{metric}.json

Source: https://docs.growthepie.com/api-reference/api.md

Retrieves flat daily rows for a single fundamental metric across all covered chains.

```APIDOC
## GET v1/export/{metric}.json

### Description
Retrieves flat daily rows for a single fundamental metric across all covered chains.

### Method
GET

### Endpoint
v1/export/{metric}.json

### Parameters
#### Path Parameters
- **metric** (string) - Required - The specific metric identifier to export.
```

--------------------------------

### Fetch all projects

Source: https://docs.growthepie.com/entity-coverage-reference/entity-coverage-reference/projects-and-owner-project.md

Retrieves the full list of projects with metadata from the canonical source.

```bash
curl -s https://api.growthepie.com/v1/labels/projects.json
```

--------------------------------

### GET /v1/export/rent_paid.json

Source: https://docs.growthepie.com/metric-reference/metric-reference/rent-paid.md

Retrieves the rent_paid metric data for supported chains.

```APIDOC
## GET /v1/export/rent_paid.json

### Description
Retrieves the rent_paid metric data, which measures the cost paid to L1 by various chains.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/export/rent_paid.json

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric (e.g., rent_paid_usd, rent_paid_eth)
- **origin_key** (string) - The identifier for the chain
- **date** (string) - The date of the record
- **value** (number) - The metric value

#### Response Example
[
  {
    "metric_key": "rent_paid_usd",
    "origin_key": "optimism",
    "date": "2026-03-01",
    "value": 84521.33
  },
  {
    "metric_key": "rent_paid_eth",
    "origin_key": "optimism",
    "date": "2026-03-01",
    "value": 27.58
  }
]
```

--------------------------------

### GET /v1/export/txcount.json

Source: https://docs.growthepie.com/metric-reference/metric-reference/txcount.md

Retrieves the transaction count data for covered chains.

```APIDOC
## GET /v1/export/txcount.json

### Description
Retrieves the transaction count metric for supported chains. This endpoint provides historical transaction data that can be used to compare chain activity or rank chains by volume.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/export/txcount.json

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric (txcount).
- **origin_key** (string) - The identifier for the chain.
- **date** (string) - The date of the transaction count.
- **value** (number) - The total transaction count for the given date.

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

--------------------------------

### GET /v1/export/txcosts.json

Source: https://docs.growthepie.com/metric-reference/metric-reference/txcosts.md

Retrieves the median transaction cost data for supported chains.

```APIDOC
## GET /v1/export/txcosts.json

### Description
Retrieves the median transaction cost data for supported chains in both USD and ETH.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/export/txcosts.json

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric (e.g., txcosts_median_usd, txcosts_median_eth)
- **origin_key** (string) - The chain identifier
- **date** (string) - The date of the record
- **value** (number) - The median cost value

#### Response Example
[
  {
    "metric_key": "txcosts_median_usd",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 0.0041
  },
  {
    "metric_key": "txcosts_median_eth",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 0.0000013
  }
]
```

--------------------------------

### GET /v1/export/stables_mcap.json

Source: https://docs.growthepie.com/metric-reference/metric-reference/stables-mcap.md

Retrieves the stablecoin market cap data for supported chains.

```APIDOC
## GET /v1/export/stables_mcap.json

### Description
Retrieves the stablecoin supply data (market cap) for covered chains, provided in both USD and ETH units.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/export/stables_mcap.json

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric (e.g., stables_mcap, stables_mcap_eth)
- **origin_key** (string) - The chain identifier
- **date** (string) - The date of the record
- **value** (number) - The calculated value in the respective unit

#### Response Example
[
  {
    "metric_key": "stables_mcap",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 3400000000.0
  },
  {
    "metric_key": "stables_mcap_eth",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 1140000.0
  }
]
```

--------------------------------

### Chain Overview Response

Source: https://docs.growthepie.com/api-reference/api/chain-overview-json.md

A sample JSON response containing chain metadata, highlights, and ecosystem metrics.

```json
{
  "last_updated_utc": "2026-03-27 05:35:04",
  "data": {
    "chain_id": "arbitrum",
    "chain_name": "Arbitrum One",
    "highlights": [
      {
        "metric_id": "txcount",
        "metric_name": "Transaction Count",
        "type": "lifetime_level_up",
        "date": "2026-03-24"
      }
    ],
    "ecosystem": {
      "active_apps": {
        "7d": 0
      }
    }
  }
}
```

--------------------------------

### GET /v1/export/profit.json

Source: https://docs.growthepie.com/metric-reference/metric-reference/profit.md

Retrieves the Onchain Profit metric data for supported chains.

```APIDOC
## GET /v1/export/profit.json

### Description
Retrieves the Onchain Profit metric data, representing the net business outcome for chains.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/export/profit.json

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric (e.g., profit_usd, profit_eth)
- **origin_key** (string) - The chain identifier
- **date** (string) - The date of the record
- **value** (number) - The profit value

#### Response Example
[
  {
    "metric_key": "profit_usd",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 126430.91
  },
  {
    "metric_key": "profit_eth",
    "origin_key": "base",
    "date": "2026-03-01",
    "value": 41.22
  }
]
```

--------------------------------

### GET labels/projects_filtered.json

Source: https://docs.growthepie.com/api-reference/api/labels-projects-filtered-json.md

Retrieves a filtered list of projects that currently have actual datapoints.

```APIDOC
## GET labels/projects_filtered.json

### Description
Retrieves a subset of project data containing only projects with actual datapoints (e.g., txcount). This endpoint is the recommended discovery source for valid owner_project values used in app-detail endpoints.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/labels/projects_filtered.json

### Response
#### Success Response (200)
- **last_updated_utc** (string) - Timestamp of the last update.
- **data** (object) - Contains the typed table of project data including types and the data array.

#### Response Example
{
  "last_updated_utc": "2026-03-27 05:40:42",
  "data": {
    "types": [
      "owner_project",
      "display_name",
      "description",
      "main_github",
      "twitter",
      "website",
      "logo_path",
      "token_symbol",
      "txcount",
      "active_on",
      "ecosystem_rank",
      "sub_category",
      "main_category",
      "sub_categories",
      "features"
    ],
    "data": [
      [
        "polymarket",
        "Polymarket",
        "Polymarket is a decentralized blockchain-based prediction market platform.",
        "polymarket",
        "Polymarket",
        "https://polymarket.com/",
        "polymarket.png",
        null,
        125438595.0,
        {
          "polygon_pos": 125438595
        },
        1,
        "Prediction Markets",
        "Finance",
        [
          "erc4337",
          "prediction_markets"
        ],
        [
          "Dummy",
          "Swap",
          "Lending",
          "Bridge",
          "Trading"
        ]
      ]
    ]
  }
}
```

--------------------------------

### Fetch App Revenue Data via cURL

Source: https://docs.growthepie.com/metric-reference/metric-reference/app-revenue.md

Use this command to export the full app_revenue dataset in JSON format from the growthepie API.

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

--------------------------------

### Filter transaction count by chain in Python

Source: https://docs.growthepie.com/getting-started/getting-started/quickstart.md

Demonstrates how to fetch the full transaction count dataset and filter it for a specific chain.

```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])
```

--------------------------------

### Throughput API response structure

Source: https://docs.growthepie.com/metric-reference/metric-reference/throughput.md

Example of the JSON structure returned by the throughput endpoint.

```json
[
  {
    "metric_key": "gas_per_second",
    "origin_key": "arbitrum",
    "date": "2026-03-01",
    "value": 5.72
  }
]
```

--------------------------------

### GET v1/labels/projects_filtered.json

Source: https://docs.growthepie.com/api-reference/api.md

Retrieves filtered project metadata for projects that have actual activity such as txcount.

```APIDOC
## GET v1/labels/projects_filtered.json

### Description
Retrieves filtered project metadata for projects that have actual activity such as txcount.

### Method
GET

### Endpoint
v1/labels/projects_filtered.json
```

--------------------------------

### Chain Overview Request

Source: https://docs.growthepie.com/api-reference/api/chain-overview-json.md

The base URL structure for retrieving chain overview data.

```http
GET https://api.growthepie.com/v1/chains/{origin_key}/overview.json
```

--------------------------------

### GET /v1/export/throughput.json

Source: https://docs.growthepie.com/metric-reference/metric-reference/throughput.md

Retrieves the throughput metric data, measured in Mgas/s, for supported chains.

```APIDOC
## GET /v1/export/throughput.json

### Description
Retrieves the raw series data for the throughput metric, identified by the key `gas_per_second`.

### Method
GET

### Endpoint
https://api.growthepie.com/v1/export/throughput.json

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric (gas_per_second).
- **origin_key** (string) - The identifier for the chain.
- **date** (string) - The date of the record.
- **value** (number) - The throughput value in Mgas/s.

#### Response Example
[
  {
    "metric_key": "gas_per_second",
    "origin_key": "arbitrum",
    "date": "2026-03-01",
    "value": 5.72
  }
]
```

--------------------------------

### Fetch master.json data

Source: https://docs.growthepie.com/recipes-tutorials/recipes/fetch-growthepie-data-in-js-ts.md

Retrieves the master configuration file and logs supported metrics for a specific chain.

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

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

const master = await response.json();
console.log(master.chains.arbitrum.supported_metrics);
```

--------------------------------

### Fetch Chain Overview Data via cURL

Source: https://docs.growthepie.com/use-cases/use-cases/how-to-compare-base-vs-arbitrum.md

Retrieves the overview JSON data for the Base network using a standard cURL request.

```bash
curl -s https://api.growthepie.com/v1/chains/base/overview.json
```