Skip to content
OptionsOptions FlowEvery options print, from OPRA, Cboe and Cboe GTH.Unusual PrintsSweeps, blocks and opening size, flagged as they hit.ScreenerServer-side filters over every contract and ticker.Exposure (GEX / DEX / VEX / CEX)Modeled dealer positioning by strike and expiry.Key LevelsRanked walls, gamma flip, max pain, expected move.Overnight GEXGTHSPX exposure from live Cboe GTH flow.
FuturesOrder Flow / FootprintBid × ask at every price, with imbalances.Depth MapResting liquidity as a live heatmap.Volume ProfileFull-session profile, POC and value area.DOM / LadderBook, executed volume and delta per price.GEX levels on ES/NQ charts
StocksEquity PrintsLarge prints with venue, size and conditions.Dark Pool LevelsPrices ranked by off-exchange notional.Dark FlowOff-exchange notional through the session.Charts and NewsCandles, live quotes and headlines in one place.
PlatformDashboards / Workspace43 widgets on a saved snap grid.AlertsPrice, Greek and unusual-print rules.ReplayPlay back a session at any speed.
workspace preview · 16:9
Solutions

Pick how you trade. Each page shows the widgets that matter and the one plan that covers them.

GEX and dealer positioningWalls, flip and exposure by strikeOptions planOptions flow tradersTape, sweeps, unusual printsOptions planOrder flow and scalpersFootprint, DOM, depth mapFutures planVolume profile and auction marketPOC, value area, session profileFutures planDevelopers and quantsREST, WebSocket and MCPDeveloper API
DocsQuick start, guides and the full API reference.BlogSession reviews and product notes.Trades spottedSetups the post-session scan flagged, after the close.PartnersThe affiliate program and partner codes.

Stocks · Reference and fundamentals

Stocks dividends

Cash dividends, newest first.
GET/v1/stocks/dividendsstocksDividends
API DeveloperPaginatedDataset: equities
On this page

Historical and declared cash dividends with declaration, ex-dividend, record and pay dates, amount per share, payment frequency per year (1 annual, 4 quarterly, 12 monthly, 0 one-time) and kind.

Example request

curl -sS --get "https://api.ordermap.si/v1/stocks/dividends" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode symbol=AAPL

Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.

Parameters

5 parameters, none required.

ParameterType and limitsDescription
symbolqueryoptionalstringat most 11 characterspattern ^[A-Za-z]{1,6}(\.[A-Za-z0-9]{1,4})?$Only this ticker symbol.
start_datequeryoptionalstringdateInclusive earliest ex-dividend date, YYYY-MM-DD.
end_datequeryoptionalstringdateInclusive latest ex-dividend date, YYYY-MM-DD.
limitqueryoptionalintegerdefault 100min 1max 999Maximum rows to return.
cursor_idqueryoptionalstringat most 1024 charactersOpaque cursor returned as pagination.next_cursor_id; resumes the same query on the next page.

Response

StatusMeaningBody
200Successful response.Schema below
400Invalid, unknown or repeated parameters, or an invalid cursor.Error object
401Missing or invalid API key.Error object
403The plan, dataset release or account state does not allow this request.Error object
422The request is valid but no data exists for it.Error object
429Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-AfterError object
500Internal error.Error object
503Data temporarily unavailable; retry after Retry-After seconds.Retry-AfterError object
504The request timed out.Error object

Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.

200 response body

  • dataarray<object>required10 fields inside
    • cash_amountnumberrequiredCash per share.
    • currencystring | nullrequiredCurrency, ISO 4217.
    • declaration_datestring | nulldaterequiredDate the dividend was announced.
    • dividend_typestringrequiredKind of distribution.regularspeciallong_term_capital_gainshort_term_capital_gainunknown
    • ex_dividend_datestringdaterequiredFirst date the stock trades without the dividend.
    • frequencyinteger | nullrequiredPayments per year; 0 for a one-time dividend.
    • idstringrequiredDividend id.
    • pay_datestring | nulldaterequiredDate the dividend is paid.
    • record_datestring | nulldaterequiredDate a holder must be on record.
    • symbolstringrequiredTicker symbol.
  • metaobjectrequiredMeta object
  • paginationobjectrequiredPagination object

Example response

{
  "data": [
    {
      "cash_amount": 0.26,
      "currency": "USD",
      "declaration_date": "2026-08-01",
      "dividend_type": "regular",
      "ex_dividend_date": "2026-08-11",
      "frequency": 4,
      "id": "E8e3c4298e3c3f3e1ab9c3c3d3b8c0d2",
      "pay_date": "2026-08-14",
      "record_date": "2026-08-11",
      "symbol": "AAPL"
    }
  ],
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "sip"
  },
  "pagination": {
    "count": 1,
    "has_more": false,
    "limit": 100,
    "next_cursor_id": null,
    "next_url": null
  }
}

Values are illustrative. Missing values are null, never 0.

Related