Tradytics Options flow API
The Options flow API from Tradytics — 6 operation(s) for options flow.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/tradytics:tradytics-options-flow-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Tradytics Options flow API
version: '1.0'
description: 'Operations tagged Options flow across 2 of this provider''s published API definitions: tradytics-openapi.json, tradytics-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: /api/public/v1
security:
- apiKey: []
tags:
- name: Options flow
paths:
/options/flow:
get:
tags:
- Options flow
summary: Options flow
operationId: flow_options_flow_get
parameters:
- name: symbol
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Underlyings, comma separated (e.g. `NVDA,AMD`). Default all.
title: Symbol
description: Underlyings, comma separated (e.g. `NVDA,AMD`). Default all.
- name: date
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: One session, `YYYY-MM-DD` (New York).
title: Date
description: One session, `YYYY-MM-DD` (New York).
- name: from
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Start: `YYYY-MM-DD` or an RFC 3339 time.'
title: From
description: 'Start: `YYYY-MM-DD` or an RFC 3339 time.'
- name: to
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'End: `YYYY-MM-DD` or an RFC 3339 time. Default now.'
title: To
description: 'End: `YYYY-MM-DD` or an RFC 3339 time. Default now.'
- name: since
in: query
required: false
schema:
anyOf:
- type: integer
maximum: 18446744073709551615
minimum: 0
- type: 'null'
description: Only rows after this `id`, oldest first (polling).
title: Since
description: Only rows after this `id`, oldest first (polling).
- name: type
in: query
required: false
schema:
anyOf:
- enum:
- call
- put
type: string
- type: 'null'
title: Type
- name: kind
in: query
required: false
schema:
anyOf:
- enum:
- sweep
- block
- split
- single
type: string
- type: 'null'
title: Kind
- name: side
in: query
required: false
schema:
anyOf:
- enum:
- bought
- sold
- mid
type: string
- type: 'null'
title: Side
- name: min_premium
in: query
required: false
schema:
type: integer
minimum: 0
description: Minimum premium, USD.
default: 0
title: Min Premium
description: Minimum premium, USD.
- name: expiry
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: One expiry, `YYYY-MM-DD`.
title: Expiry
description: One expiry, `YYYY-MM-DD`.
- name: dte
in: query
required: false
schema:
anyOf:
- type: integer
maximum: 3650
minimum: 0
- type: 'null'
description: 'Only contracts expiring within this many days (0: same day).'
title: Dte
description: 'Only contracts expiring within this many days (0: same day).'
- name: contract
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: One contract, OCC symbol (e.g. `NVDA261218C00150000`).
title: Contract
description: One contract, OCC symbol (e.g. `NVDA261218C00150000`).
- name: opening
in: query
required: false
schema:
type: boolean
description: Only prints larger than the open interest.
default: false
title: Opening
description: Only prints larger than the open interest.
- name: limit
in: query
required: false
schema:
type: integer
maximum: 1000
minimum: 1
description: Rows per page, up to 1000.
default: 100
title: Limit
description: Rows per page, up to 1000.
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: '`next_cursor` from the previous page.'
title: Cursor
description: '`next_cursor` from the previous page.'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid or missing request parameters
servers:
- url: /api/public/v1
/options/flow/timeline:
get:
tags:
- Options flow
summary: Flow timeline
operationId: timeline_options_flow_timeline_get
parameters:
- name: symbol
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Underlyings, comma separated. Default all single stocks.
title: Symbol
description: Underlyings, comma separated. Default all single stocks.
- name: interval
in: query
required: false
schema:
enum:
- 1m
- 5m
- 15m
- 1h
- 1d
type: string
default: 5m
title: Interval
- name: date
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: One session, `YYYY-MM-DD` (New York).
title: Date
description: One session, `YYYY-MM-DD` (New York).
- name: from
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Start: `YYYY-MM-DD` or an RFC 3339 time.'
title: From
description: 'Start: `YYYY-MM-DD` or an RFC 3339 time.'
- name: to
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'End: `YYYY-MM-DD` or an RFC 3339 time. Default now.'
title: To
description: 'End: `YYYY-MM-DD` or an RFC 3339 time. Default now.'
- name: dte
in: query
required: false
schema:
anyOf:
- type: integer
maximum: 3650
minimum: 0
- type: 'null'
description: 'Only contracts expiring within this many days (0: same day).'
title: Dte
description: 'Only contracts expiring within this many days (0: same day).'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid or missing request parameters
servers:
- url: /api/public/v1
/options/flow/leaders:
get:
tags:
- Options flow
summary: Flow leaders
operationId: leaders_options_flow_leaders_get
parameters:
- name: by
in: query
required: false
schema:
enum:
- symbol
- sector
type: string
default: symbol
title: By
- name: direction
in: query
required: false
schema:
enum:
- bullish
- bearish
type: string
default: bullish
title: Direction
- name: date
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: One session, `YYYY-MM-DD` (New York).
title: Date
description: One session, `YYYY-MM-DD` (New York).
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
description: Rows per page, up to 100.
default: 25
title: Limit
description: Rows per page, up to 100.
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: '`next_cursor` from the previous page.'
title: Cursor
description: '`next_cursor` from the previous page.'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid or missing request parameters
servers:
- url: /api/public/v1
/options/flow/strikes:
get:
tags:
- Options flow
summary: Flow by strike
operationId: strikes_options_flow_strikes_get
parameters:
- name: symbol
in: query
required: true
schema:
type: string
description: Underlying, e.g. `NVDA`.
title: Symbol
description: Underlying, e.g. `NVDA`.
- name: date
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: One session, `YYYY-MM-DD` (New York).
title: Date
description: One session, `YYYY-MM-DD` (New York).
- name: from
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Start: `YYYY-MM-DD` or an RFC 3339 time.'
title: From
description: 'Start: `YYYY-MM-DD` or an RFC 3339 time.'
- name: to
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'End: `YYYY-MM-DD` or an RFC 3339 time. Default now.'
title: To
description: 'End: `YYYY-MM-DD` or an RFC 3339 time. Default now.'
- name: expiry
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: One expiry, `YYYY-MM-DD`.
title: Expiry
description: One expiry, `YYYY-MM-DD`.
- name: limit
in: query
required: false
schema:
type: integer
maximum: 1000
minimum: 1
description: Rows per page, up to 1000.
default: 100
title: Limit
description: Rows per page, up to 1000.
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: '`next_cursor` from the previous page.'
title: Cursor
description: '`next_cursor` from the previous page.'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid or missing request parameters
servers:
- url: /api/public/v1
/options/unusual:
get:
tags:
- Options flow
summary: Unusual contracts
operationId: unusual_options_unusual_get
parameters:
- name: symbol
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Underlyings, comma separated (e.g. `NVDA,AMD`). Default all.
title: Symbol
description: Underlyings, comma separated (e.g. `NVDA,AMD`). Default all.
- name: date
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: One session, `YYYY-MM-DD` (New York).
title: Date
description: One session, `YYYY-MM-DD` (New York).
- name: type
in: query
required: false
schema:
anyOf:
- enum:
- call
- put
type: string
- type: 'null'
title: Type
- name: min_premium
in: query
required: false
schema:
type: integer
minimum: 0
description: Minimum premium in the contract's prints, USD.
default: 100000
title: Min Premium
description: Minimum premium in the contract's prints, USD.
- name: sort
in: query
required: false
schema:
enum:
- premium
- volume_to_open_interest
type: string
default: premium
title: Sort
- name: limit
in: query
required: false
schema:
type: integer
maximum: 1000
minimum: 1
description: Rows per page, up to 1000.
default: 100
title: Limit
description: Rows per page, up to 1000.
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: '`next_cursor` from the previous page.'
title: Cursor
description: '`next_cursor` from the previous page.'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid or missing request parameters
servers:
- url: /api/public/v1
/options/flow/{id}:
get:
tags:
- Options flow
summary: One print
operationId: print__options_flow__id__get
parameters:
- name: id
in: path
required: true
schema:
type: integer
maximum: 18446744073709551615
minimum: 1
description: A print's `id`.
title: Id
description: A print's `id`.
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Invalid or missing request parameters
servers:
- url: /api/public/v1
components:
securitySchemes:
apiKey:
type: apiKey
in: query
name: apiKey
x-refined-from:
- tradytics-openapi.json
- tradytics-openapi.json
x-provenance:
method: harvested
publisher: Tradytics
source: https://tradytics.com/api/public/v1/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)