QuantLib Credit

Overview

QuantLib Credit

Function List

qlBaseCorrelationTermStructure ()
qlBaseCorrelationValue ()
qlBlackCdsOptionEngine ()
qlCDSOption ()
qlCdsCouponLegNPV ()
qlCdsDefaultLegNPV ()
qlCdsFairSpread ()
qlCdsFairUpfront ()
qlCdsOptionImpliedVol ()
qlCreditDefaultSwap ()
qlDefaultEvent ()
qlHRDates ()
qlHRates ()
qlHazardRateCurve ()
qlIntegralNtdEngine ()
qlIssuer ()
qlMidPointCDOEngine ()
qlMidPointCdsEngine ()
qlNthToDefault ()
qlPiecewiseFlatForwardCurve ()
qlPiecewiseHazardRateCurve ()
qlRiskyFixedBond ()
qlSpreadCdsHelper ()
qlSyntheticCDO ()
qlUpfrontCdsHelper ()

Function Documentation

qlBaseCorrelationTermStructure

string returnValue
qlBaseCorrelationTermStructure(
string ObjectId
string InterpolatorType
long SettlementDays
string Calendar
string Convention
vector<string> Tenors
vector<double> LossLevel
vector<vector<string> > Correlations
string DayCounter
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class BaseCorrelationTermStructure and return its id

Supported Platforms:

Excel, C++

Parameters
ObjectIdid of object to be created
InterpolatorTypeThe bidimensional interpolation policy over the correlation surface.
SettlementDaysNumber of settlement days.
CalendarCalendar.
ConventionTime convention.
TenorsSurface tenors
LossLevelSurface loss levels as a fraction of the underlying portfolio.
CorrelationsCorrelation quotes.
DayCounterDayCounter ID. Default value = Actual/365 (Fixed).
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlBaseCorrelationValue

double returnValue
qlBaseCorrelationValue(
string ObjectId
long Date
double LossLevel
any Trigger)
Description:

Returns the interpolated base correlation value.

Supported Platforms:

Excel

Parameters
ObjectIdid of existing QuantLibAddin::BaseCorrelationTermStructure object
DateInterpolation date.
LossLevelInterpolation loss level.
Triggerdependency tracking trigger

qlBlackCdsOptionEngine

string returnValue
qlBlackCdsOptionEngine(
string ObjectId
string DefaultCurve
double RecoveryRate
string YieldCurve
string BlackVol
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class BlackCdsOptionEngine and return its id

Supported Platforms:

Excel, Calc, C++

Parameters
ObjectIdid of object to be created
DefaultCurvedefault term structure object ID.
RecoveryRateconstant recovery rate
YieldCurvediscounting yield term structure object ID.
BlackVolBlack Volatility.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlCDSOption

string returnValue
qlCDSOption(
string ObjectId
string UnderlyingCDS
string Exercise
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class CdsOption and return its id

Supported Platforms:

Excel, Calc

Parameters
ObjectIdid of object to be created
UnderlyingCDSThe CDS underlying the option.
ExerciseExercise object ID.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlCdsCouponLegNPV

double returnValue
qlCdsCouponLegNPV(
string ObjectId
any Trigger)
Description:

Returns the CL NPV.

Supported Platforms:

Excel

Parameters
ObjectIdid of existing QuantLib::CreditDefaultSwap object
Triggerdependency tracking trigger

qlCdsDefaultLegNPV

double returnValue
qlCdsDefaultLegNPV(
string ObjectId
any Trigger)
Description:

Returns the DL NPV.

Supported Platforms:

Excel

Parameters
ObjectIdid of existing QuantLib::CreditDefaultSwap object
Triggerdependency tracking trigger

qlCdsFairSpread

double returnValue
qlCdsFairSpread(
string ObjectId
any Trigger)
Description:

Returns the running spread that, given the quoted recovery rate, will make the running-only CDS have an NPV of 0.

Supported Platforms:

Excel

Parameters
ObjectIdid of existing QuantLib::CreditDefaultSwap object
Triggerdependency tracking trigger

qlCdsFairUpfront

double returnValue
qlCdsFairUpfront(
string ObjectId
any Trigger)
Description:

Returns the upfront spread that, given the running spread and the quoted recovery rate, will make the instrument have an NPV of 0.

Supported Platforms:

Excel

Parameters
ObjectIdid of existing QuantLib::CreditDefaultSwap object
Triggerdependency tracking trigger

qlCdsOptionImpliedVol

double returnValue
qlCdsOptionImpliedVol(
string ObjectId
double Price
string YieldCurve
string DefaultCurve
double RecoveryRate
any Trigger)
Description:

Implied black CDS option volatility.

Supported Platforms:

Excel

Parameters
ObjectIdid of existing QuantLib::CdsOption object
PriceMarket price.
YieldCurvediscounting yield term structure object ID.
DefaultCurvedefault term structure object ID.
RecoveryRateconstant recovery rate
Triggerdependency tracking trigger

qlCreditDefaultSwap

string returnValue
qlCreditDefaultSwap(
string ObjectId
string BuyerSeller
double Notional
double Upfront
double Spread
string PremiumSchedule
string PaymentConvention
string DayCounter
bool SettlesAccrual
bool PayAtDefault
long ProtectionStart
long UpfrontDate
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class CreditDefaultSwap and return its id

Supported Platforms:

Excel, Calc

Parameters
ObjectIdid of object to be created
BuyerSellerBUYER for bought, SELLER for sold protection. Default value = Buyer.
NotionalNominal amount
Upfrontupfront in fractional units
Spreadrunning spread in fractional units
PremiumSchedulepremium leg Schedule object ID.
PaymentConventionPayment dates' business day convention. Default value = Following.
DayCounterpremium leg day counter (e.g. Actual/360).
SettlesAccrualTRUE ensures settlement of accural. Default value = true.
PayAtDefaultTRUE ensures payment at default time Default value = true.
ProtectionStartprotection start date. Default value = QuantLib::Date().
UpfrontDateupfront date. Default value = QuantLib::Date().
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlDefaultEvent

string returnValue
qlDefaultEvent(
string ObjectId
string EventType
long EventDate
string Currency
string Seniority
long SettlementDate
double SettledRecovery
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class DefaultEventSet and return its id

Supported Platforms:

Excel, C++

Parameters
ObjectIdid of object to be created
EventTypeThe type of default event. Default value = NONE.
EventDateEvent date. Default value = QuantLib::Date().
CurrencyCurency of the reference bond affected. Default value = Currency.
SenioritySeniority of the bond affected. Default value = NoSeniority.
SettlementDateEvent settlement date. Default value = QuantLib::Date().
SettledRecoveryEvent settlement recovery rate. Default value = 0.0.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlHRDates

vector<long> returnValue
qlHRDates(
string ObjectId
any Trigger)
Description:

Dates on which the hazard rate interpolation is performed.

Supported Platforms:

Excel

Parameters
ObjectIdid of existing QuantLibAddin::PiecewiseHazardRateCurve object
Triggerdependency tracking trigger

qlHRates

vector<double> returnValue
qlHRates(
string ObjectId
any Trigger)
Description:

Dates on which the hazard rate interpolation is performed.

Supported Platforms:

Excel

Parameters
ObjectIdid of existing QuantLibAddin::PiecewiseHazardRateCurve object
Triggerdependency tracking trigger

qlHazardRateCurve

string returnValue
qlHazardRateCurve(
string ObjectId
vector<long> CurveDates
vector<double> CurveRates
string DayCounter
bool Permanent
any Trigger
bool Overwrite)
Description:

Creates a backward flat interpolated hazard rate curve.

Supported Platforms:

Excel, Calc, C++

Parameters
ObjectIdid of object to be created
CurveDatesdates of the curve. First date corresponds to a survival probability of one.
CurveRateshazard rates for the above dates.
DayCounterDayCounter ID. Default value = Actual/365 (Fixed).
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlIntegralNtdEngine

string returnValue
qlIntegralNtdEngine(
string ObjectId
string IntegrationStep
string YieldCurve
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class IntegralNtdEngine and return its id

Supported Platforms:

Excel, C++

Parameters
ObjectIdid of object to be created
IntegrationStepIntegration step period.
YieldCurvediscounting yield term structure object ID.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlIssuer

string returnValue
qlIssuer(
string ObjectId
string DefaultCurves
string DefaultEvents
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class Issuer and return its id

Supported Platforms:

Excel, C++

Parameters
ObjectIdid of object to be created
DefaultCurvesDefault probability curve. By now it is associated to SeniorSec, EUR and NorthAmericaCorpDefaultKey Default value = .
DefaultEventsCredit events affecting this issuer.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlMidPointCDOEngine

string returnValue
qlMidPointCDOEngine(
string ObjectId
string YieldCurve
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class MidPointCDOEngine and return its id

Supported Platforms:

Excel, C++

Parameters
ObjectIdid of object to be created
YieldCurvediscounting yield term structure object ID.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlMidPointCdsEngine

string returnValue
qlMidPointCdsEngine(
string ObjectId
string DefaultCurve
double RecoveryRate
string YieldCurve
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class MidPointCdsEngine and return its id

Supported Platforms:

Excel, Calc, C++

Parameters
ObjectIdid of object to be created
DefaultCurvedefault term structure object ID.
RecoveryRateconstant recovery rate
YieldCurvediscounting yield term structure object ID.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlNthToDefault

string returnValue
qlNthToDefault(
string ObjectId
string Basket
long Order
string BuyerSeller
string PremiumSchedule
double Upfront
double Spread
string DayCounter
double Notional
bool SettlesAccrual
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class NthToDefault and return its id

Supported Platforms:

Excel, C++

Parameters
ObjectIdid of object to be created
BasketUnderlying tranched portfolio.
OrderContract default order.
BuyerSellerBUYER for bought, SELLER for sold protection. Default value = Buyer.
PremiumSchedulepremium leg Schedule object ID.
Upfrontupfront in fractional units
Spreadrunning spread in fractional units
DayCounterpremium leg day counter (e.g. Actual/360).
NotionalNominal amount
SettlesAccrualAccrual settled at default.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlPiecewiseFlatForwardCurve

string returnValue
qlPiecewiseFlatForwardCurve(
string ObjectId
long ReferenceDate
vector<string> RateHelpers
string DayCounter
double Accuracy
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class PiecewiseFlatForwardCurve and return its id

Supported Platforms:

Excel, Calc, C++

Parameters
ObjectIdid of object to be created
ReferenceDateterm structure reference date. Default value = QuantLib::Date().
RateHelpersvector of rate-helpers.
DayCounterDayCounter ID. Default value = Actual/365 (Fixed).
AccuracyBootstrapping accuracy. Default value = 1.0e-12.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlPiecewiseHazardRateCurve

string returnValue
qlPiecewiseHazardRateCurve(
string ObjectId
vector<string> Helpers
string DayCounter
string Calendar
string Interpolation
double Accuracy
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class PiecewiseHazardRateCurve and return its id

Supported Platforms:

Excel, Calc, C++

Parameters
ObjectIdid of object to be created
Helpersvector of default probability helpers.
DayCounterDayCounter ID. Default value = Actual/365 (Fixed).
Calendarholiday calendar (e.g. TARGET).
InterpolationThe interpolator for hazard rates.
AccuracyBootstrapping accuracy. Default value = 1.0e-12.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlRiskyFixedBond

string returnValue
qlRiskyFixedBond(
string ObjectId
string Bondname
string Currency
double Recovery
string DefaultCurve
string Schedule
double Rate
string DayCounter
string PaymentConvention
double Notional
string DiscountingCurve
long PricingDate
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class RiskyFixedBond and return its id

Supported Platforms:

Excel, Calc, C++

Parameters
ObjectIdid of object to be created
BondnameBonds id.
CurrencyCurency of the reference bond affected.
RecoveryRecovery Rate.
DefaultCurvedefault term structure object ID.
ScheduleSchedule.
RateRate.
DayCounterpremium leg day counter (e.g. Actual/360).
PaymentConventionPayment dates' business day convention. Default value = Following.
NotionalNotional.
DiscountingCurvediscounting YieldTermStructure object ID.
PricingDatedesired npv date.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlSpreadCdsHelper

string returnValue
qlSpreadCdsHelper(
string ObjectId
string RunningSpread
string Tenor
long SettlementDays
string Calendar
string Frequency
string PaymentConvention
string GenRule
string DayCounter
double RecoveryRate
string DiscountingCurve
bool SettleAccrual
bool PayAtDefault
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class SpreadCdsHelper and return its id

Supported Platforms:

Excel, Calc, C++

Parameters
ObjectIdid of object to be created
RunningSpreadquote.
TenorCDS length (e.g. 5Y for five years).
SettlementDayssettlement days Default value = 0.
Calendarholiday calendar (e.g. TARGET).
Frequencypayment frequency (e.g. Annual, Semiannual, Every4Month, Quarterly, Bimonthly, Monthly).
PaymentConventionpayment leg convention (e.g. Unadjusted).
GenRuleDate generation rule (Backward, Forward, ThirdWednesday, Twentieth, TwentiethIMM, Zero).
DayCounterday counter (e.g. Actual/360).
RecoveryRaterecovery rate
DiscountingCurvediscounting YieldTermStructure object ID.
SettleAccrualTRUE ensures settlement of accural. Default value = true.
PayAtDefaultTRUE ensures payment at default time Default value = true.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlSyntheticCDO

string returnValue
qlSyntheticCDO(
string ObjectId
string Basket
string BuyerSeller
string PremiumSchedule
double Upfront
double Spread
string DayCounter
string PaymentConvention
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class SyntheticCDO and return its id

Supported Platforms:

Excel, C++

Parameters
ObjectIdid of object to be created
BasketUnderlying tranched portfolio.
BuyerSellerBUYER for bought, SELLER for sold protection. Default value = Buyer.
PremiumSchedulepremium leg Schedule object ID.
Upfrontupfront in fractional units
Spreadrunning spread in fractional units
DayCounterpremium leg day counter (e.g. Actual/360).
PaymentConventionPayment dates' business day convention. Default value = Following.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag

qlUpfrontCdsHelper

string returnValue
qlUpfrontCdsHelper(
string ObjectId
string UpfrontSpread
double RunningSpread
string Tenor
long SettlementDays
string Calendar
string Frequency
string PaymentConvention
string GenRule
string DayCounter
double RecRate
string DiscCurve
long UpfSettlDays
bool SettlAccr
bool PayAtDefault
bool Permanent
any Trigger
bool Overwrite)
Description:

Construct an object of class UpfrontCdsHelper and return its id

Supported Platforms:

Excel, Calc

Parameters
ObjectIdid of object to be created
UpfrontSpreadupfront spread quote.
RunningSpreadrunning spread.
TenorCDS length (e.g. 5Y for five years).
SettlementDayssettlement days Default value = 0.
Calendarholiday calendar (e.g. TARGET).
Frequencypayment frequency (e.g. Annual, Semiannual, Every4Month, Quarterly, Bimonthly, Monthly).
PaymentConventionpayment leg convention (e.g. Unadjusted).
GenRuleDate generation rule (Backward, Forward, ThirdWednesday, Twentieth, TwentiethIMM, Zero).
DayCounterday counter (e.g. Actual/360).
RecRaterecovery rate
DiscCurvediscounting YieldTermStructure object ID.
UpfSettlDaysupfront settlement days
SettlAccrTRUE ensures settlement of accural. Default value = true.
PayAtDefaultTRUE ensures payment at default time Default value = true.
Permanentobject permanent/nonpermanent
Triggerdependency tracking trigger
Overwriteoverwrite flag