Changelog

Version Changes

v1.0.0

Initial API version

v1.1.0

  • Added deals endpoint

  • Added updatedSince link to priced deals

  • Removed lastDataChange field from priced deals

  • Added glossary to documentation

v1.2.0

  • Added headline and message to deals

v2.0.0

General

  • Changed API URL for easier transition.Old URL is deprecated.

Priced Deal

  • Breaking change: removed GGB and Extendable fields

  • Breaking change: removed global field

  • Breaking change: removed swap and yield field from Premium object

  • Breaking change: removed hy and subGrade fields and added grade field instead

  • Breaking change: renamed launch field to pricingDate

  • Breaking change: renamed priced deal id to dealId

  • Breaking change: renamed spread field to swap

  • Breaking change: moved gov field from Premium object to the main priced deal object

  • Breaking change: changed bank field structure

  • Breaking change: changed price evolutions field structure

  • Breaking change: changed fxRate field structure

  • Breaking change: new structure for nominal, secondary fields and new field total. Those contain data from previous usdEquivalent, totalNominal fields.

  • Added cuc, coc, mwc, tier, exchange, retained, nominalWithExchange and nominalWithRetained fields

Expected Deal

  • Breaking change: renamed deals to expected deals

v2.1.0

Priced Deal

  • Added status field for the bank

v2.2.0

Priced Deal

  • Added finalBooks and finalAccounts fields to stats object

  • Added pricingTime field

Description

  • All endpoints with descriptions can be found in OpenAPI v2 specification here and in more human friendly representation here.

  • Endpoints returns HAL formatted responses to enable easier navigation to the data. For more information visit http://stateless.co/hal_specification.html

  • Latest version of this documentation can be found here: HTML | PDF

Authentication

API uses client credentials flow of OAuth2 authorization protocol.

Before you start making requests to Bond Radar Data API, you will need to acquire access token. Please follow below steps to start making requests:

  1. Send a request to https://api.bondradar.com/oauth/token. Within the request provide your client ID (Bond Radar username) and secret (your password) in HTTP Basic auth header, see example request below:

    Example request
    POST https://api.bondradar.com/oauth/token
    Content-Type: application/x-www-form-urlencoded
    Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
    
    grant_type=client_credentials
  2. When you receive your access token you can start making your requests by passing your access token in an HTTP authorization header as a bearer token, please see example request below:

    Authorization: Bearer {token}
    • token - Access token retrieved from token endpoint

Pagination

Pagination is done using _links object. first link points to first page of the list and next link points to next page of the list. Navigation to specific page or the last page is not supported.

You might see seeker query parameter in the list url. This parameter is only for pagination purposes and must not be set manually.

Date formatting

API uses ISO 8601 formats for time related data.

Table 1. Formats
Format Example

Date

YYYY-MM-DD

2019-01-30

Date and time

YYYY-MM-DDThh:mm:ssZ

2019-01-30T12:34:56Z

Time

Thh:mm:ssZ or Thh:mm:ss±hh:mm

21:12Z or 20:31:24+01:00

Access restrictions

When you are given access to Bond Radar Data API your access may be limited depending on your account type. There are two account types for accessing Bond Radar Data API:

  • Free Trial

  • VIP

During any Free Trial period access to data is strictly limited to two years only. This applies to Priced Deals data only.

Free Trial Users attempting to access data which is deemed to be outside this data allowance will receive an empty list on Priced Deals list and 403 (forbidden) response when accessing specific deal.

VIP users have no restrictions and can access full data.

Expected deals list

New real-time data releases on deal flows in the international bond markets. The expected deal list comprises of updates on data related to expected (new) deals, expected increased deals, priced (new) deals, priced increased deals. For fully comprehensive 'priced deal' data, retrieve data from the 'priced deal' API.

List links
  • first - Link to the first page of a list.

  • next - Link to the next page of a list.

Deal links
  • pricedDeal in tranches - Link to the priced deal of the tranche.

  • self - Link to the deal itself. Can be used as an identifier.

Data ingestion flow

Expected deal data ingestion flow would look like this:

  1. Open expected deals list by using a link from the specification.

  2. Download all data by navigating through pages using next link.

If you want to update your data, you need to download the whole list again, because some items might be missing from it. It is the clients' responsibility to store historical records of the data flows. This includes corrections and enhancements to the data archive. We recommend updating 'expected deal list' once every 5 minutes.

Priced deals list

Comprehensive deals data on priced bonds in the Emerging and High-Grade Markets. The API will present complete data for a 'priced deal' (and subsequent 'priced deal increases' thereof).

Data is organised in reverse chronological order based on when the deal information was last updated. Clients are advised to sort data based on pricing date.

List links
  • first - Link to the first page of a list.

  • next - Link to the next page of a list.

Priced deal links
  • self - Link to the priced deal itself. Can be used as an identifier.

  • original - Link to the original priced deal.

  • updatedSince - Link to the list with priced deals, which have been updated since this priced deal was updated.

Data ingestion flow

Priced deal data ingestion flow would look like this:

  1. Open priced deals list by using a link from the specification or by using previously saved updatedSince link if you need to update your data.

  2. Save updatedSince link from a first entry in the first page of the list.

  3. Download all data by navigating through pages using next link.

Priced deal list is ordered by a data update time from newest to oldest. updatedSince link points to a list with data that was updated since that specific deal was updated. Thus, by using this link from the first entry of the first page, it is possible to download only the updated data.

However, to maintain a historical list it is important to download the whole priced deals list periodically. In some cases some priced deals are removed due to various reasons, so downloading the whole list will allow maintaining correct historical data. Another advantage of downloading a historical list is to add fields to historical data that are introduced with API version updates.

We recommend updating 'priced deal list' with updatedSince link once every 5 minutes and download the whole list once every day.

Common scenarios

Retrieve expected deals list

API clients can retrieve pipeline deals list.

EM market

Sample Request
GET https://api.bondradar.com/v2/em/expected-deal
Authorization: Bearer {access-token}
Sample Response
{
  "_embedded": {
    "expectedDeals": [
      {
        "id": 12225678,
        "market": "EM",
        "created": "2020-05-06T08:43:00Z",
        "changed": "2020-05-07T11:43:00Z",
        "headline": "** Bahrain USD benchmark dual-tranche: Guidance",
        "message": "Tranche A: USD benchmark 4.5-year Sukuk, due 14 November 2024, guidance 6.375% area. English and Bahrain Law.\nTranche B: USD benchmark 10-year, due 14 May 2030, guidance 7.625% area. English law.\nCommon terms: Issuer (Sukuk/Bond) CBB International Sukuk Programme Company S.P.C./The Kingdom of Bahrain, acting through the Ministry of Finance and National Economy. Sukuk obligor The Kingdom of Bahrain, acting through the Ministry of Finance and National Economy. Issuer/obligor/expected issue ratings B+/BB- (S&P/Fitch). 144A/RegS. Senior unsecured notes. Settle 14 May 2020. Denoms 200kx1k. List Dublin. Jt-lead managers Bank ABC, Gulf International Bank, HSBC, J.P. Morgan (B&D), National Bank of Bahrain and Standard Chartered Bank. \nBook update: Total in excess of USD7.5bn (including JLM interest of USD300m), to go subject at 1.30pm UKT. Today's business.\n\n",
        "borrower": {
          "name": "BAHRAIN",
          "region": "CEEMEA",
          "country": "BAHRAIN",
          "type": "Sovereign",
          "sector": "Sovereign"
        },
        "regions": [
          "CEEMEA"
        ],
        "_embedded": {
          "tranches": [
            {
              "name": "A",
              "changed": "2020-05-07T11:43:00Z",
              "status": "EXPECTED",
              "currency": "USD",
              "volume": "bmk",
              "structure": "4.5ySukuk",
              "priceEvolution": "6.375%a",
              "ratings": {
                "standardAndPoors": "B+",
                "fitch": "BB-"
              },
              "timing": "today"
            },
            {
              "name": "B",
              "changed": "2020-05-07T11:43:00Z",
              "status": "EXPECTED",
              "currency": "USD",
              "volume": "bmk",
              "structure": "10y",
              "priceEvolution": "7.625%a",
              "ratings": {
                "standardAndPoors": "B+",
                "fitch": "BB-"
              },
              "timing": "today"
            }
          ]
        },
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/em/expected-deal/12225678"
          }
        }
      },
      {
        "id": 12224471,
        "market": "EM",
        "created": "2020-04-30T11:10:00Z",
        "changed": "2020-05-07T11:29:00Z",
        "headline": "** CAF USD benchmark 3-year: Spread set at MS+220bp ",
        "message": "Spread set at MS+220bp on CAF's USD benchmark 3-year issue, due 12 May 2023. Expected ratings Aa3/A+/A+. SEC registered. Settle 12 May 2020. UOP: Partially finance a COVID-19-related emergency credit line to help shareholder countries tackle the COVID-19 pandemic. Law NY. Denoms 1k/1k. List London. Leads Barclays, Citi, HSBC, J.P. Morgan. \nBook update: Over USD1.2bn (excl. JLM). Books close London 14.00. Today's business.",
        "borrower": {
          "name": "CORPORACION ANDINA DE FOMENTO",
          "region": "Latam",
          "country": "LATAM MULTINATIONAL",
          "type": "SUPRA",
          "sector": "Supra"
        },
        "regions": [
          "Latam"
        ],
        "_embedded": {
          "tranches": [
            {
              "name": "A",
              "changed": "2020-05-07T11:29:00Z",
              "status": "EXPECTED",
              "currency": "USD",
              "volume": "TBA",
              "structure": "3y",
              "priceEvolution": "MS+220",
              "ratings": {
                "moodys": "Aa3",
                "standardAndPoors": "A+",
                "fitch": "A+"
              },
              "timing": "today"
            }
          ]
        },
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/em/expected-deal/12224471"
          }
        }
      },
      {
        "id": 12225615,
        "market": "EM",
        "created": "2020-05-06T07:59:00Z",
        "changed": "2020-05-06T08:00:00Z",
        "headline": "Serbia plans investor call/EUR benchmark 7-year issue",
        "message": "\"The Republic of Serbia (represented by the Government of the Republic of Serbia, acting by and through the Ministry of Finance), rated Ba3 (Positive) by Moody's, BB+ (Stable) by S&P and BB+ (Stable) by Fitch, has mandated BNP Paribas, Citi, Deutsche Bank and J.P. Morgan as Joint Lead Managers to organize a Global Investor Call on Wednesday, 6 May 2020 at 10:30h UKT / 11:30h CET. A Rule 144A/Reg S Euro denominated 7-year benchmark bond offering will follow, subject to market conditions.\"",
        "borrower": {
          "name": "SERBIA",
          "region": "CEEMEA",
          "country": "SERBIA",
          "type": "Sovereign",
          "sector": "Sovereign"
        },
        "regions": [
          "CEEMEA"
        ],
        "_embedded": {
          "tranches": [
            {
              "name": "A",
              "changed": "2020-05-06T08:00:00Z",
              "status": "EXPECTED",
              "currency": "EUR",
              "volume": "bmk",
              "structure": "7y",
              "ratings": {
                "moodys": "Ba3",
                "standardAndPoors": "BB+",
                "fitch": "BB+"
              },
              "timing": "i/c 06 May"
            }
          ]
        },
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/em/expected-deal/12225615"
          }
        }
      }
    ]
  },
  "_links": {
    "first": {
      "href": "https://api.bondradar.com/v2/em/expected-deal"
    },
    "next": {
      "href": "https://api.bondradar.com/v2/em/expected-deal?seeker=2020-05-06T08%3A00%3A00Z_12225615"
    }
  }
}

HG market

Sample Request
GET https://api.bondradar.com/v2/hg/expected-deal
Authorization: Bearer {access-token}
Sample Response
{
  "_embedded": {
    "expectedDeals": [
      {
        "id": 12226228,
        "market": "HG",
        "created": "2020-05-07T11:55:00Z",
        "changed": "2020-05-07T12:06:00Z",
        "headline": "** Newcrest Finance USD benchmark dual tranche: IPTs",
        "message": "Tranche A: USD benchmark, 10-year due 13 May 2030. IPTs T+325bp area. 3-month par call.\nTranche B: USD benchmark, 30-year due 13 May 2050. IPTs T+350bp area. 6-month par call.\nCommon terms: 144A/RegS. senior unsecured issue. COC, MWC.  Expected ratings Baa2/BBB. Settle T+4.  Denoms 2k x 1k. UOP: GCP and redeem, repurchase or refinance a portion of outstanding\ncorporate bond indebtedness, particularly with near-term maturities. Jt-leads BofA, JPM, RBC. Timing: Today's business. ",
        "borrower": {
          "name": "NEWCREST FINANCE",
          "region": "North America",
          "country": "USA",
          "type": "Corporate",
          "sector": "Basic Materials",
          "subsector": "Mining"
        },
        "regions": [
          "Americas"
        ],
        "hy": false,
        "coveredBonds": false,
        "_embedded": {
          "tranches": [
            {
              "name": "A",
              "changed": "2020-05-07T11:58:00Z",
              "status": "EXPECTED",
              "currency": "USD",
              "volume": "bmk",
              "structure": "10y",
              "priceEvolution": "T+325a",
              "books": "JT-LEADS",
              "timing": "today"
            },
            {
              "name": "B",
              "changed": "2020-05-07T11:58:00Z",
              "status": "EXPECTED",
              "currency": "USD",
              "volume": "bmk",
              "structure": "30y",
              "priceEvolution": "T+350a",
              "books": "JT-LEADS",
              "timing": "today"
            }
          ]
        },
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/hg/expected-deal/12226228"
          }
        }
      },
      {
        "id": 12225223,
        "market": "HG",
        "created": "2020-05-05T08:05:00Z",
        "changed": "2020-05-07T11:48:00Z",
        "headline": "** HSBC Bank Canada USD benchmark 3-year CB: Revised IPTs MS+75bp area",
        "message": "Revised IPTs are MS+75bp area for HSBC Bank Canada's planned USD benchmark 3-year issue, due 14 May 2023. Settle 14 May 2020. 144A/RegS. List N/A, denoms 200kx1k. Canadian legislative covered bond, backed by 100% prime Canadian residential mortgages. Expected ratings Aaa/AAA (Moody's/Fitch). Leads CIBC, Danske Bank, HSBC, LBBW, Natixis, Rabobank, RBC and Santander. \nBook update: Over USD1.7 to go subject at 2pm UK timebn, today's business. ",
        "borrower": {
          "name": "HSBC BANK CANADA",
          "region": "North America",
          "country": "CANADA",
          "type": "Financial",
          "sector": "Banking"
        },
        "regions": [
          "Americas"
        ],
        "hy": false,
        "coveredBonds": true,
        "_embedded": {
          "tranches": [
            {
              "name": "A",
              "changed": "2020-05-07T11:48:00Z",
              "status": "EXPECTED",
              "currency": "USD",
              "volume": "bmk",
              "structure": "3y CB",
              "priceEvolution": "MS+75a",
              "books": "JT-LEADS",
              "timing": "today"
            }
          ]
        },
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/hg/expected-deal/12225223"
          }
        }
      },
      {
        "id": 12224287,
        "market": "HG",
        "created": "2020-04-29T13:12:00Z",
        "changed": "2020-05-07T11:28:00Z",
        "headline": "** OMERS Finance EUR1bn 5-year: Launched at MS+78bp",
        "message": "Size is set at EUR1bn and spread set at MS+78bp for OMERS Finance Trust's inaugural 5-year, due 13 May 2025. Settle 13 May 2020. RegS/144A. List Lux, denoms 250kx1k. New York law. Rated Aa1/AA+/AAA. Leads BNP Paribas, Credit Agricole CIB, HSBC, ING, Natixis and Societe Generale. \nBook update: EUR1.4bn (excl. JLM). EMEA books are subject, Global books to close 12.35 UK time. Today's business. ",
        "borrower": {
          "name": "OMERS",
          "region": "North America",
          "country": "CANADA",
          "type": "Agency",
          "sector": "Agency"
        },
        "regions": [],
        "hy": false,
        "coveredBonds": false,
        "_embedded": {
          "tranches": [
            {
              "name": "A",
              "changed": "2020-05-07T11:28:00Z",
              "status": "EXPECTED",
              "currency": "EUR",
              "volume": "1bn",
              "structure": "5y",
              "priceEvolution": "MS+78",
              "books": "JT-LEADS",
              "timing": "today"
            }
          ]
        },
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/hg/expected-deal/12224287"
          }
        }
      }
    ]
  },
  "_links": {
    "first": {
      "href": "https://api.bondradar.com/v2/hg/expected-deal"
    },
    "next": {
      "href": "https://api.bondradar.com/v2/hg/expected-deal?seeker=2020-05-07T11%3A28%3A00Z_12224287"
    }
  }
}

Retrieve priced deals list

API clients can retrieve priced deals list.

EM market

Sample Request
GET https://api.bondradar.com/v2/em/priced-deal
Authorization: Bearer {access-token}
Sample Response
{
  "_embedded": {
    "pricedDeals": [
      {
        "dealId": 12385934,
        "market": "EM",
        "dealType": "ORIGINAL",
        "pricingDate": "2020-05-15",
        "pricingTime": "21:12+01:00",
        "borrower": {
          "name": "LENOVO",
          "region": "ASIA (non-Japan)",
          "country": "CHINA",
          "type": "Corporate",
          "sector": "Technology",
          "subsector": "Electronics"
        },
        "currency": "USD",
        "nominal": {
          "amount": 1000,
          "converted": {
            "usd": 0
          }
        },
        "exchange": {
          "amount": 200,
          "converted": {
            "usd": 0
          }
        },
        "nominalWithExchange": {
          "amount": 1200,
          "converted": {
            "usd": 0
          }
        },
        "rating": {
          "moodys": "Aaa",
          "standardAndPoors": "AAA",
          "fitch": "AA"
        },
        "grade": "INVESTMENT",
        "ranking": "IG",
        "cpn": "",
        "cpnType": "",
        "perpetual": false,
        "maturity": "2021-03-01",
        "fpr": 0,
        "fxRate": {
          "usd": 1
        },
        "premium": {},
        "subordinated": false,
        "leagueTableEligible": true,
        "priceEvolution": [
          {
            "date": "2020-05-07T02:01:00Z",
            "value": "100.25a"
          },
          {
            "date": "2020-05-07T10:17:00Z",
            "value": "101.00"
          },
          {
            "date": "2020-05-07T11:53:00Z",
            "value": "101.00"
          }
        ],
        "banks": [
          {
            "name": "JEFFERIES",
            "status": "active"
          }
        ],
        "covered": false,
        "only144a": false,
        "onlyRegS": false,
        "regSAnd144a": false,
        "secRegistered": false,
        "green": false,
        "sustainable": false,
        "social": false,
        "seniorNonPreferred": false,
        "seniorPreferred": false,
        "holdCo": false,
        "opCo": false,
        "coc": false,
        "cuc": false,
        "mwc": false,
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/em/priced-deal/12385934"
          },
          "updatedSince": {
            "href": "https://api.bondradar.com/v2/em/priced-deal?updatedSince=2020-05-21T05%3A49%3A09Z"
          }
        }
      },
      {
        "dealId": 12225982,
        "market": "EM",
        "dealType": "ORIGINAL",
        "pricingDate": "2020-05-06",
        "pricingTime": "17:08+01:00",
        "borrower": {
          "name": "CPI PROPERTY GROUP SA",
          "region": "CEEMEA",
          "country": "CZECH REPUBLIC",
          "type": "Corporate",
          "sector": "Infrastructure",
          "subsector": "Public Buildings"
        },
        "currency": "EUR",
        "nominal": {
          "amount": 750,
          "converted": {
            "usd": 791.0703
          }
        },
        "rating": {
          "moodys": "NR",
          "standardAndPoors": "NR",
          "fitch": "NR"
        },
        "grade": "UNRATED",
        "ranking": "NR",
        "cpn": "2.75",
        "cpnType": "FIXED",
        "perpetual": false,
        "maturity": "2026-05-12",
        "fpr": 97.663,
        "swap": "MS+345",
        "yield": "3.184%",
        "gov": "B+388.5",
        "fxRate": {
          "usd": 1.08
        },
        "premium": {},
        "subordinated": false,
        "leagueTableEligible": true,
        "bloombergCode": "BJ3266431 CORP",
        "priceEvolution": [
          {
            "date": "2020-05-06T07:46:00Z",
            "value": "MS+380a"
          },
          {
            "date": "2020-05-06T11:12:00Z",
            "value": "MS+355a"
          },
          {
            "date": "2020-05-06T12:36:00Z",
            "value": "MS+345"
          },
          {
            "date": "2020-05-06T14:35:00Z",
            "value": "MS+345"
          }
        ],
        "banks": [
          {
            "name": "CREDIT SUISSE",
            "status": "active"
          },
          {
            "name": "HSBC",
            "status": "passive"
          },
          {
            "name": "DEUTSCHE BANK",
            "status": "active"
          },
          {
            "name": "NOMURA",
            "status": "passive"
          },
          {
            "name": "UNICREDIT GROUP",
            "status": "active"
          }
        ],
        "covered": false,
        "only144a": false,
        "onlyRegS": true,
        "regSAnd144a": false,
        "secRegistered": false,
        "green": true,
        "sustainable": false,
        "social": false,
        "seniorNonPreferred": false,
        "seniorPreferred": false,
        "holdCo": false,
        "opCo": false,
        "coc": true,
        "cuc": false,
        "mwc": true,
        "additionalInfo": "COC, MWC, 3m par call",
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/em/priced-deal/12225982"
          },
          "updatedSince": {
            "href": "https://api.bondradar.com/v2/em/priced-deal?updatedSince=2020-05-15T09%3A17%3A38Z"
          }
        }
      },
      {
        "dealId": 11732989,
        "market": "EM",
        "dealType": "INCREASE",
        "pricingDate": "2019-07-23",
        "pricingTime": "14:20+01:00",
        "borrower": {
          "name": "FCT",
          "region": "ASIA (non-Japan)",
          "country": "SINGAPORE",
          "type": "Corporate",
          "sector": "Consumer Goods & Services",
          "subsector": "Retail"
        },
        "currency": "SGD",
        "nominal": {
          "amount": 200,
          "converted": {
            "usd": 146.76942
          }
        },
        "total": {
          "nominal": {
            "amount": 600,
            "converted": {
              "usd": 438.76942
            }
          }
        },
        "rating": {
          "moodys": "NR",
          "standardAndPoors": "NR",
          "fitch": "NR"
        },
        "grade": "UNRATED",
        "ranking": "NR",
        "cpn": "4.98",
        "cpnType": "FIXED",
        "nonBullet": "PNC5",
        "firstCallDate": "2024-04-11",
        "perpetual": true,
        "fpr": 100.527,
        "yield": "4.85%",
        "fxRate": {
          "usd": 0.73
        },
        "premium": {},
        "subordinated": true,
        "leagueTableEligible": true,
        "bloombergCode": "ZS0526344 CORP",
        "stats": {
          "stats": "Final orderbooks in excess of SGD500m across 41 accounts.",
          "finalBooks": 500,
          "finalAccounts": 41,
          "investorType": {
            "Banks/Funds": 25,
            "Private Banks": 75
          },
          "geography": {
            "non-Singapore": 11,
            "Singapore": 89
          }
        },
        "priceEvolution": [
          {
            "date": "2019-11-09T11:23:00Z",
            "value": "4.90%a"
          },
          {
            "date": "2019-11-09T11:23:00Z",
            "value": "4.85%"
          }
        ],
        "banks": [
          {
            "name": "OCBC",
            "status": "passive"
          }
        ],
        "covered": false,
        "only144a": false,
        "onlyRegS": true,
        "regSAnd144a": false,
        "secRegistered": false,
        "green": false,
        "sustainable": false,
        "social": false,
        "seniorNonPreferred": false,
        "seniorPreferred": false,
        "holdCo": false,
        "opCo": false,
        "coc": true,
        "cuc": false,
        "mwc": false,
        "additionalInfo": "COC.",
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/em/priced-deal/11732989"
          },
          "original": {
            "href": "https://api.bondradar.com/v2/em/priced-deal/11732987"
          },
          "updatedSince": {
            "href": "https://api.bondradar.com/v2/em/priced-deal?updatedSince=2020-05-13T12%3A32%3A24Z"
          }
        }
      }
    ]
  },
  "_links": {
    "first": {
      "href": "https://api.bondradar.com/v2/em/priced-deal"
    },
    "next": {
      "href": "https://api.bondradar.com/v2/em/priced-deal?seeker=2020-05-13T12%3A32%3A24Z_11732989"
    }
  }
}

HG market

Sample Request
GET https://api.bondradar.com/v2/hg/priced-deal
Authorization: Bearer {access-token}
Sample Response
{
  "_embedded": {
    "pricedDeals": [
      {
        "dealId": 12418700,
        "market": "HG",
        "dealType": "ORIGINAL",
        "pricingDate": "2020-05-20",
        "pricingTime": "21:12+01:00",
        "borrower": {
          "name": "UK",
          "region": "Western Europe",
          "country": "UK",
          "type": "Sovereign",
          "sector": "Sovereign"
        },
        "currency": "GBP",
        "nominal": {
          "amount": 1300,
          "converted": {
            "usd": 0
          }
        },
        "retained": {
          "amount": 100,
          "converted": {
            "usd": 0
          }
        },
        "nominalWithRetained": {
          "amount": 1400,
          "converted": {
            "usd": 0
          }
        },
        "rating": {
          "moodys": "A3",
          "standardAndPoors": "BB+",
          "fitch": "NR"
        },
        "grade": "INVESTMENT",
        "ranking": "Crossover",
        "cpn": "",
        "cpnType": "",
        "perpetual": false,
        "maturity": "2022-08-08",
        "fpr": 0,
        "fxRate": {
          "usd": 1
        },
        "subordinated": false,
        "leagueTableEligible": true,
        "priceEvolution": [],
        "banks": [
          {
            "name": "GREAT BAY SECURITIES",
            "status": "active"
          }
        ],
        "pref": false,
        "covered": false,
        "only144a": false,
        "onlyRegS": false,
        "regSAnd144a": false,
        "secRegistered": false,
        "secExempt": false,
        "section3a2": false,
        "green": false,
        "sustainable": false,
        "social": false,
        "seniorNonPreferred": false,
        "seniorPreferred": false,
        "holdCo": false,
        "opCo": false,
        "coc": false,
        "cuc": false,
        "mwc": false,
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/hg/priced-deal/12418700"
          },
          "updatedSince": {
            "href": "https://api.bondradar.com/v2/hg/priced-deal?updatedSince=2020-05-21T05%3A50%3A34Z"
          }
        }
      },
      {
        "dealId": 12418698,
        "market": "HG",
        "dealType": "ORIGINAL",
        "pricingDate": "2020-05-20",
        "pricingTime": "21:06+01:00",
        "borrower": {
          "name": "JOHNSON & JOHNSON",
          "region": "North America",
          "country": "USA",
          "type": "Corporate",
          "sector": "Consumer Goods & Services",
          "subsector": "Healthcare & Pharmaceuticals"
        },
        "currency": "USD",
        "nominal": {
          "amount": 1000,
          "converted": {
            "usd": 0
          }
        },
        "rating": {
          "moodys": "NR",
          "standardAndPoors": "NR",
          "fitch": "NR"
        },
        "grade": "UNRATED",
        "ranking": "NR",
        "cpn": "",
        "cpnType": "",
        "perpetual": false,
        "maturity": "2022-02-01",
        "fpr": 0,
        "fxRate": {
          "usd": 1
        },
        "subordinated": false,
        "leagueTableEligible": true,
        "priceEvolution": [],
        "banks": [
          {
            "name": "RBC",
            "status": "active"
          }
        ],
        "pref": false,
        "covered": false,
        "only144a": false,
        "onlyRegS": false,
        "regSAnd144a": false,
        "secRegistered": false,
        "secExempt": false,
        "section3a2": false,
        "green": false,
        "sustainable": false,
        "social": false,
        "seniorNonPreferred": false,
        "seniorPreferred": false,
        "holdCo": false,
        "opCo": false,
        "coc": false,
        "cuc": false,
        "mwc": false,
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/hg/priced-deal/12418698"
          },
          "updatedSince": {
            "href": "https://api.bondradar.com/v2/hg/priced-deal?updatedSince=2020-05-20T08%3A17%3A45Z"
          }
        }
      },
      {
        "dealId": 12058534,
        "market": "HG",
        "dealType": "INCREASE",
        "pricingDate": "2019-12-11",
        "pricingTime": "12:34+01:00",
        "borrower": {
          "name": "SCOR SE",
          "region": "Western Europe",
          "country": "FRANCE",
          "type": "Financial",
          "sector": "Insurance"
        },
        "currency": "USD",
        "nominal": {
          "amount": 124.8,
          "converted": {
            "usd": 123.708
          }
        },
        "total": {
          "nominal": {
            "amount": 749.8,
            "converted": {
              "usd": 748.708
            }
          }
        },
        "rating": {
          "moodys": "Baa1",
          "standardAndPoors": "A-",
          "fitch": "NR"
        },
        "grade": "INVESTMENT",
        "ranking": "IG",
        "cpn": "5.25",
        "cpnType": "FIXED",
        "nonBullet": "PNC11",
        "firstCallDate": "2029-03-13",
        "perpetual": true,
        "fpr": 99.125,
        "spread": "MS+345",
        "yield": "5.37%",
        "fxRate": {
          "usd": 1
        },
        "subordinated": true,
        "leagueTableEligible": true,
        "bloombergCode": "AR5064167 CORP",
        "priceEvolution": [
          {
            "date": "2019-12-12T09:05:42Z",
            "value": "97.875a"
          },
          {
            "date": "2019-12-12T09:05:42Z",
            "value": "98.75a"
          },
          {
            "date": "2019-12-12T09:05:42Z",
            "value": "99.125"
          }
        ],
        "banks": [
          {
            "name": "CREDIT AGRICOLE",
            "status": "active"
          },
          {
            "name": "BNP PARIBAS",
            "status": "passive"
          },
          {
            "name": "JP MORGAN",
            "status": "passive"
          }
        ],
        "pref": false,
        "covered": false,
        "only144a": false,
        "onlyRegS": true,
        "regSAnd144a": false,
        "secRegistered": false,
        "secExempt": false,
        "section3a2": false,
        "green": false,
        "sustainable": false,
        "social": false,
        "seniorNonPreferred": false,
        "seniorPreferred": false,
        "holdCo": false,
        "opCo": false,
        "additionalInfo": "Restricted Tier 1",
        "coc": false,
        "cuc": false,
        "mwc": false,
        "tier": "RT1",
        "_links": {
          "self": {
            "href": "https://api.bondradar.com/v2/hg/priced-deal/12058534"
          },
          "original": {
            "href": "https://api.bondradar.com/v2/hg/priced-deal/10748817"
          },
          "updatedSince": {
            "href": "https://api.bondradar.com/v2/hg/priced-deal?updatedSince=2020-05-08T10%3A30%3A51Z"
          }
        }
      }
    ]
  },
  "_links": {
    "first": {
      "href": "https://api.bondradar.com/v2/hg/priced-deal"
    },
    "next": {
      "href": "https://api.bondradar.com/v2/hg/priced-deal?seeker=2020-05-08T10%3A30%3A51Z_12058534"
    }
  }
}

Glossary

Expected deals list

Type

{
  "self": {
    "href":     string
  }
}

URI link to 'expected deal'.

borrower

Type

{
  "country":      string,
  "name":         string,
  "region":       string,
  "sector":       string,
  "subsector":    string,
  "type":         string
}

Issuer of bond.

changed

Type

string(DateTime)

Latest update date.

coveredBonds

Type

boolean

The deal is covered by other assets (e.g. pool of mortgages) (for HG region only).

created

Type

string(DateTime)

Deal creation date.

headline

Type

string

Deal headline.

hy

Type

boolean

Typically, a higher paying bond with a sub investment grade credit rating (for HG region only).

id

Type

number

Unique deal ID number.

market

Type

string(Enum: EM, HG)

EM – Emerging Market (CEEMA, LATAM, Asia (ex Japan)).
HG – High Grade Market (Western Europe, North America, Japan and Australasia).

message

Type

string

Full deal annuoncement.

regions

Type

string(Enum: LATAM, CEEMEA, ASIA, AMERICA)

Bond region.

Type

{
  "pricedDeal": {
    "href":     string
  }
}

URI link to 'priced deal'.

changed (Tranche[1])

Type

string(DateTime)

Latest update date.

currency (Tranche[1])

Type

string

Currency denomination of deal.

books (Tranche[1])

Type

string

Bookrunners involved in deal (for HG region only).

name (Tranche[1])

Type

string

Name of each tranche. For multi-tranche deal, this will be labelled as A,B,C,D etc.

priceEvolution (Tranche[1])

Type

string

The deal spread/yield from IPTs, Guidance and Final terms.

ratings (Tranche[1])

Type

string

Bond ratings.

status (Tranche[1])

Type

string(Enum: EXPECTED, TO_BE_INCREASED, INCREASED, PRICED)

Deal status.

structure (Tranche[1])

Type

string

Deal structure.

timing (Tranche[1])

Type

string

Expected completion date.

volume (Tranche[1])

Type

string

Size of deal.

Priced deals list

Type

{
  "self": {
    "href":     string
  },
  "updatedSince": {
    "href":     string
  }
}

Bond Radar Data Wizard Field

Not Included

URI links for 'priced deal'.

additionalInfo

Type

string

Bond Radar Data Wizard Field

Add. Info

Box where any additional info is entered

Guaranteed - A guaranteed bond is a bond whose interest and principal payments are guaranteed by a third party.

Keepwell - A keepwell agreement is a contract between a parent company and its subsidiary to maintain solvency and financial backing throughout the term set in the agreement.

Sukuk - Islamic bonds, structured in such a way as to generate returns to investors without infringing Islamic law (that prohibits riba or interest).

banks

Type

[
  {
    "name":         string,
    "status":       string
  }
]

Bond Radar Data Wizard Field

Bookrunners
LEAD1-23

Dropdown selection of all bookrunners involved in deal.

bloombergCode

Type

string

Bond Radar Data Wizard Field

Bloomberg Code

Bloomberg DES page code.

borrower

Type

{
  "country":      string,
  "name":         string,
  "region":       string,
  "sector":       string,
  "subsector":    string,
  "type":         string
}

Bond Radar Data Wizard Field

Country
Issuer
Region
Category
Sector
Category

Issuer of bond.

coc

Type

boolean

Bond Radar Data Wizard Field

COC

Change of control. It is mainly put into effect when the owner of a borrower is changed, thus changing the potential guarantor of the bond. A provision in an agreement giving a party certain rights (such as consent, payment or termination) in connection with a change in ownership or management of the other party to the agreement. Not all change of control provisions are triggered by the same action. For example, a change of control may be triggered by a sale of more than 50% of a party’s stock, a sale of substantially all the assets of a party or a change in most of the board members of a party.

covered

Type

boolean

Bond Radar Data Wizard Field

Covered

The deal is covered by other assets (e.g. pool of mortgages).

cpn

Type

string

Bond Radar Data Wizard Field

Coupon

Coupon.

cpnType

Type

string

Bond Radar Data Wizard Field

Coupon Type

Coupon Type – Fixed or Floating.

cuc

Type

boolean

Bond Radar Data Wizard Field

CUC

Clean up call is a provision that enables an issuer to redeem that part of a deal that remains after a tender offer or other operation that reduces the original outstanding amount.

currency

Type

string

Bond Radar Data Wizard Field

Currency

Currency denomination of deal.

dealId

Type

Integer

Bond Radar Data Wizard Field

Deal ID

Bond Radar unique ID.

dealType

Type

String

Bond Radar Data Wizard Field

Tap: Increase

Original deal or an increase/tap.

exchange

Type

{
  "amount":   number,
  "converted": {
    "usd": number
  }
}

Bond Radar Data Wizard Field

Exchange

exchange - Where a security has been issued in exchange for an existing security being redeemed by the issuer.

converted - The equivalent exchange amount in US dollars.

firstCallDate

Type

string(Date)

Bond Radar Data Wizard Field

First Call Date

The call date is the date on which a bond can be redeemed before maturity.

fpr

Type

number

Bond Radar Data Wizard Field

Re-Offer

Fixed Price Reoffer, this is the price at which the lead managers sell the deal to investors.

fxRate

Type

{
  "usd": number
}

Bond Radar Data Wizard Field

FX rate

Currency denomination FX rate vs specified currency.

gov

Type

string

Bond Radar Data Wizard Field

N/A

Gov’t - Spread at pricing to Government bond benchmark (for EM region only).

grade

Type

string(Enum: INVESTMENT, HIGH_YIELD, SUB_INVESTMENT, UNRATED)

Bond Radar Data Wizard Field

Rating of the bond.

green

Type

boolean

Bond Radar Data Wizard Field

Green

Capital raising and investment for new and existing projects with environmental benefits.

holdCo

Type

boolean

Bond Radar Data Wizard Field

HoldCo

An abbreviation for holding company, which is an issuer that exercises control over one or more other companies. See [Opco].

leagueTableEligible

Type

boolean

Bond Radar Data Wizard Field

LT eligible

The deal is league table eligible.

market

Type

string(Enum: EM, HG)

Bond Radar Data Wizard Field

EM – Emerging Market (CEEMA, LATAM, Asia (ex Japan)).
HG – High Grade Market (Western Europe, North America, Japan and Australasia).

maturity

Type

string(Date)

Bond Radar Data Wizard Field

Maturity

Maturity date of deal.

mwc

Type

boolean

Bond Radar Data Wizard Field

MWC

A make-whole call is a type of call provision in a bond allowing the borrower to pay off remaining debt early. The borrower has to make a lump sum payment to the holder derived from an earlier agreed upon formula based on the net present value (NPV) of future coupon payments not paid because of the call.

nominal

Type

{
  "amount":   number,
  "converted": {
    "usd": number
  }
}

Bond Radar Data Wizard Field

Volume (m), USD equivalent

amount - Size of deal.

converted - The equivalent nominal amount in US dollars. (formula: Volume*re-offer/100*FX Rate)

nominalWithExchange

Type

{
  "amount":   number,
  "converted": {
    "usd": number
  }
}

Bond Radar Data Wizard Field

Not Included

amount - Total of nominal and exchange.

converted - The equivalent nominal and exchange amount in US dollars.

nominalWithRetained

Type

{
  "amount":   number,
  "converted": {
    "usd": number
  }
}

Bond Radar Data Wizard Field

Not Included

amount - Total of nominal and retained.

converted - The equivalent nominal and retained amount in US dollars.

nonBullet

Type

string

Bond Radar Data Wizard Field

Not Included

The deal has a call date e.g. an option for the issuer to redeem the bonds prior to their final maturity. In the textbox we write the format of the deal, if it was a 7-year deal with a call at 3 years we would write '7NC3'.

only144a

Type

boolean

Bond Radar Data Wizard Field

Format

Deal is sold in the US for US investors.

onlyRegS

Type

boolean

Bond Radar Data Wizard Field

Format

Deal is sold outside of the US for international investors.

opCo

Type

boolean

Bond Radar Data Wizard Field

OpCo

An abbreviation for operating company, which is an issuer that is the primary corporation carrying on active business and, in most cases, 100% owned by the holding company’. See [HoldCo].

perpetual

Type

boolean

Bond Radar Data Wizard Field

Maturity

A bond based on a fixed income security with no maturity date.

pref

Type

boolean

Bond Radar Data Wizard Field

Not Included

A preferred stock is a class of stock that is granted certain rights that differ from common stock. Namely, preferred stock often possess higher dividend payments, and a higher claim to assets in the event of liquidation. In addition, preferred stock have a callable feature, which means that the issuer has the right to redeem the shares at a predetermined price and date as indicated in the prospectus. In many ways, preferred stock shares similar characteristics to bonds, and because of this are sometimes referred to as hybrid securities.

(for HG region only)

premium

Type

{
  "earlyTrading":   string,
  "nip":            string,
}

Bond Radar Data Wizard Field

NIP (New issue premium) (Early Trading, Gov’t, Swap and Yield not included on the Data Wizard output)

Early Trading - Early trading level of deal.

NIP - New issue premium, the premium at which the deal priced relative to the issuers curve.

(for EM region only)

priceEvolution

Type

{
  "date":         string(Datetime),
  "value":        string
}

Bond Radar Data Wizard Field

IPTs (Initial price thoughts)/IPG (Initial price guidance)

History of the deal spread/yield from IPTs, Guidance and Final terms.

pricingDate

Type

string(Date)

Bond Radar Data Wizard Field

Date

Date of pricing.

pricingTime

Type

string(Time)

Bond Radar Data Wizard Field

Not Included

Time of pricing.

ranking

Type

string

Bond Radar Data Wizard Field

Ranking

IG – Investment Grade.

HY – High Yield Grade.

Crossover – Refers to issuers that have split IG/HY ratings.

NR – Not Rated.

rating

Type

string

Bond Radar Data Wizard Field

Bond ratings

Bond ratings.

regSAnd144a

Type

boolean

Bond Radar Data Wizard Field

Format

Deal sold globally, with 144a provision for US investors and RegS for international.

retained

Type

{
  "amount":   number,
  "converted": {
    "usd": number
  }
}

Bond Radar Data Wizard Field

amount - A security is issued but not wholly distributed on the primary settlement date.

converted - The equivalent retained amount in US dollars.

secondary

Type

{
  "amount":   number,
  "converted": {
    "usd": number
  }
}

Bond Radar Data Wizard Field

Format

Trading level at secondary market.

secRegistered

Type

boolean

Bond Radar Data Wizard Field

Format

Deal registered with Securities and Exchange Commission (SEC).

section3a2

Type

boolean

Bond Radar Data Wizard Field

Format

Section 3(a)(2) of the Securities Act of 1933 (the “Securities Act”) exempts from registration under the Securities Act any security issued or guaranteed by a bank.

seniorNonPreferred

Type

boolean

Bond Radar Data Wizard Field

Senior Non-Preferred

A class of debt that is explicitly senior – it sits above Tier 2 but below other senior liabilities in the creditor hierarchy stack.

seniorPreferred

Type

boolean

Bond Radar Data Wizard Field

Senior Preferred

Financial obligation that is considered more important or has priority over other types of debt.

social

Type

boolean

Bond Radar Data Wizard Field

Social

An issue where a commitment is made to pay for improved social, climatic or housing objectives from the proceeds of a transaction.

stats

Type

{
  "stats":          string,
  "finalBooks":     number,
  "finalAccounts":  number,
  "investorType": {
    string:   number
    ...
  }
  "geography": {
    string:   number
    ...
  }
}

Bond Radar Data Wizard Field

Stats

Deal book stats - Geography (%) and Investor Type (%).

subordinated

Type

boolean

Bond Radar Data Wizard Field

Subordinated

A lower class of debt that in the event of the default doesn’t get paid out until all the senior debtholders were paid in full.

sustainable

Type

boolean

Bond Radar Data Wizard Field

Sustainable

Proceeds will be exclusively applied to re-finance a combination of both Green and Social projects.

swap

Type

string

Bond Radar Data Wizard Field

Spread

Spread at pricing to mid-swap or other reference rate. (for EM region only)

spread

Type

string

Bond Radar Data Wizard Field

Spread

Spread at pricing to mid-swap or other reference rate. (for HG region only)

tier

Type

string(Enum: RT1, AT1, T1, T2)

Bond Radar Data Wizard Field

Tier

Priced deal tier.

Tier 1 (T1) - The primary funding source of the bank. Typically, it holds nearly all of the bank’s accumulated funds. These funds are generated specifically to support banks when losses are absorbed so that regular business functions do not have to be shut down.

Tier 2 (T2) - Tier 2 capital includes hybrid capital instruments, loan-loss and revaluation reserves as well undisclosed reserves. This capital operates as supplementary funding because it is not as reliable as the first tier.

Additional Tier 1 (AT1) - Contingent Convertible capital instruments (Co-Co bonds) which may be permanently or temporarily written down.

Restrictive Tier (RT1) - Instruments are junior subordinated debt securities issued by insurers that can qualify as capital under current European insurance regulation (Solvency II). To qualify as Tier 1 capital, the instruments need to be perpetual with at least a five-year non-call clause, have non-cumulative fully optional coupons and a contractual trigger to principal write-down or equity conversion.

yield

Type

string

Bond Radar Data Wizard Field

Yield

The return (yield to maturity) an investor realises on a bond.

total

Type

{
    "exchange": {
      "amount":   number,
      "converted": {
        "usd": number
      }
    }
    "nominal": {
          "amount":   number,
          "converted": {
            "usd": number
          }
      }
    "nominalWithExchange": {
          "amount":   number,
          "converted": {
            "usd": number
          }
      }
    "secondary": {
          "amount":   number,
          "converted": {
            "usd": number
          }
      }
}

Bond Radar Data Wizard Field

Same definition for [nominal], [exchange] and [nominalWithExchange] but this section only applies to a tap of the original deal. (for EM region only)

total

Type

{
    "exchange": {
      "amount":   number,
      "converted": {
        "usd": number
      }
    }
    "retained": {
          "amount":   number,
          "converted": {
            "usd": number
          }
      }
    "nominalWithRetained": {
          "amount":   number,
          "converted": {
            "usd": number
          }
      }
    "secondary": {
          "amount":   number,
          "converted": {
            "usd": number
          }
      }
}

Bond Radar Data Wizard Field

Same definition for [nominal], [retained] and [nominalWithRetained] but this section only applies to a tap of the original deal. (for HG region only)


1. Data available for each tranche