|
IHS Markit API |
PUT v1/Bonds/{id}
Description
Update the bond with WSO ID of {id}.
Base Url
https://services.wsoweb.com/
Rest Call Syntax
PUT SecurityMaster/v1/Bonds/{id}
PUT SecurityMaster/v1/Bonds/{id}
Name
Description
Type
Additional Information
CouponType
The Coupon Type of the asset
When Coupon type is passed, the coupon rates will be recalculated (even if the value doesn't change). All manual changes will be lost.
CurrencyCode
The currency of the asset
string
Existing payments will need to be reviewed since the currency will be different than the cash currently existing on the bond.
FirstCouponDate
The first coupon date
date
When First coupon date is passed, the coupon schedule will be recalculated (even if the value doesn't change). All manual changes will be lost.
InterestAccrualDate
The first date that the asset starts accruing interest
date
When Interest accrual date is passed, the coupon schedule will be recalculated (even if the value doesn't change). All manual changes will be lost.
MaturityDate
The maturity date of the asset
date
When maturity date is passed, the coupon schedule will be recalculated (even if the value doesn't change). All manual changes will be lost.
AssetClassId
The class of the asset by ID value
integer
BondName
The name of the asset in WSO which typically includes the coupon rate and maturity date
string
Collateral
The description of the collateral that is backing the asset
string
ConvertibleType
The convertible type for the asset
string
CountryId
The legal country of the asset by ID value
integer
CouponDateOffset
Business Day Offset - this determines when a coupon should pay if the coupon date falls on a non-business day
CouponFrequency
The Coupon Frequency indicates how many times a year there is a coupon payment
DataFeedId
The source of the data feed by ID value
integer
DateOffset
Given the type of coupon - this is the number of days to offset the coupon rate
integer
DefaultDate
The date that the asset went into default
date
DefaultType
The type of default that has occurred
string
FirstSettleDate
The date that the bond asset first settled on
date
FixedRate
The fixed coupon rate
decimal number
GuarantorId
The guarantor for the asset by ID value
integer
HasAttachedWarrants
The flag indicating if the asset has attached warrants
boolean
HasDefaulted
The flag indicating if the asset has defaulted
boolean
HasFXRisk
The flag indicating if the asset has foreign exchange risk
boolean
HolidayCalendarId
The holiday calendar for the asset by ID value
integer
InsurerId
The insurer of the asset by ID value
integer
IsBaseRateObservationShiftEnabled
The flag indicating if the Bond asset has Observation Shift on RFR rate option
boolean
IsCallable
The flag indicating if the asset is callable
boolean
IsCollateralized
The flag indicating that the asset is collateralized
boolean
IsEmergingMarket
The flag indicating if the asset is in an emerging market
boolean
IsInterestOnly
The flag indicating if the asset is interest only
boolean
IsPIKBond
The flag indicating if the asset is a PIK Bond
boolean
IsPrincipalOnly
The flag indicating if the asset is principal only
boolean
IsPrivate
The flag indicating if the asset is a private security
boolean
IsPutable
The flag indicating if a Put Schedule can be added
boolean
IsRestructured
The flag indicating if the asset has been restructured
boolean
IsStructuredFinanceObligation
The flag indicating if the asset belongs to a structured finance obligation
boolean
IssueDate
The date that the asset was officially issued
date
IssuePrice
The price at which the asset was originally issued
decimal number
IssueSize
The global amount of the asset at issuance
decimal number
IsSynthetic
The flag indicating if this a synthetic security
boolean
IsTradedAccrued
The flag indicating if the asset trades with accrued interest
boolean
LeadUnderwriterId
The lead underwriter by ID value
integer
LockoutDays
The lockout days from 0 (zero) to 30
integer
MaturityDateExpected
The expected maturity date of the asset - optional field
date
Notes
The notes regarding the asset
string
PayNonBusinessDirection
Pay Offset - if the coupon falls on a non-business day this field determines when the coupon will pay
PayOffsetDays
Pay Offset - the number of days that coupon payment occurs differing from the coupon date
integer
PaysEndOfMonth
The flag indicating if this asset pays end of month when the first coupon date does not fall on the 31st
boolean
PIKCashPercentage
PIK - the cash percentage
decimal number
PIKPercentage
PIK - the PIK percentage
decimal number
RateOptionId
The rate option of the asset by ID value
integer
RegistrationType
The registration type
string
SeniorityId
The seniority level of the asset by ID value
integer
SpreadRate
The spread rate of the asset
decimal number
TransferAgentId
The transfer agent for the asset by ID value
integer
Limitations
-
CouponType cannot be updated.
-
Fixed Rate can only be updated on a Fixed Coupon Type.
-
Spread Rate can only be updated on a Float Coupon Type.
-
Rate Option cannot be updated for certain Coupon Types.
-
Frequency cannot be updated for certain Coupon Types.
-
Coupon Rate Schedule cannot be updated for certain Coupon Types.
Request Information
Parameters
Name
Description
Type
Additional Information
id
WSO ID of bond
integer
Required
Request body formats
application/json, text/json
{
"bondName": "sample string 1",
"assetClassId": 1,
"isCollateralized": true,
"collateral": "sample string 3",
"convertibleType": "sample string 4",
"countryId": 1,
"couponDateOffset": "None",
"couponFrequency": "Annual",
"currencyCode": "sample string 5",
"dataFeedId": 6,
"dateOffset": 1,
"dayCount": "ACT_ACT",
"defaultDate": "2024-11-23T01:19:21.8032254-06:00",
"defaultType": "sample string 7",
"fixedRate": 1.1,
"guarantorId": 1,
"hasAttachedWarrants": true,
"hasDefaulted": true,
"hasFXRisk": true,
"holidayCalendarId": 1,
"insurerId": 1,
"isCallable": true,
"isEmergingMarket": true,
"isInterestOnly": true,
"isPIKBond": true,
"isBaseRateObservationShiftEnabled": true,
"isPrincipalOnly": true,
"isPrivate": true,
"isPutable": true,
"isRestructured": true,
"isStructuredFinanceObligation": true,
"issueDate": "2024-11-23T01:19:21.8042341-06:00",
"issuePrice": 21.1,
"issueSize": 1.0,
"isSynthetic": true,
"isTradedAccrued": true,
"leadUnderwriterId": 1,
"lockoutDays": 24,
"maturityDate": "2024-11-23T01:19:21.8052304-06:00",
"maturityDateExpected": "2024-11-23T01:19:21.8052304-06:00",
"notes": "sample string 26",
"payNonBusinessDirection": "On",
"payOffsetDays": 27,
"payOffsetDirection": "After",
"payOffsetType": "BusinessDays",
"paysEndOfMonth": true,
"pikCashPercentage": 1.1,
"pikPercentage": 1.1,
"rateOptionId": 1,
"registrationType": "sample string 29",
"seniorityId": 1,
"spreadRate": 1.1,
"transferAgentId": 1,
"firstCouponDate": "2024-11-23T01:19:21.8062321-06:00",
"interestAccrualDate": "2024-11-23T01:19:21.8062321-06:00",
"couponType": "Fixed",
"firstSettleDate": "2024-11-23T01:19:21.8062321-06:00",
"baseRateCompoundMethod": "Unassigned",
"baseRateInterestMethod": "Unassigned"
}
application/xml, text/xml
<BondUpdate xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <AssetClassId>1</AssetClassId> <BaseRateCompoundMethod>Unassigned</BaseRateCompoundMethod> <BaseRateInterestMethod>Unassigned</BaseRateInterestMethod> <BondName>sample string 1</BondName> <Collateral>sample string 3</Collateral> <ConvertibleType>sample string 4</ConvertibleType> <CountryId>1</CountryId> <CouponDateOffset>None</CouponDateOffset> <CouponFrequency>Annual</CouponFrequency> <CouponType>Fixed</CouponType> <CurrencyCode>sample string 5</CurrencyCode> <DataFeedId>6</DataFeedId> <DateOffset>1</DateOffset> <DayCount>ACT_ACT</DayCount> <DefaultDate>2024-11-23T01:19:21.8032254-06:00</DefaultDate> <DefaultType>sample string 7</DefaultType> <FirstCouponDate>2024-11-23T01:19:21.8062321-06:00</FirstCouponDate> <FirstSettleDate>2024-11-23T01:19:21.8062321-06:00</FirstSettleDate> <FixedRate>1.1</FixedRate> <GuarantorId>1</GuarantorId> <HasAttachedWarrants>true</HasAttachedWarrants> <HasDefaulted>true</HasDefaulted> <HasFXRisk>true</HasFXRisk> <HolidayCalendarId>1</HolidayCalendarId> <InsurerId>1</InsurerId> <InterestAccrualDate>2024-11-23T01:19:21.8062321-06:00</InterestAccrualDate> <IsBaseRateObservationShiftEnabled>true</IsBaseRateObservationShiftEnabled> <IsCallable>true</IsCallable> <IsCollateralized>true</IsCollateralized> <IsEmergingMarket>true</IsEmergingMarket> <IsInterestOnly>true</IsInterestOnly> <IsPIKBond>true</IsPIKBond> <IsPrincipalOnly>true</IsPrincipalOnly> <IsPrivate>true</IsPrivate> <IsPutable>true</IsPutable> <IsRestructured>true</IsRestructured> <IsStructuredFinanceObligation>true</IsStructuredFinanceObligation> <IsSynthetic>true</IsSynthetic> <IsTradedAccrued>true</IsTradedAccrued> <IssueDate>2024-11-23T01:19:21.8042341-06:00</IssueDate> <IssuePrice>21.1</IssuePrice> <IssueSize>1</IssueSize> <LeadUnderwriterId>1</LeadUnderwriterId> <LockoutDays>24</LockoutDays> <MaturityDate>2024-11-23T01:19:21.8052304-06:00</MaturityDate> <MaturityDateExpected>2024-11-23T01:19:21.8052304-06:00</MaturityDateExpected> <Notes>sample string 26</Notes> <PIKCashPercentage>1.1</PIKCashPercentage> <PIKPercentage>1.1</PIKPercentage> <PayNonBusinessDirection>On</PayNonBusinessDirection> <PayOffsetDays>27</PayOffsetDays> <PayOffsetDirection>After</PayOffsetDirection> <PayOffsetType>BusinessDays</PayOffsetType> <PaysEndOfMonth>true</PaysEndOfMonth> <RateOptionId>1</RateOptionId> <RegistrationType>sample string 29</RegistrationType> <SeniorityId>1</SeniorityId> <SpreadRate>1.1</SpreadRate> <TransferAgentId>1</TransferAgentId> </BondUpdate>
application/x-www-form-urlencoded
Sample not available.
Response Information
Bond
Name
Description
Type
Additional Information
AssetClassId
The class of the asset by ID value
integer
BondName
The name of the asset in WSO which typically includes the coupon rate and maturity date
string
Collateral
The description of the collateral that is backing the asset
string
ConvertibleType
The entity into which the asset can be converted
string
CountryId
The legal country of this asset by ID value
integer
CouponDateOffset
Business Day Offset - this determines when a coupon should pay if the coupon date falls on a non-business day
CouponFrequency
The Coupon Frequency indicates how many times a year there is a coupon payment
CurrencyCode
The currency type of the asset
string
DateOffset
Given the type of coupon - this is the number of days to offset the coupon rate
integer
DefaultDate
The date that the asset went into default
date
DefaultType
The type of default that has occurred
string
FirstCouponDate
The first date that the asset has a coupon payment
date
FirstSettleDate
The first settle date listed for the asset
date
FixedRate
The fixed coupon rate
decimal number
GuarantorId
The guarantor for the asset by ID value
integer
HasAttachedWarrants
The flag indicating if the asset has attached warrants
boolean
HasDefaulted
The flag indicating if the asset has defaulted
boolean
HasFXRisk
The flag indicating if the asset has foreign exchange risk
boolean
HolidayCalendarId
The holiday calendar for the asset by ID value
integer
Id
The WSO ID for the asset
integer
InsurerId
The insurer of the asset by ID value
integer
InterestAccrualDate
The first date that the asset starts accruing interest
date
IsBaseRateObservationShiftEnabled
Gets or sets a flag indicating whether or not base rate observation shift is enabled for this Bond asset.
boolean
IsCallable
The flag indicating if the asset is callable
boolean
IsCollateralized
Determines if the bond is collateralized
boolean
IsDeleted
A flag indicating if the asset is soft-deleted in the system
boolean
IsEmergingMarket
The flag indicating if the asset is from an emerging market
boolean
IsInterestOnly
The flag indicating if this is an interest only asset
boolean
IsPIKBond
The flag indicating if the asset allows payments in kind (PIK)
boolean
IsPrincipalOnly
The flag indicating if this is a principal only asset
boolean
IsPrivate
The flag indicating if the asset is a private security
boolean
IsPutable
The flag to enable a Put Schedule
boolean
IsRestructured
The flag indicating if the security has been restructured since it was initially issued
boolean
IsStructuredFinanceObligation
The flag indicating if the asset belongs to a structured finance obligation
boolean
IssueDate
The date that the asset was officially issued
date
IssuePrice
The original price at which the asset was issued
decimal number
IssueSize
The global amount of the asset at issuance
decimal number
IsSynthetic
The flag indicating if this a synthetic security
boolean
IsTradedAccrued
The flag indicating if the asset trades with accrued interest
boolean
LockoutDays
integer
MaturityDate
The maturity date of the asset
date
MaturityDateExpected
The expected maturity date of the asset - optional field
date
Notes
The notes regarding the asset
string
PayNonBusinessDirection
Pay Offset - if the coupon falls on a non-business day this field determines when the coupon will pay
PayOffsetDays
Pay Offset - the number of days that coupon payment occurs differing from the coupon date
integer
PaysEndOfMonth
The flag indicating if this asset pays end of month when the first coupon date does not fall on the 31st
boolean
PIKCashPercentage
PIK - the cash percentage
decimal number
PIKPercentage
PIK - the PIK percentage
decimal number
RegistrationType
The registration type
string
SeniorityId
The seniority level of the asset by ID value
integer
SpreadRate
The spread rate of the asset
decimal number
Response Body Formats
application/json, text/json
{
"id": 1,
"bondName": "sample string 2",
"assetClassId": 1,
"isCollateralized": true,
"collateral": "sample string 4",
"convertibleType": "sample string 5",
"countryId": 1,
"currencyCode": "sample string 6",
"couponDateOffset": "None",
"couponFrequency": "Annual",
"couponType": "Fixed",
"dateOffset": 1,
"dayCount": "ACT_ACT",
"defaultDate": "2024-11-23T01:19:21.8650924-06:00",
"defaultType": "sample string 7",
"firstCouponDate": "2024-11-23T01:19:21.8650924-06:00",
"firstSettleDate": "2024-11-23T01:19:21.8650924-06:00",
"fixedRate": 1.1,
"guarantorId": 1,
"hasAttachedWarrants": true,
"hasDefaulted": true,
"hasFXRisk": true,
"holidayCalendarId": 1,
"insurerId": 1,
"interestAccrualDate": "2024-11-23T01:19:21.8660906-06:00",
"isCallable": true,
"isEmergingMarket": true,
"isInterestOnly": true,
"isPIKBond": true,
"isBaseRateObservationShiftEnabled": true,
"isPrincipalOnly": true,
"isPrivate": true,
"isPutable": true,
"isRestructured": true,
"isStructuredFinanceObligation": true,
"issueDate": "2024-11-23T01:19:21.8665727-06:00",
"issuePrice": 1.1,
"issueSize": 1.0,
"isSynthetic": true,
"isTradedAccrued": true,
"issuer": {
"verb": "sample string 1",
"rel": "sample string 2",
"uri": "http://webapihelppage3.com"
},
"maturityDate": "2024-11-23T01:19:21.8665727-06:00",
"maturityDateExpected": "2024-11-23T01:19:21.8665727-06:00",
"notes": "sample string 26",
"payNonBusinessDirection": "On",
"payOffsetDays": 27,
"payOffsetDirection": "After",
"payOffsetType": "BusinessDays",
"paysEndOfMonth": true,
"pikCashPercentage": 1.1,
"pikPercentage": 1.1,
"registrationType": "sample string 29",
"seniorityId": 1,
"spreadRate": 1.1,
"lockoutDays": 30,
"isDeleted": true,
"links": [
{
"verb": "sample string 1",
"rel": "sample string 2",
"uri": "http://webapihelppage3.com"
},
{
"verb": "sample string 1",
"rel": "sample string 2",
"uri": "http://webapihelppage3.com"
}
],
"couponRates": {
"verb": "sample string 1",
"rel": "sample string 2",
"uri": "http://webapihelppage3.com"
},
"callSchedule": {
"verb": "sample string 1",
"rel": "sample string 2",
"uri": "http://webapihelppage3.com"
},
"coupons": {
"verb": "sample string 1",
"rel": "sample string 2",
"uri": "http://webapihelppage3.com"
},
"identifiers": {
"verb": "sample string 1",
"rel": "sample string 2",
"uri": "http://webapihelppage3.com"
},
"ratings": {
"verb": "sample string 1",
"rel": "sample string 2",
"uri": "http://webapihelppage3.com"
},
"udfs": {
"verb": "sample string 1",
"rel": "sample string 2",
"uri": "http://webapihelppage3.com"
},
"baseRateInterestMethod": "Unassigned",
"baseRateCompoundMethod": "Unassigned"
}
application/xml, text/xml
<Bond xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<AssetClassId>1</AssetClassId>
<BaseRateCompoundMethod>Unassigned</BaseRateCompoundMethod>
<BaseRateInterestMethod>Unassigned</BaseRateInterestMethod>
<BondName>sample string 2</BondName>
<CallSchedule>
<Rel>sample string 2</Rel>
<Uri>http://webapihelppage3.com/</Uri>
<Verb>sample string 1</Verb>
</CallSchedule>
<Collateral>sample string 4</Collateral>
<ConvertibleType>sample string 5</ConvertibleType>
<CountryId>1</CountryId>
<CouponDateOffset>None</CouponDateOffset>
<CouponFrequency>Annual</CouponFrequency>
<CouponRates>
<Rel>sample string 2</Rel>
<Uri>http://webapihelppage3.com/</Uri>
<Verb>sample string 1</Verb>
</CouponRates>
<CouponType>Fixed</CouponType>
<Coupons>
<Rel>sample string 2</Rel>
<Uri>http://webapihelppage3.com/</Uri>
<Verb>sample string 1</Verb>
</Coupons>
<CurrencyCode>sample string 6</CurrencyCode>
<DateOffset>1</DateOffset>
<DayCount>ACT_ACT</DayCount>
<DefaultDate>2024-11-23T01:19:21.8650924-06:00</DefaultDate>
<DefaultType>sample string 7</DefaultType>
<FirstCouponDate>2024-11-23T01:19:21.8650924-06:00</FirstCouponDate>
<FirstSettleDate>2024-11-23T01:19:21.8650924-06:00</FirstSettleDate>
<FixedRate>1.1</FixedRate>
<GuarantorId>1</GuarantorId>
<HasAttachedWarrants>true</HasAttachedWarrants>
<HasDefaulted>true</HasDefaulted>
<HasFXRisk>true</HasFXRisk>
<HolidayCalendarId>1</HolidayCalendarId>
<Id>1</Id>
<Identifiers>
<Rel>sample string 2</Rel>
<Uri>http://webapihelppage3.com/</Uri>
<Verb>sample string 1</Verb>
</Identifiers>
<InsurerId>1</InsurerId>
<InterestAccrualDate>2024-11-23T01:19:21.8660906-06:00</InterestAccrualDate>
<IsBaseRateObservationShiftEnabled>true</IsBaseRateObservationShiftEnabled>
<IsCallable>true</IsCallable>
<IsCollateralized>true</IsCollateralized>
<IsDeleted>true</IsDeleted>
<IsEmergingMarket>true</IsEmergingMarket>
<IsInterestOnly>true</IsInterestOnly>
<IsPIKBond>true</IsPIKBond>
<IsPrincipalOnly>true</IsPrincipalOnly>
<IsPrivate>true</IsPrivate>
<IsPutable>true</IsPutable>
<IsRestructured>true</IsRestructured>
<IsStructuredFinanceObligation>true</IsStructuredFinanceObligation>
<IsSynthetic>true</IsSynthetic>
<IsTradedAccrued>true</IsTradedAccrued>
<IssueDate>2024-11-23T01:19:21.8665727-06:00</IssueDate>
<IssuePrice>1.1</IssuePrice>
<IssueSize>1</IssueSize>
<Issuer>
<Rel>sample string 2</Rel>
<Uri>http://webapihelppage3.com/</Uri>
<Verb>sample string 1</Verb>
</Issuer>
<Links>
<Link>
<Rel>sample string 2</Rel>
<Uri>http://webapihelppage3.com/</Uri>
<Verb>sample string 1</Verb>
</Link>
<Link>
<Rel>sample string 2</Rel>
<Uri>http://webapihelppage3.com/</Uri>
<Verb>sample string 1</Verb>
</Link>
</Links>
<LockoutDays>30</LockoutDays>
<MaturityDate>2024-11-23T01:19:21.8665727-06:00</MaturityDate>
<MaturityDateExpected>2024-11-23T01:19:21.8665727-06:00</MaturityDateExpected>
<Notes>sample string 26</Notes>
<PIKCashPercentage>1.1</PIKCashPercentage>
<PIKPercentage>1.1</PIKPercentage>
<PayNonBusinessDirection>On</PayNonBusinessDirection>
<PayOffsetDays>27</PayOffsetDays>
<PayOffsetDirection>After</PayOffsetDirection>
<PayOffsetType>BusinessDays</PayOffsetType>
<PaysEndOfMonth>true</PaysEndOfMonth>
<Ratings>
<Rel>sample string 2</Rel>
<Uri>http://webapihelppage3.com/</Uri>
<Verb>sample string 1</Verb>
</Ratings>
<RegistrationType>sample string 29</RegistrationType>
<SeniorityId>1</SeniorityId>
<SpreadRate>1.1</SpreadRate>
<Udfs>
<Rel>sample string 2</Rel>
<Uri>http://webapihelppage3.com/</Uri>
<Verb>sample string 1</Verb>
</Udfs>
</Bond>