pub const SESSIONS_PER_YEAR: i64 = 252;
pub const SESSIONS_PER_QUARTER: i64 = 63;
pub const SESSIONS_PER_MONTH: i64 = 21;
pub const INDEX_FUTURE_EXPIRY_SESSION: i64 = 15;
pub const INDEX_FUTURES_LISTED: usize = 2;
pub const ROLL_SESSIONS: i64 = 6;
pub fn quarterly_expiry(quarter: i64) -> i64 {
quarter * SESSIONS_PER_QUARTER + 2 * SESSIONS_PER_MONTH + INDEX_FUTURE_EXPIRY_SESSION - 1
}
pub fn index_future_expiries(after: i64, count: usize) -> Vec<i64> {
let offset = quarterly_expiry(0);
let mut q = (after - offset).div_euclid(SESSIONS_PER_QUARTER);
while quarterly_expiry(q) <= after {
q += 1;
}
while q > 0 && quarterly_expiry(q - 1) > after {
q -= 1;
}
(0..count as i64).map(|k| quarterly_expiry(q + k)).collect()
}
pub const VIX_FUTURES_LISTED: usize = 6;
pub const VIX_FUTURES_WITH_DEPTH: usize = 3;
pub fn monthly_expiry(month: i64) -> i64 {
month * SESSIONS_PER_MONTH + INDEX_FUTURE_EXPIRY_SESSION - 1
}
pub fn vix_future_expiries(after: i64, count: usize) -> Vec<i64> {
let offset = monthly_expiry(0);
let mut m = (after - offset).div_euclid(SESSIONS_PER_MONTH);
while monthly_expiry(m) <= after {
m += 1;
}
while monthly_expiry(m - 1) > after {
m -= 1;
}
(0..count as i64).map(|k| monthly_expiry(m + k)).collect()
}
pub fn is_vix_future_expiry(session: i64) -> bool {
session.rem_euclid(SESSIONS_PER_MONTH) == monthly_expiry(0)
}
pub const POLICY_RATE_FUTURES_LISTED: usize = 13;
pub const OIL_FUTURES_LISTED: usize = 12;
pub const TERM_RATE_FUTURES_LISTED: usize = 8;
pub fn month_end(month: i64) -> i64 {
(month + 1) * SESSIONS_PER_MONTH - 1
}
pub fn quarter_end(quarter: i64) -> i64 {
(quarter + 1) * SESSIONS_PER_QUARTER - 1
}
pub fn period_ends(from: i64, length: i64, count: usize) -> Vec<i64> {
let first = from.div_euclid(length);
(0..count as i64).map(|k| (first + k + 1) * length - 1).collect()
}
pub fn roll_session(expiry: i64) -> i64 {
expiry - ROLL_SESSIONS
}
pub const INDEX_OPTION_MONTHLIES: usize = 6;
pub const INDEX_OPTION_EXPIRIES: usize = 8;
pub fn index_option_expiries(after: i64) -> Vec<i64> {
let mut out = vix_future_expiries(after, INDEX_OPTION_MONTHLIES);
let last = *out.last().expect("at least one monthly");
out.extend(index_future_expiries(last, INDEX_OPTION_EXPIRIES - INDEX_OPTION_MONTHLIES));
out
}
pub fn is_index_future_expiry(session: i64) -> bool {
session.rem_euclid(SESSIONS_PER_QUARTER) == quarterly_expiry(0)
}
pub const NAME_OPTION_MONTHLIES: usize = 3;
pub const NAME_OPTION_EXPIRIES: usize = 6;
pub fn name_option_expiries(from: i64) -> Vec<i64> {
let mut out = vix_future_expiries(from - 1, NAME_OPTION_MONTHLIES);
let last = *out.last().expect("at least one monthly");
out.extend(index_future_expiries(last, NAME_OPTION_EXPIRIES - NAME_OPTION_MONTHLIES));
out
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn expiries_fall_on_session_15_of_each_quarters_last_month() {
assert_eq!(quarterly_expiry(0), 56);
assert_eq!(quarterly_expiry(1), 119);
assert_eq!(quarterly_expiry(3), 245);
for q in 0..40 {
let e = quarterly_expiry(q);
let in_quarter = e - q * SESSIONS_PER_QUARTER;
assert_eq!(in_quarter / SESSIONS_PER_MONTH, 2);
assert_eq!(in_quarter % SESSIONS_PER_MONTH + 1, INDEX_FUTURE_EXPIRY_SESSION);
assert!(is_index_future_expiry(e));
assert!(!is_index_future_expiry(e + 1));
}
let all: Vec<i64> = (0..8).map(quarterly_expiry).collect();
for w in all.windows(2) {
assert_eq!(w[1] - w[0], SESSIONS_PER_QUARTER);
}
}
#[test]
fn the_front_two_are_the_next_two_expiries_strictly_after_a_session() {
assert_eq!(index_future_expiries(-1, 2), vec![56, 119]);
assert_eq!(index_future_expiries(0, 2), vec![56, 119]);
assert_eq!(index_future_expiries(55, 2), vec![56, 119]);
assert_eq!(index_future_expiries(56, 2), vec![119, 182]);
assert_eq!(index_future_expiries(118, 2), vec![119, 182]);
assert_eq!(index_future_expiries(-200, 1), vec![quarterly_expiry(-4)]);
assert_eq!(quarterly_expiry(-4), -196);
for t in -100..1000 {
let e = index_future_expiries(t, 2);
assert!(e[0] > t && e[0] - t <= SESSIONS_PER_QUARTER, "{t} {e:?}");
assert_eq!(e[1] - e[0], SESSIONS_PER_QUARTER);
assert!(is_index_future_expiry(e[0]));
}
assert_eq!(roll_session(56), 50);
}
#[test]
fn rate_futures_periods_end_on_each_months_and_quarters_last_session() {
assert_eq!(month_end(0), 20);
assert_eq!(quarter_end(0), 62);
assert_eq!(period_ends(0, SESSIONS_PER_MONTH, 2), vec![20, 41]);
assert_eq!(period_ends(20, SESSIONS_PER_MONTH, 1), vec![20]);
assert_eq!(period_ends(21, SESSIONS_PER_MONTH, 1), vec![41]);
assert_eq!(period_ends(62, SESSIONS_PER_QUARTER, 2), vec![62, 125]);
for t in 0..1000 {
let m = period_ends(t, SESSIONS_PER_MONTH, POLICY_RATE_FUTURES_LISTED);
assert!(m[0] >= t && m[0] - t < SESSIONS_PER_MONTH);
assert_eq!(m[12] - m[0], 12 * SESSIONS_PER_MONTH);
let q = period_ends(t, SESSIONS_PER_QUARTER, TERM_RATE_FUTURES_LISTED);
assert!(q[0] >= t && q[0] - t < SESSIONS_PER_QUARTER);
}
}
#[test]
fn index_options_list_six_monthlies_then_quarterlies_out_to_about_a_year() {
assert_eq!(index_option_expiries(-1), vec![14, 35, 56, 77, 98, 119, 182, 245]);
for t in -50..3000 {
let e = index_option_expiries(t);
assert_eq!(e.len(), INDEX_OPTION_EXPIRIES);
assert!(e[0] > t);
for w in e.windows(2) {
assert!(w[1] > w[0]);
}
for x in &e[..INDEX_OPTION_MONTHLIES] {
assert!(is_vix_future_expiry(*x));
}
for x in &e[INDEX_OPTION_MONTHLIES..] {
assert!(is_index_future_expiry(*x));
}
assert!(e[7] - t <= 252 + 21 && e[7] - t >= 189, "{t} {e:?}");
}
}
#[test]
fn name_options_list_three_monthlies_then_quarterlies_and_trade_on_their_expiry() {
assert_eq!(name_option_expiries(0), vec![14, 35, 56, 119, 182, 245]);
assert_eq!(name_option_expiries(14)[0], 14);
assert_eq!(name_option_expiries(15)[0], 35);
for t in -50..3000 {
let e = name_option_expiries(t);
assert_eq!(e.len(), NAME_OPTION_EXPIRIES);
assert!(e[0] >= t && e[0] - t < SESSIONS_PER_MONTH, "{t} {e:?}");
for w in e.windows(2) {
assert!(w[1] > w[0]);
}
for x in &e {
assert!(is_vix_future_expiry(*x));
}
for x in &e[NAME_OPTION_MONTHLIES..] {
assert!(is_index_future_expiry(*x));
}
assert!(e[5] - t >= 189 && e[5] - t <= 252, "{t} {e:?}");
}
}
#[test]
fn vix_futures_expire_monthly_on_session_15_and_the_next_six_are_listed() {
assert_eq!(monthly_expiry(0), 14);
assert_eq!(monthly_expiry(2), 56);
for m in 0..120 {
let e = monthly_expiry(m);
assert_eq!(e % SESSIONS_PER_MONTH + 1, INDEX_FUTURE_EXPIRY_SESSION);
assert!(is_vix_future_expiry(e) && !is_vix_future_expiry(e + 1));
}
for q in 0..40 {
assert!(is_vix_future_expiry(quarterly_expiry(q)));
}
assert_eq!(vix_future_expiries(-1, 2), vec![14, 35]);
assert_eq!(vix_future_expiries(13, 1), vec![14]);
assert_eq!(vix_future_expiries(14, 1), vec![35]);
for t in -100..2000 {
let e = vix_future_expiries(t, VIX_FUTURES_LISTED);
assert!(e[0] > t && e[0] - t <= SESSIONS_PER_MONTH, "{t} {e:?}");
assert!(e[VIX_FUTURES_LISTED - 1] - t <= 126, "{t} {e:?}");
for w in e.windows(2) {
assert_eq!(w[1] - w[0], SESSIONS_PER_MONTH);
}
}
}
}