New users

Rest API to fetch the new users for a given chain

Description

This endpoint retrieves the new users on a specified blockchain for a given date range. It requires an API key for authentication and valid date range inputs.

Request

• Method: GET

• Headers:

  • X-API-Key: A valid API key for authentication.

• Body Parameters:

  • chain: The blockchain to query. This should be one of ETHEREUM, ARBITRUM, BSC, OPTIMISM, BASE or POLYGON

  • start_date: The start date for the query (YYYY-MM-DD format).

  • end_date: The end date for the query (YYYY-MM-DD format).

Response

• Success: Returns a JSON array of objects with date (in YYYY-MM-DD format) and new_users.

• Error: Returns an error message with an appropriate status code in case of invalid API key, missing parameters, or server issues.

Sample Request

{
  "chain": "ETHEREUM",
  "start_date": "2023-01-01",
  "end_date": "2023-01-07"
}

Sample Response

[
  {"date": "2023-01-01", "new_users": 39701},
  {"date": "2023-01-02", "new_users": 46877},
  ...
]

Example

POST https://dashboard.withblaze.app/api/chain-insights/new_users

Headers

Name	Type	Description
x-api-key*	API-KEY	Your Blaze API Key

Request Body

Name	Type	Description
chain*	Enum	One of the supported chains - ETHEREUM, ARBITRUM, BSC, OPTIMISM, BASE or POLYGON
start_date*	String	Start date for the queried metric
end_date*	String	End date for the queried metric

200: OK Successful response

[
  {"date": "2023-01-01", "active_users": 12000},
  {"date": "2023-01-02", "active_users": 12500},
  ...
]

400: Bad Request If required parameters are missing or incorrect

401: Unauthorized If the API key is missing

403: Forbidden If the API key is invalid