oasbycir

Решите, что опция настроила распространение с помощью модели Кокса-Инджерсолла-Росса

Синтаксис

[OAS,OAD,OAC] = oasbycir(CIRTree,Price,CouponRate,Settle,Maturity,OptSpec,Strike,ExerciseDates)
[OAS,OAD,OAC] = oasbycir(___,Name,Value)

Описание

пример

[OAS,OAD,OAC] = oasbycir(CIRTree,Price,CouponRate,Settle,Maturity,OptSpec,Strike,ExerciseDates) вычисляет опция настроила распространение от Кокса-Инджерсолла-Росса (CIR) дерево процентной ставки. oasbycir вычисляет цену настроенного распространения опции для связей со встроенными опциями с помощью модели CIR ++ с подходом Навалька-Беляевой (NB).

пример

[OAS,OAD,OAC] = oasbycir(___,Name,Value) добавляют дополнительные аргументы пары "имя-значение".

Примеры

свернуть все

Создайте RateSpec с помощью функции intenvset.

ValuationDate = 'October-25-2018';
Rates = [0.0355; 0.0382; 0.0427; 0.0489];
StartDates = ValuationDate;
EndDates = datemnth(ValuationDate, 12:12:48)';
Compounding = 1;

RateSpec = intenvset('ValuationDate', ValuationDate, 'StartDates', ValuationDate, 'EndDates',EndDates,'Rates', Rates, 'Compounding', Compounding); 

Создайте дерево CIR.

NumPeriods = length(EndDates); 
Alpha = 0.03; 
Theta = 0.02;  
Sigma = 0.1;    
Maturity = '01-Jan-2023'; 
CIRTimeSpec = cirtimespec(ValuationDate, Maturity, NumPeriods); 
CIRVolSpec = cirvolspec(Sigma, Alpha, Theta); 

CIRT = cirtree(CIRVolSpec, RateSpec, CIRTimeSpec)
CIRT = struct with fields:
      FinObj: 'CIRFwdTree'
     VolSpec: [1x1 struct]
    TimeSpec: [1x1 struct]
    RateSpec: [1x1 struct]
        tObs: [0 1.0462 2.0924 3.1386]
        dObs: [737358 737740 738122 738504]
     FwdTree: {[1.0373]  [1.0750 1.0443 1.0229]  [1x5 double]  [1x7 double]}
     Connect: {[3x1 double]  [3x3 double]  [3x5 double]}
       Probs: {[3x1 double]  [3x3 double]  [3x5 double]}

Задайте инструмент OAS.

CouponRate = 0.045;
Settle = ValuationDate;
Maturity = '25-October-2019';
OptSpec = 'call';
Strike = 100;
ExerciseDates = {'25-October-2018','25-October-2019'};
Period = 1;
AmericanOpt = 0;
Price = 97;

Вычислите OAS.

[OAS,OAD] = oasbycir(CIRT,Price,CouponRate,Settle,Maturity,OptSpec,Strike,ExerciseDates,'Period',Period,'AmericanOpt',AmericanOpt)
OAS = 416.9457
OAD = 0.9282

Входные параметры

свернуть все

Древовидная структура процентной ставки, заданная при помощи cirtree.

Типы данных: struct

Рыночные цены связей со встроенными опциями, заданными как NINST-by-1 вектор.

Типы данных: double

Уровень облигационного купона, заданный как NINST-by-1 десятичный годовой показатель.

Типы данных: double

Расчетный день для опции связи, заданной как NINST-by-1 вектор последовательных чисел даты, векторов символов даты, строковых массивов или массивов datetime.

Примечание

Дата Settle каждой связи со встроенной опцией назначена к ValuationDate дерева CIR. Аргумент Settle связи проигнорирован.

Типы данных: double | char | string | datetime

Дата погашения, заданная как NINST-by-1 вектор последовательных чисел даты, векторов символов даты, строковых массивов или массивов datetime.

Типы данных: double | char | string | datetime

Определение опции, заданной как NINST-by-1 массив ячеек из символьных векторов или строковые массивы со значениями 'call' или 'put'.

Типы данных: char | cell | string

Значение цены исполнения опциона опции, заданное как NINST-by-1 или NINST-by-NSTRIKES в зависимости от типа опции:

  • Европейская опция — NINST-by-1 вектор значений цены исполнения опциона.

  • Опция Бермуд — NINST количеством забастовок (NSTRIKES) матрица значений цены исполнения опциона. Каждая строка является расписанием для одной опции. Если опция имеет меньше, чем возможности осуществления NSTRIKES, конец строки дополнен NaN s.

  • Американская опция — NINST-by-1 вектор значений цены исполнения опциона для каждой опции.

Типы данных: double

Даты осуществления опции, заданные как NINST-by-1, NINST-by-2 или NINST-by-NSTRIKES последовательные числа даты, векторы символов даты, строковые массивы или массивы datetime в зависимости от типа опции:

  • Для европейской опции используйте NINST-by-1 вектор дат. Для европейской опции на дате окончания срока действия опции существует только один ExerciseDates.

  • Для опции Бермуд используйте NINST-by-NSTRIKES вектор дат.

  • Для американской опции используйте NINST-by-2 вектор контуров даты осуществления. Опция может быть осуществлена в любую дату между или включая пару дат на той строке. Если только одна non-NaN дата перечислена, или если ExerciseDates является NINST-by-1 вектор, опция может быть осуществлена между ValuationDate дерева запаса и одним перечисленным ExerciseDates.

.

Типы данных: double | char | string | datetime

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: OAS = oasbycir(CIRTree,Price,CouponRate,Settle,Maturity,OptSpec,Strike,ExerciseDates,'Period',4)

Тип опции, заданный как пара, разделенная запятой, состоящая из 'AmericanOpt' и NINST-by-1 положительное целое число, отмечает с помощью значений:

  • 0 — Европеец/Бермуды

  • 1 — Американец

Типы данных: double

Купоны в год, заданный как пара, разделенная запятой, состоящая из 'Period' и NINST-by-1 вектор.

Типы данных: double

Основание дневного количества, заданное как пара, разделенная запятой, состоящая из 'Basis' и NINST-by-1 вектор целых чисел.

  •  0 = фактический/фактический

  •  1 = 30/360 (СИА)

  •  2 = Фактический/360

  •  3 = Фактический/365

  •  4 = 30/360 (PSA)

  •  5 = 30/360 (ISDA)

  •  6 = 30/360 (европеец)

  •  7 = Фактический/365 (японский язык)

  •  8 = фактический/фактический (ICMA)

  •  9 = Фактический/360 (ICMA)

  •  10 = Фактический/365 (ICMA)

  •  11 = 30/360E (ICMA)

  •  12 = Фактический/365 (ISDA)

  •  13 = ШИНА/252

Для получения дополнительной информации смотрите основание.

Типы данных: double

Флаг правила конца месяца, заданный как пара, разделенная запятой, состоящая из 'EndMonthRule' и неотрицательного целого числа с помощью NINST-by-1 вектор. Это правило применяется только, когда Maturity является датой конца месяца в течение месяца, имея 30 или меньше дней.

  • 0 = Игнорирует правило, означая, что платежный день облигационного купона всегда является тем же числовым днем месяца.

  • 1 = Установленное правило о, означая, что платежный день облигационного купона всегда является прошлым фактическим днем месяца.

Типы данных: double

Дата выпуска облигаций, заданная как пара, разделенная запятой, состоящая из 'IssueDate' и NINST-by-1 вектор с помощью последовательных чисел даты, векторов символов даты, строковых массивов или массивов datetime.

Типы данных: double | char | string | datetime

Неправильная первая дата купона, заданная как пара, разделенная запятой, состоящая из 'FirstCouponDate' и NINST-by-1 вектор с помощью последовательной даты чисел даты, векторов символов даты, строковых массивов или массивов datetime.

Когда FirstCouponDate и LastCouponDate оба заданы, FirstCouponDate более приоритетен в определении структуры купонного платежа. Если вы не задаете FirstCouponDate, платежные дни потока наличности определяются от других входных параметров.

Типы данных: double | char | string | datetime

Неправильная последняя дата купона, заданная как пара, разделенная запятой, состоящая из 'LastCouponDate' и NINST-by-1 вектор с помощью последовательных чисел даты, векторов символов даты, строковых массивов или массивов datetime.

В отсутствие заданного FirstCouponDate заданный LastCouponDate определяет структуру купона связи. Структура купона связи является усеченной в LastCouponDate, независимо от того, где это падает и сопровождается только датой потока наличности зрелости связи. Если вы не задаете LastCouponDate, платежные дни потока наличности определяются от других входных параметров.

Типы данных: char | double | string | datetime

Передайте срок начала работы платежей (дата, с которой поток наличности связи рассматривается), заданный как пара, разделенная запятой, состоящая из 'StartDate' и NINST-by-1 вектор с помощью последовательных чисел даты, векторов символов даты, строковых массивов или массива datetime.

Если вы не задаете StartDate, эффективная дата начала является датой Settle.

Типы данных: char | double | string | datetime

Поверхность или номинальная стоимость, заданная как пара, разделенная запятой, состоящая из 'Face' и NINST-by-1 вектор.

Типы данных: double

Выходные аргументы

свернуть все

Опция настроила распространение, возвращенное как NINST-by-1 вектор.

Опция настроила длительность, возвращенную как NINST-by-1 вектор.

Опция настроила выпуклость, возвращенную как NINST-by-1 вектор.

Больше о

свернуть все

Связь со встроенными опциями

bond with embedded option позволяет выпускающему выкупать (вызываемый) или искупать (с правом досрочного погашения) связь по предопределенной цене в заданные будущие даты.

Программное обеспечение Financial Instruments Toolbox™ поддерживает американца, европейца и Бермуды вызываемые и связи с правом досрочного погашения. Оценка для связи со встроенными опциями следующие:

  • Вызываемая связь — держатель купил облигацию и продал колл-опцион выпускающему. Например, если процентные ставки понижаются ко времени даты погашения, выпускающий может рефинансировать ее долг на более дешевом уровне и может вызвать связь. Цена вызываемой связи:

    Price callable bond = Price Option free bondPrice call option

  • Связь с правом досрочного погашения — держатель купил облигацию и пут-опцион. Например, если процентные ставки повышаются, будущее значение купонных платежей становится менее ценным. Поэтому инвестор может продать связь назад выпускающему и затем предоставить доходы в другом месте на более высоком уровне. Цена связи с правом досрочного погашения:

    Price puttable bond = Price Option free bond + Price put option

Ссылки

[1] Cox, J., Ингерсолл, J. и С. Росс. "Теория термина структура процентных ставок". Econometrica. Издание 53, 1985.

[2] Brigo, D. и Ф. Меркурио. Модели процентной ставки - теория и практика. Финансы Спрингера, 2006.

[3] Hirsa, A. Вычислительные методы в финансах. Нажатие CRC, 2012.

[4] Nawalka, S., Soto, G. и Н. Беляева. Динамическое моделирование структуры термина. Вайли, 2007.

[5] Нельсон, D. и К. Рамасвами. "Простые Биномиальные Процессы как Приближения Диффузии в Финансовых Моделях". Анализ Финансовых Исследований. Vol 3. 1990, стр 393–430.

Введенный в R2018a

Для просмотра документации необходимо авторизоваться на сайте