Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Equity Rank Com Screeners API
version: 0.1.0
description: 'Operations tagged screeners across 2 of this provider''s published API definitions: openapi.json, equity-rank-com-openapi.yml. Each path carries the servers of the definition it was published in.'
tags:
- name: screeners
paths:
/api/screeners/earnings-surprise:
get:
tags:
- screeners
summary: Get Earnings Surprise Screener
description: 'Stocks reporting earnings in the next 7 days, sorted by Fundamentals score (save_score).
Includes EPS estimate for the upcoming report and surprise history
from prior quarters so users can see consistency patterns.'
operationId: get_earnings_surprise_screener_api_screeners_earnings_surprise_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
additionalProperties: true
type: object
type: array
title: Response Get Earnings Surprise Screener Api Screeners Earnings Surprise Get
/api/screeners/earnings-calendar:
get:
tags:
- screeners
summary: Get Earnings Calendar
description: 'Upcoming earnings over the next `days` days (default 30, clamped 1–45),
joined with screener_cache for Fundamentals score (save_score) and valuation context. Sorted
by report_date asc, then Fundamentals score desc (nulls last). Public — no auth.
Only scored-universe names are returned so every row has model context.'
operationId: get_earnings_calendar_api_screeners_earnings_calendar_get
parameters:
- name: days
in: query
required: false
schema:
type: integer
default: 30
title: Days
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
type: object
additionalProperties: true
title: Response Get Earnings Calendar Api Screeners Earnings Calendar Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
x-refined-from:
- openapi.json
- equity-rank-com-openapi.yml