CounterFlow Position Signals – Strategic Bitcoin Alerts 📲 CounterFlow Position Signals 📲 ✕
Nakamoto Pro Exclusive: Full access to the API and premium BitcoinCounterFlow data

Manage Your API Key

Generate or delete your API key to access data endpoints.

Note: Our API is continuously enhanced to provide robust data access. Comprehensive documentation is forthcoming to streamline integration.

Bitcoin CounterFlow Data API

API Support: satoshi@bitcoincounterflow.com
API Root Endpoint: https://api.bitcoincounterflow.com/

The Bitcoin CounterFlow Data API provides access to price history, funding rates, open interest, liquidation data, and other macro Bitcoin metrics. Designed for traders, analysts, and developers requiring advanced data.

API Usage Instructions

Nakamoto Pro subscribers have exclusive access to all API endpoints. Append your API key to the URL using the apikey parameter. Explore examples and tools below to get started.
Basic Usage: Add your API key to any endpoint. Example for M2 Global Growth: https://api.bitcoincounterflow.com/api/m2-global?apikey=YOUR_API_KEY

Data Filtering: The open-interest, funding-rate, long-short, liquidations, and liquidation-heatmap endpoints support parameters for filtering and aggregation: Supported Intervals (open-interest, funding-rate, long-short-ratio, liquidations): 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1mo (30 days). Supported Periods (liquidation-heatmap): 12h, 24h, 48h, 3day, 1week, 2week, 1month, 2month, 3month, 6month.
Example with Combined Parameters: https://api.bitcoincounterflow.com/api/liquidation-heatmap?period=1month&apikey=YOUR_API_KEY

Request History

    Endpoint Details

    M2 Global Growth (/api/m2-global): Returns historical M2 supply data, year-over-year growth, and Bitcoin price at each point.

    [{
    "date": "2013-05-20T00:00:00.000Z",
    "btcPrice": 117.8186364699,
    "yoyGrowth": 5.5654014717,
    "m2Supply": 59166686473105
}]

    Open Interest (/api/open-interest): Historical open interest data for Bitcoin futures, including BTC price. Supports days and interval parameters.

    [{
    "timestamp": "2024-10-30T08:00:00.000Z",
    "openInterest": 89828.522,
    "price": 72475.88
}]

    Long/Short Ratio (/api/long-short-ratio): Aggregated long/short ratio from major exchanges. Supports days and interval parameters.

    [{
    "timestamp": "2025-06-08T23:18:41.856Z",
    "longShortRatio": 1.25,
    "price": 72475.88
}]

    Liquidations (Derivatives) (/api/liquidations): Historical liquidation data for Bitcoin derivatives, including long/short breakdowns. Supports days and interval parameters.

    [{
    "timestamp": "2025-06-08T23:18:41.856Z",
    "longLiquidations": 12345.67,
    "shortLiquidations": 9876.54,
    "totalLiquidations": 22222.21
}]

    Funding Rate - Complete Data (/api/list-global-funding-rate): Aggregated global funding rate from major exchanges. Supports days and interval parameters.

    [{
    "timestamp": "2025-06-08T23:18:41.856Z",
    "globalFundingRate": -0.0027
}]

    Liquidation Heatmap (/api/liquidation-heatmap): Returns price ranges and liquidity values, sorted by price range. Supports period parameter.

    [{
    "priceRange": 50000,
    "liquidity": 1234567.89
}, {
    "priceRange": 50200,
    "liquidity": 987654.32
}]

    MVRV Ratio (/api/mvrv): Market Value to Realized Value ratio for Bitcoin, indicating over/undervaluation.

    [{
    "timestamp": "2025-06-08T23:18:41.856Z",
    "mvrv": 2.15
}]

    DXY (US Dollar Index) (/api/dxy): Historical US Dollar Index data, correlated with Bitcoin performance.

    [{
    "date": "2025-06-08T00:00:00.000Z",
    "dxy": 105.23,
    "btcPrice": 72475.88
}]

    Request Limits: 200 requests per hour per API key, 100 per IP. Common errors: 401 Unauthorized (invalid key), 429 Too Many Requests (rate limit exceeded).

    CounterFlow Model NEW ×