> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockline.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Discover Hot Accounts

> Discover the hottest accounts with the most write lock contention across the entire Solana network. Returns ranked list with hot scores and heatmap data for the top 20 accounts. Very expensive queries - can take 2-5+ minutes. No caching. Requires either time_range OR slot parameter.



## OpenAPI

````yaml /api-reference/openapi.json post /api/write-locks/hot-accounts
openapi: 3.0.3
info:
  title: Blockline MEV Analytics API
  description: >-
    Professional MEV analytics API for Solana. Analyze transaction context,
    detect front-running, identify sandwich attacks, and gain competitive
    intelligence on Solana MEV activity.
  version: 1.0.0
  contact:
    name: Blockline Support
    url: https://blockline.soltop.sh
servers:
  - url: https://api.soltop.sh
    description: Production API
security:
  - ApiKeyAuth: []
tags:
  - name: Trade Analysis
    description: Analyze MEV activity and transaction context
  - name: Transactions
    description: Transaction details and metadata
  - name: Wallets
    description: Wallet transaction history
  - name: Data Management
    description: Backfill and data operations
  - name: MEV Analysis
    description: >-
      Sandwich attack detection: scan wallets, check transactions, and profile
      attackers (async job queue)
  - name: Write Locks
    description: Account write lock contention and hot account analysis
paths:
  /api/write-locks/hot-accounts:
    post:
      tags:
        - Write Locks
      summary: Discover Hot Accounts
      description: >-
        Discover the hottest accounts with the most write lock contention across
        the entire Solana network. Returns ranked list with hot scores and
        heatmap data for the top 20 accounts. Very expensive queries - can take
        2-5+ minutes. No caching. Requires either time_range OR slot parameter.
      operationId: discoverHotAccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                time_range:
                  type: string
                  description: 'Query mode 1: Time range (mutually exclusive with slot)'
                  enum:
                    - 1h
                    - 3h
                    - 6h
                    - 12h
                  example: 6h
                slot:
                  type: integer
                  description: >-
                    Query mode 2: Specific slot number (mutually exclusive with
                    time_range)
                  minimum: 1
                  example: 370537741
                limit:
                  type: integer
                  description: Number of hot accounts to return
                  default: 50
                  minimum: 1
                  maximum: 100
                  example: 50
      responses:
        '200':
          description: Ranked list of hot accounts with heatmap data
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      query_mode:
                        type: string
                        enum:
                          - time_range
                          - slot
                        example: time_range
                      query_value:
                        type: string
                        example: 6h
                      slot_range:
                        type: object
                        properties:
                          min:
                            type: integer
                            example: 370500000
                          max:
                            type: integer
                            example: 370537741
                      limit:
                        type: integer
                        example: 50
                      hot_accounts:
                        type: array
                        description: Ranked by hot_score descending
                        items:
                          type: object
                          properties:
                            account_id:
                              type: string
                              example: FnmStvzQ27Pm4U8r3M6gPD7mnk6ST6HwraPsoNmYpump
                            write_count:
                              type: integer
                              description: Total write operations
                              example: 2340
                            conflict_count:
                              type: integer
                              description: Total conflict events
                              example: 89
                            unique_signers:
                              type: integer
                              description: Number of unique wallets
                              example: 45
                            hot_score:
                              type: number
                              description: Calculated hot score (0-10)
                              example: 8.5
                      heatmap_data:
                        type: array
                        description: >-
                          Time-bucketed access patterns for top 20 accounts (up
                          to 1000 data points)
                        items:
                          type: object
                          properties:
                            slot:
                              type: integer
                              example: 370537741
                            account_id:
                              type: string
                              example: FnmStvzQ27Pm4U8r3M6gPD7mnk6ST6HwraPsoNmYpump
                            access_count:
                              type: integer
                              description: Total access count
                              example: 25
                            write_count:
                              type: integer
                              description: Write operations
                              example: 18
                            read_count:
                              type: integer
                              description: Read operations
                              example: 7
                            timestamp:
                              type: string
                              format: date-time
                              example: '2025-10-01T19:22:33Z'
                  timestamp:
                    type: string
                    format: date-time
                    example: '2025-10-02T15:30:45.123Z'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                missing_param:
                  value:
                    error: Missing required parameter
                    details: Must provide either time_range or slot
                    timestamp: '2025-10-02T15:30:45.123Z'
                conflicting_params:
                  value:
                    error: Invalid parameters
                    details: Cannot provide both time_range and slot
                    timestamp: '2025-10-02T15:30:45.123Z'
        '401':
          $ref: 02ca5649-c9d9-4a5e-8f26-a133d5c61cc5
        '403':
          $ref: 80776eac-c595-4f19-9646-9d6dc9a6cf2c
        '429':
          $ref: cfbde83c-0b04-46b0-b46a-c3a713982079
      security:
        - SupabaseJWT: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        details:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          description: Detailed error information
        timestamp:
          type: string
          format: date-time
          description: When the error occurred
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        API Key authentication. Format: `sk_live_xxx` (production) or
        `sk_test_xxx` (testing). Obtain your API key from the [Blockline
        Dashboard](https://blockline.soltop.sh/dashboard/api-keys).
    SupabaseJWT:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Supabase JWT authentication. Used for MEV Analysis and Write Locks
        endpoints. Requires an active subscription (trial, active, or
        grace_period status).

````