Blaze
  • Overview
    • Overview of workflows
  • Fundamentals
    • Getting set up
      • Access controls
      • Invite your team
      • Integrations
      • Custom Bot
    • Team and workspace settings
      • For workspace owners
      • For collaborators
    • FAQ
      • Subscription & Pricing
      • Workspace Settings
      • Lead Generation
      • Campaigns and Outreach
      • Forms and Rewards
  • Product Guides
    • Lead Gen and Segments
      • Segment Types
        • Saved segments
        • Curated segments
        • Community Segments
        • Uploaded Segments
      • How to filter segments
        • Twitter Audience filters
        • LinkedIn Audience filters
        • Telegram Audience filters
        • Wallet Audience filters
      • How to upload segments
        • Upload CSV
        • Paste URLs
      • How to create a lead list using Find Leads feature
      • Use Social Search to find leads or trending content
        • Twitter Social Search
          • X Post Search
          • X Account Followers
          • X Spaces Listeners
        • LinkedIn Social Search
          • LinkedIn Post Authors
          • LinkedIn Post Reactor/Commentor
      • How to use Segment Wizard to build lead lists instantly
      • How to generate a lead list or segment of wallets using Wallet CRM
        • How to refine & create a segment of wallets
        • Reach out to Wallet CRM leads
      • How to split a segment into multiple subsegments for A/B testing
      • Capture leads and sign ups with Forms
        • Create and share a form
        • View form responses
        • Embed a form on your website
        • Auto-send forms to new Discord users
    • DM Campaigns and Marketing Automation
      • Run multi-step DM campaigns
      • AI Personalization
      • AI Replies (Coming Soon)
      • Start Ad Campaigns using Blaze
      • Unified Inbox
      • Manage Discord Campaigns and DMs
        • Discord DM Users
      • Rewards, Social Referrals and Quests
        • Create a Rewards Campaign
          • Available Actions
          • Edit campaign
        • Share quest page and track performance
        • Distribute Rewards
      • Run campaigns via XMTP Wallet Messaging
      • Distribute Airdrops to on-chain leads
      • Distribute NFTs to your users
    • Social Media Management - Twitter
      • Post and Schedule Tweets
      • Post and Schedule Farcaster Casts
      • Post Library
      • Top Performing Tweets
      • Twitter Analytics
        • Understand Twitter growth and engagement
    • Discord Analytics
      • Comprehensive Overview of your Discord Community
      • Create Discord Custom Report of your community
      • Find Sentiment of Discord Community
      • Analyze Engagement rate of your Discord Members
      • Find Topics discussed by your Discord Community
      • Product Feedback + User Insights
        • Messages
        • Message Explorer
        • Trend Explorer
        • Collect feedback with forms
        • Invite Attribution
      • Measure cross-platform marketing campaigns
    • Wallet metrics glossary
    • KOL Index
    • Cross Platform Analytics
      • Create and analyze a Twitter campaign
  • Blaze API
    • Getting started
      • Set up the Zapier integration
      • Set up API access
    • Data API
      • Active Users
      • Price
      • New users
      • Transaction Count
      • Market Cap
      • Transaction Fees
      • Official Account Metrics
      • Community Mentions Metrics
      • Retention Metrics
    • Community API
      • Ping
      • Member Details
      • Member Activity
      • Members Activity By Id
      • Discord Messages
      • Invite Attributions
    • CRM and Rewards API
      • Overview
        • Schema
        • Transaction Operations
      • Create User
      • Update User
      • Delete User
      • Create Transaction
      • Retrieve Transactions
      • Update Transaction
      • Delete Transaction
      • Leaderboard
      • Tasks and User Completion
    • Wallet Intelligence and Identity API
      • Wallet Holdings
      • Smart Contract Interactions
      • Average Token Hold Time
      • Wallet Traits
      • Wallet Scores
      • Wallet Socials
      • Token Holders
  • Get in touch
    • Support
    • Feedback
Powered by GitBook
On this page

Was this helpful?

  1. Blaze API
  2. Data API

Retention Metrics

Rest API to fetch the retention metrics of a specified blockchain

PreviousCommunity Mentions MetricsNextCommunity API

Last updated 1 year ago

Was this helpful?

Description

This endpoint retrieves the weekly retention metrics of the 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 cohort_start_date (in YYYY-MM-DD format) and its retention in terms of user_count

  • 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-05-08",
  "end_date": "2023-05-31"
}

Sample Response

{
'data': [
        {
            'cohort_start_date': '2023-05-08',
            'retention': [
                {'user_count': 459145, 'week': '2023-05-08'},
                {'user_count': 73155, 'week': '2023-05-15'},
                {'user_count': 49940, 'week': '2023-05-22'},
                {'user_count': 38329, 'week': '2023-05-29'},
            ],
        },
        {
            'cohort_start_date': '2023-05-15',
            'retention': [
                {'user_count': 493032, 'week': '2023-05-15'},
                {'user_count': 69020, 'week': '2023-05-22'},
                {'user_count': 61726, 'week': '2023-05-29'},
            ],
        }
        ....
    }

Example

POST https://dashboard.withblaze.app/api/business-metrics/retention

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

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

Run in Postman