# dividend_ttm

Dividends per share paid over the trailing 12 months, specials included. Null when nothing went ex-dividend in that window.

A numeric signal column on the Tickerbot computed state table (21,122+ ticker rows) — computed by the platform, queryable by bare name across the API. Values are NULL on rows the signal doesn't apply to.

- Group: Events
- Category: Dividends
- Type: numeric
- Unit: USD
- Update cadence: post-close daily
- Intervals: 1d
- Universe: all tickers
- History: partial — incomplete depth · since 2003
- Nullable: yes

## Query it

Every applicable form factor, grouped by endpoint family. Response payloads are real captures, sampled 2026-09-18 and trimmed; your run's values and dates will differ.

### The whole market, filtered on it — `/v2/scan` (https://tickerbot.io/docs/endpoints/scan.md)

#### Live — the whole market, ranked by this column

```bash
curl -X POST "https://api.tickerbot.io/v2/scan" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{ "q": "dividend_ttm IS NOT NULL", "order": "dividend_ttm", "columns": "dividend_ttm" }'
```

#### As-of — the same scan at a past date

```bash
curl -X POST "https://api.tickerbot.io/v2/scan" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{ "q": "dividend_ttm IS NOT NULL", "order": "dividend_ttm", "columns": "dividend_ttm", "asof": "2026-07-01" }'
```

### Its history — `/v2/series` (https://tickerbot.io/docs/endpoints/series.md)

#### History — the column on an aligned time grid

```bash
curl "https://api.tickerbot.io/v2/series?tickers=AAPL,MSFT&columns=close,dividend_ttm" \
  -H "Authorization: Bearer YOUR_KEY"
```

## Related signals (Dividends)

- [dividend](https://tickerbot.io/docs/signals/dividend.md)
- [dividend_approaching](https://tickerbot.io/docs/signals/dividend_approaching.md)
- [dividend_date](https://tickerbot.io/docs/signals/dividend_date.md)
- [dividend_frequency](https://tickerbot.io/docs/signals/dividend_frequency.md)
- [dividend_payout_ratio](https://tickerbot.io/docs/signals/dividend_payout_ratio.md)

---

Full catalog: https://tickerbot.io/docs/signals/catalog.md · Schema: https://tickerbot.io/docs/schema.md · HTML: https://tickerbot.io/docs/signals/dividend_ttm/