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

# Get MEV Job Status

> Poll for job status and retrieve results when complete. Used for check-wallet, check-attacker, and check-sandwich jobs. Job states: waiting (queued), active (processing), completed (results available), failed (error occurred).



## OpenAPI

````yaml /api-reference/openapi.json get /mev/job-status/{jobId}
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:
  /mev/job-status/{jobId}:
    get:
      tags:
        - MEV Analysis
      summary: Get MEV Job Status
      description: >-
        Poll for job status and retrieve results when complete. Used for
        check-wallet, check-attacker, and check-sandwich jobs. Job states:
        waiting (queued), active (processing), completed (results available),
        failed (error occurred).
      operationId: getMevJobStatus
      parameters:
        - name: jobId
          in: path
          required: true
          description: >-
            Job ID returned from check-wallet, check-attacker, or check-sandwich
            endpoint
          schema:
            type: string
            example: abc123def456
      responses:
        '200':
          description: Job status and results (if completed)
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    description: Job in progress
                    properties:
                      success:
                        type: boolean
                        example: true
                      id:
                        type: string
                        example: abc123def456
                      state:
                        type: string
                        enum:
                          - waiting
                          - active
                        example: active
                      progress:
                        type: number
                        description: 0-100
                        example: 45
                      createdAt:
                        type: string
                        format: date-time
                        example: '2025-10-02T15:30:00Z'
                  - type: object
                    description: Job completed
                    properties:
                      success:
                        type: boolean
                        example: true
                      id:
                        type: string
                      state:
                        type: string
                        enum:
                          - completed
                        example: completed
                      progress:
                        type: number
                        example: 100
                      createdAt:
                        type: string
                        format: date-time
                      data:
                        type: object
                        description: Analysis results (structure depends on job type)
                  - type: object
                    description: Job failed
                    properties:
                      success:
                        type: boolean
                        example: true
                      id:
                        type: string
                      state:
                        type: string
                        enum:
                          - failed
                        example: failed
                      error:
                        type: string
                        example: Analysis timeout after 15 minutes
                      createdAt:
                        type: string
                        format: date-time
        '401':
          $ref: 02ca5649-c9d9-4a5e-8f26-a133d5c61cc5
        '404':
          description: Job not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Job not found
                details: 'No job found with ID: abc123def456'
                timestamp: '2025-10-02T15:30:45.123Z'
      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).

````