growthepie

https://docs.growthepie.com/
Admin
growthepie is a data platform for Ethereum Mainnet, Layer 2s, Ethereum-aligned chains, apps, and...
Tokens:24,675
Snippets:323
Trust Score:8.3
Update:3 months ago
Show doc for...
Tokens:
Raw
### 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 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 /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
  }
]
```

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

### 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
  }
]
```

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

### 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
  }
]
```

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

### 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 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 /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
    }
  }
}
```

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

### 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
```

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

### 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/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 /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/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 /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
```

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

### 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
```

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

### 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
  }
]
```

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

### GET /v1/export/fdv.json

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

Retrieves the Fully Diluted Valuation (fdv) data for supported chains.

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

### Description
Retrieves the Fully Diluted Valuation (fdv) data for supported chains in USD and ETH.

### Method
GET

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

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

#### Response Example
[
  {
    "metric_key": "fdv_usd",
    "origin_key": "arbitrum",
    "date": "2026-03-01",
    "value": 14500000000.0
  },
  {
    "metric_key": "fdv_eth",
    "origin_key": "arbitrum",
    "date": "2026-03-01",
    "value": 4850000.0
  }
]
```

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

### 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);
```

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

### 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
```

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

### 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"
  }
}
```

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

### 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
```

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

### GET /v1/export/daa.json

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

Retrieves the daily active addresses (DAA) metric data for supported chains.

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

### Description
Retrieves the daily active addresses (DAA) metric data for supported chains. Use this metric as an address-level activity proxy.

### Method
GET

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

### Response
#### Success Response (200)
- **metric_key** (string) - The identifier for the metric (daa).
- **origin_key** (string) - The identifier for the chain.
- **date** (string) - The date of the record in YYYY-MM-DD format.
- **value** (number) - The count of active addresses.

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

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

### Fetch rent_paid data via API

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

Use this curl command to retrieve the full rent_paid dataset from the growthepie API.

```bash
curl -s https://api.growthepie.com/v1/export/rent_paid.json
```
Tokens:
Raw