---
updatedAt: 2026-10-17T18:41:15.000Z
agentTools:
  projectIndex: https://askedgar.readme.io/llms.txt
---

# Gap Stats API — Historical Gap-Ups & Gap-and-Fade Research

Research recorded small-cap gap-ups dating back to 2015, with opening and closing prices, session highs and lows, their timestamps, volume, and associated news and filing tags.

## Overview

See how a stock behaved on previous recorded gap days before researching its latest move.

For small- and nano-cap traders, the gap percentage is only the starting point. Review where the stock opened and closed, how far it traded above or below the open, and when its session high and low occurred. Add premarket activity, trading volume, and associated news and filing tags for context.

Use these records to investigate a ticker’s history of gap-and-go and gap-and-fade behavior, calculate your own summary statistics, and build datasets for backtesting.

This endpoint requires a single ticker and returns records with the most recent dates first. To search across tickers or apply date and numeric filters, use [Gap Stats Advanced](https://askedgar.readme.io/reference/get_gap_stats_advanced).

## What you can build

* **A ticker gap-history dashboard:** Display previous gap days with gap percentage, opening and closing prices, session extremes, and volume.
* **A gap-and-fade research tool:** Calculate open-to-close performance and compare how far each recorded gap traded above and below its opening price.
* **A timing study:** Compare the times of historical session highs and lows across a ticker’s recorded gap days.
* **A catalyst comparison:** Group records by associated news tags or filing types to investigate differences in trading behavior.

## Build with AI

“Using [AskEdgar’s Gap Stats API](https://askedgar.readme.io/reference/get_gap_stats), build a gap-history dashboard for a ticker I enter. Load all result pages. Show each recorded gap date, gap percentage, previous close, open, high and low with their timestamps, close, premarket volume, daily volume, and associated news and filing tags. Calculate open-to-close returns and the percentage moves from the open to the session high and low. Let me sort the table and summarize how often the recorded gaps closed below their opening price.”

## Which gap events are collected?

The current daily scanner selects stocks with:

* An opening gap of **20% or more**.
* At least **$5 million in daily dollar volume**.
* Daily volume at least **10 times the historical median**, using up to 60 prior daily bars.
* A daily low of at least **$0.10**.
* A market cap below **$1 billion** under the scanner’s market-cap checks.

These are collection criteria, not filters you supply to this endpoint. The basic endpoint retrieves recorded events for one ticker.

## Key parameters

* `ticker` *(required)* — single symbol.
* `page` and `limit` — paginate through the recorded events.

## Response highlights

* `date`, `market_open`, `previous_day_close`, `gap_percentage`, `market_close` — the event date, prices, and opening gap.
* `high_price`, `low_price`, `high_time`, `low_time` — regular-session extremes and the timestamps of their one-minute bars.
* `premarket_vwap`, `premarket_volume`, `premarket_dollar_volume` — premarket activity.
* `volume`, `dollar_volume`, `market_cap` — trading activity and company size.
* `closed_over_vwap`, `afterhours_close` — whether the stock closed above the calculated VWAP, and its after-hours closing price.
* `all_tags`, `filing_types` — associated news tags and SEC filing types.

## Prices and timestamps

Prices reflect the prices traded on the event date rather than being adjusted for subsequent stock splits.

**Reverse-split exception:** On a recorded reverse-split date, `previous_day_close` is converted to its post-split equivalent before calculating `gap_percentage`. This prevents the split itself from being counted as a price gap.

`high_time` and `low_time` identify the one-minute bars containing the regular-session high and low. Times use **U.S. Eastern Time (ET)**—EST or EDT depending on the date.

## Backtesting context

**Historical event coverage:** Research a defined sample of small-cap gap-ups meeting the collection criteria above. Compare trading behavior across gap sizes, volume levels, and company sizes, and show the number of events in each comparison.

**Using the data in backtests:** Event selection uses completed-day volume and dollar volume. Use these records for historical event comparisons. When simulating an entry at the open, distinguish information available at entry from completed-session selection criteria and outcomes.

**News and filing context:** Use associated tags to group events and explore the news and filings surrounding each move.

* **Add historical float for deeper research.** Use the [Historical Float API](https://askedgar.readme.io/reference/get_historical_float_pro) to enrich gap records with the most recent reported-date checkpoint before each gap date.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "AskEdgar API",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://eapi.askedgar.io"
    }
  ],
  "paths": {
    "/v1/gap-stats": {
      "get": {
        "tags": [
          "Gap Stats"
        ],
        "summary": "Gap Stats API — Historical Gap-Ups & Gap-and-Fade Research",
        "description": "Research recorded small-cap gap-ups dating back to 2015, with opening and closing prices, session highs and lows, their timestamps, volume, and associated news and filing tags.",
        "operationId": "get_gap_stats",
        "parameters": [
          {
            "name": "ticker",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Ticker"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 1,
              "title": "Page"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 10,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success GapStats",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GapStatsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Invalid or missing API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiKeyErrorResponse"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credits",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InsufficientCreditsErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Endpoint not allowed for your organization or API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EndpointNotAllowedErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit or trial ticker limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RateLimitErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyHeader": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ApiKeyErrorResponse": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/RequestStatus"
          },
          "error": {
            "$ref": "#/components/schemas/ErrorDetail"
          },
          "request_id": {
            "type": "string",
            "title": "Request Id",
            "default": ""
          }
        },
        "type": "object",
        "required": [
          "status",
          "error"
        ],
        "title": "ApiKeyErrorResponse",
        "examples": [
          {
            "error": {
              "code": "missing_api_key",
              "details": {},
              "message": "API key is required. Pass it in the API-KEY header."
            },
            "request_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
            "status": "error"
          },
          {
            "error": {
              "code": "invalid_api_key",
              "details": {},
              "message": "Invalid API key."
            },
            "request_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
            "status": "error"
          }
        ]
      },
      "EndpointNotAllowedErrorResponse": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/RequestStatus"
          },
          "error": {
            "$ref": "#/components/schemas/ErrorDetail"
          },
          "request_id": {
            "type": "string",
            "title": "Request Id",
            "default": ""
          }
        },
        "type": "object",
        "required": [
          "status",
          "error"
        ],
        "title": "EndpointNotAllowedErrorResponse",
        "examples": [
          {
            "error": {
              "code": "endpoint_not_allowed",
              "details": {},
              "message": "Your organization does not have access to this endpoint."
            },
            "request_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
            "status": "error"
          }
        ]
      },
      "ErrorDetail": {
        "properties": {
          "code": {
            "type": "string",
            "title": "Code"
          },
          "message": {
            "type": "string",
            "title": "Message"
          },
          "details": {
            "additionalProperties": true,
            "type": "object",
            "title": "Details",
            "default": {}
          }
        },
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "title": "ErrorDetail"
      },
      "GapStats": {
        "properties": {
          "ticker": {
            "type": "string",
            "title": "Ticker"
          },
          "date": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "title": "Date"
          },
          "market_open": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Market Open"
          },
          "previous_day_close": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Previous Day Close"
          },
          "gap_percentage": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Gap Percentage"
          },
          "high_price": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "High Price"
          },
          "high_time": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "High Time"
          },
          "low_price": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Low Price"
          },
          "low_time": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Low Time"
          },
          "market_close": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Market Close"
          },
          "closed_over_vwap": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Closed Over Vwap"
          },
          "premarket_vwap": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Premarket Vwap"
          },
          "premarket_dollar_volume": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Premarket Dollar Volume"
          },
          "premarket_volume": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Premarket Volume"
          },
          "volume": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Volume"
          },
          "dollar_volume": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Dollar Volume"
          },
          "market_cap": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Market Cap"
          },
          "all_tags": {
            "anyOf": [
              {
                "items": {},
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "All Tags"
          },
          "filing_types": {
            "anyOf": [
              {
                "items": {},
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Filing Types"
          },
          "afterhours_close": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Afterhours Close"
          },
          "last_updated": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Updated"
          }
        },
        "type": "object",
        "required": [
          "ticker"
        ],
        "title": "GapStats"
      },
      "GapStatsResponse": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/RequestStatus"
          },
          "count": {
            "type": "integer",
            "title": "Count"
          },
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "has_more": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Has More"
          },
          "page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Page"
          },
          "limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Limit"
          },
          "results": {
            "items": {
              "$ref": "#/components/schemas/GapStats"
            },
            "type": "array",
            "title": "Results"
          }
        },
        "type": "object",
        "required": [
          "status",
          "count",
          "results"
        ],
        "title": "GapStatsResponse",
        "examples": [
          {
            "status": "success",
            "count": 1,
            "message": null,
            "has_more": true,
            "page": 1,
            "limit": 2,
            "results": [
              {
                "ticker": "DVLT",
                "date": "2025-10-20",
                "market_open": 2.16,
                "previous_day_close": 1.79,
                "gap_percentage": 20.67,
                "high_price": 2.48,
                "high_time": "2025-10-20T14:52:00-05:00",
                "low_price": 2.02,
                "low_time": "2025-10-20T09:17:00-05:00",
                "market_close": 2.425,
                "closed_over_vwap": true,
                "premarket_vwap": 2.1113,
                "premarket_dollar_volume": 17350907.82,
                "premarket_volume": 8218059,
                "volume": 73693379,
                "dollar_volume": 166240357.26,
                "market_cap": 689013491.98,
                "all_tags": [
                  "Financing Activity",
                  "Expansion Plans",
                  "Upcoming Events",
                  "Product Launches",
                  "Capital Structure",
                  "Partnerships",
                  "Financial Performance",
                  "Dilution",
                  "Cryptocurrency"
                ],
                "filing_types": [
                  "news"
                ],
                "afterhours_close": 2.38,
                "last_updated": "2026-01-28T17:19:13.179485-05:00"
              }
            ],
            "usage": {
              "response_bytes": 1274,
              "billed_bytes": 0,
              "cost_microdollars": 0,
              "cost_dollars": "$0.000000",
              "credits_remaining_microdollars": null,
              "credits_remaining_dollars": null,
              "cached": false
            }
          }
        ]
      },
      "InsufficientCreditsErrorResponse": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/RequestStatus"
          },
          "error": {
            "$ref": "#/components/schemas/ErrorDetail"
          },
          "request_id": {
            "type": "string",
            "title": "Request Id",
            "default": ""
          }
        },
        "type": "object",
        "required": [
          "status",
          "error"
        ],
        "title": "InsufficientCreditsErrorResponse",
        "examples": [
          {
            "error": {
              "code": "insufficient_credits",
              "details": {
                "balance": 500000,
                "estimated_cost": 1000000,
                "unit": "microdollars"
              },
              "message": "Insufficient credits to process this request."
            },
            "request_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
            "status": "error"
          }
        ]
      },
      "RateLimitErrorResponse": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/RequestStatus"
          },
          "error": {
            "$ref": "#/components/schemas/ErrorDetail"
          },
          "request_id": {
            "type": "string",
            "title": "Request Id",
            "default": ""
          }
        },
        "type": "object",
        "required": [
          "status",
          "error"
        ],
        "title": "RateLimitErrorResponse",
        "examples": [
          {
            "error": {
              "code": "rate_limit_exceeded",
              "details": {
                "limit": 200,
                "retry_after": 42,
                "window": "1m"
              },
              "message": "Rate limit exceeded."
            },
            "request_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
            "status": "error"
          }
        ]
      },
      "RequestStatus": {
        "type": "string",
        "enum": [
          "success",
          "error"
        ],
        "title": "RequestStatus"
      },
      "ValidationErrorResponse": {
        "properties": {
          "status": {
            "$ref": "#/components/schemas/RequestStatus"
          },
          "error": {
            "$ref": "#/components/schemas/ErrorDetail"
          },
          "request_id": {
            "type": "string",
            "title": "Request Id",
            "default": ""
          }
        },
        "type": "object",
        "required": [
          "status",
          "error"
        ],
        "title": "ValidationErrorResponse",
        "examples": [
          {
            "error": {
              "code": "validation_error",
              "details": {
                "fields": [
                  {
                    "field": "ticker",
                    "reason": "Value error, Field 'ticker' must contain only uppercase letters, numbers, dots, hyphens, or carets."
                  }
                ]
              },
              "message": "Request validation failed."
            },
            "request_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
            "status": "error"
          }
        ]
      }
    },
    "securitySchemes": {
      "ApiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "API-KEY"
      }
    }
  }
}
```