Government and corporate bonds
curl --request POST \
--url https://terrapinfinance.com/api/v1/bond_reference \
--header 'Accept: <accept>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"isins": [
"XS2724510792"
]
}
'{
"data": [
{
"asset_class": "medium-term note",
"cfi_code": "DTFUFB",
"composite_issue_rating": "BBB+",
"composite_issuer_rating": "BBB",
"country": "Greece",
"coupon": 5.875,
"coupon_frequency": 1,
"currency": "EUR",
"figi": "BBG01K89S0G8",
"first_coupon_date": "2024-11-28",
"handle": null,
"industry_group": "banks",
"integral_multiple": 100000,
"interest_accrual_convention": "act/act (ICMA)",
"interest_accrual_date": "2023-11-28",
"interest_type": "variable rate",
"is_144a": true,
"is_callable": true,
"is_covered": null,
"is_green": null,
"is_inflation_linked": null,
"is_outstanding": true,
"is_puttable": false,
"is_regs": true,
"isin": "XS2724510792",
"issue_date": "2023-11-28",
"issue_rating_group": "investment_grade",
"issued_amount": 500000000,
"issuer_name": "EUROBANK SA",
"issuer_rating_group": "investment_grade",
"issuer_type": "corporate",
"lei": "213800KGF4EFNUQKAT69",
"lei_direct_parent": "JEUVK5RWVJEN8W0C9M24",
"lei_ultimate_parent": "JEUVK5RWVJEN8W0C9M24",
"maturity_date": "2029-11-28",
"maturity_type": "fixed",
"minimum_denomination": 100000,
"name": "EUROBANK SA FRN 2029",
"rank": "senior unsecured",
"registration_type": "bearer",
"sector": "financials",
"ticker": "EUROB V5.875 11/28/29 EMTN"
}
],
"total": 1
}Reference Data
Get full government and corporate bond reference data for a given set of ISINs.
curl --request POST \
--url https://terrapinfinance.com/api/v1/bond_reference \
--header 'Accept: <accept>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"isins": [
"XS2724510792"
]
}
'{
"data": [
{
"asset_class": "medium-term note",
"cfi_code": "DTFUFB",
"composite_issue_rating": "BBB+",
"composite_issuer_rating": "BBB",
"country": "Greece",
"coupon": 5.875,
"coupon_frequency": 1,
"currency": "EUR",
"figi": "BBG01K89S0G8",
"first_coupon_date": "2024-11-28",
"handle": null,
"industry_group": "banks",
"integral_multiple": 100000,
"interest_accrual_convention": "act/act (ICMA)",
"interest_accrual_date": "2023-11-28",
"interest_type": "variable rate",
"is_144a": true,
"is_callable": true,
"is_covered": null,
"is_green": null,
"is_inflation_linked": null,
"is_outstanding": true,
"is_puttable": false,
"is_regs": true,
"isin": "XS2724510792",
"issue_date": "2023-11-28",
"issue_rating_group": "investment_grade",
"issued_amount": 500000000,
"issuer_name": "EUROBANK SA",
"issuer_rating_group": "investment_grade",
"issuer_type": "corporate",
"lei": "213800KGF4EFNUQKAT69",
"lei_direct_parent": "JEUVK5RWVJEN8W0C9M24",
"lei_ultimate_parent": "JEUVK5RWVJEN8W0C9M24",
"maturity_date": "2029-11-28",
"maturity_type": "fixed",
"minimum_denomination": 100000,
"name": "EUROBANK SA FRN 2029",
"rank": "senior unsecured",
"registration_type": "bearer",
"sector": "financials",
"ticker": "EUROB V5.875 11/28/29 EMTN"
}
],
"total": 1
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Specify text/csv if you would like to receive a CSV file.
application/json, text/csv Body
International Securities Identification Number (ISIN), unique 12-character code for the security.
12Response
Reference data
List of response data objects, often capped to 1000.
Show child attributes
Show child attributes
Asset class:
structured product: Structured debt instrument.medium-term note: Bond with medium-term maturity.money market: Short-term debt instrument.bond: Standard debt security.asset-backed security: Securitized debt backed by assets.mortgage-backed security: Securitized debt backed by mortgages.convertible note: Can be converted to equity.
bond, convertible note, bond with warrants attached, medium-term note, structured product, mortgage-backed security, asset-backed security, depository receipt on debt instruments, money market Classification of Financial Instruments (CFI) code:
The CFI code is a six-letter code that classifies a financial instrument by its type and key features (e.g., fixed/floating rate, registered/bearer, secured/unsecured).
"DTFUFB"
Composite rating of the issue.
AAA, AA+, AA, AA-, A+, A, A-, BBB+, BBB, BBB-, BB+, BB, BB-, B+, B, B-, CCC+, CCC, CCC-, CC, C, D Composite rating of the issuer.
AAA, AA+, AA, AA-, A+, A, A-, BBB+, BBB, BBB-, BB+, BB, BB-, B+, B, B-, CCC+, CCC, CCC-, CC, C, D Country of issuing entity:
Examples:
Germany: Country of issue is Germany.United Kingdom: Country of issue is United Kingdom.United States of America: Country of issue is United States of America.
"Germany"
Country code of issuing entity (ISO 3166-1 alpha-2 country codes):
"DE"
Interest rate or coupon of the bond.
Number of coupon payments per year.
x >= 0Bond currency, 3-letter ISO 4217 code.
3"EUR"
Financial Instrument Global Identifier (FIGI), a unique 12-character alphanumeric code for financial instruments.
12"BBG01K89S0G8"
Date in ISO-8601 format (YYYY-MM-DD) of the first coupon payment.
Bond handles - predefined categories for filtering bonds by type and characteristics.
Available options by country:
German Bonds (DE):
de_bund: German long-term government bonds (Bundesanleihen).de_bobl: German medium-term government bonds (Bundesobligationen).de_schatz: German short-term government bonds (Bundesschatzanweisungen).de_bubill: German short-term government bills (Bundesschatzanweisungen).de_ilb: German inflation-linked government bonds.de_green: German green government bonds.
UK Bonds (GB):
uk_gilt: UK government bonds (Gilts).uk_green_gilt: UK green government bonds.uk_il_gilt: UK inflation-linked government bonds.uk_bill: UK short-term government bills.
French Bonds (FR):
fr_oat: French long-term government bonds (Obligations Assimilables du Trésor).fr_oatei: French inflation-linked government bonds (OATi).fr_oati: French inflation-linked government bonds (alternative naming).fr_btf: French short-term government bills (Bons du Trésor à taux fixe).fr_bond: French government bonds (general category).
Dutch Bonds (NL):
nl_dsl: Dutch government loans (Dutch State Loans).nl_dtc: Dutch short-term government securities (Dutch Treasury Certificates).
Canadian Bonds (CA):
ca_bond: Canadian government bonds.ca_bill: Canadian short-term government bills.ca_cmb: Canadian mortgage-backed securities (Canada Mortgage Bonds).ca_ulbond: Canadian ultra-long government bonds (>30 years).ca_rrbond: Canadian inflation-linked bonds (Real Return Bonds).ca_green: Canadian green government bonds.
Swiss Bonds (CH):
ch_bond: Swiss government bonds.
Czech Bonds (CZ):
cz_bond: Czech government bonds.cz_bill: Czech short-term government bills.cz_fr_bond: Czech floating-rate government bonds.cz_zr_bond: Czech zero-coupon government bonds.
Spanish Bonds (ES):
es_bill: Spanish short-term government bills.es_bond: Spanish government bonds.es_ilb_bond: Spanish inflation-linked government bonds.es_zr_bond: Spanish zero-coupon government bonds.es_vr_bond: Spanish variable-rate government bonds.
Chinese Bonds (CN):
cn_bill: Chinese government short-term bills.cn_bond: Chinese government bonds.cn_bond_vr: Chinese government variable-rate bonds.cn_bond_zr: Chinese government zero-coupon bonds.
US Treasury Bonds (US):
us_tips: US Treasury Inflation-Protected Securities (TIPS).us_frn: US Treasury Floating Rate Notes (FRN).us_bill: US Treasury Bills (short-term securities).us_cmb: US Treasury Cash Management Bills (CMB).us_note: US Treasury Notes (medium-term securities).us_bond: US Treasury Bonds (long-term securities).
de_bobl, de_bund, de_schatz, de_ilb, de_green, de_bubill, uk_gilt, uk_green_gilt, uk_il_gilt, uk_bill, fr_btf, fr_oat, fr_oatei, fr_oati, nl_dsl, nl_dtc, ca_bill, ca_cmb, ca_bond, ca_ulbond, ca_rrbond, ca_green, ch_bond, cz_bill, cz_bond, cz_fr_bond, cz_zr_bond, es_bill, es_bond, es_ilb_bond, es_zr_bond, es_vr_bond, cn_bond, cn_bill, cn_bond_vr, cn_bond_zr, us_tips, us_frn, us_bill, us_cmb, us_note, us_bond Industry group of the issuer.
"banks"
Integral multiple for bond denominations.
Day count convention for interest accrual:
act/act (ICMA): Uses actual number of days in period and year.30/360: Assumes 30 days per month, 360 days per year.act/360: Uses actual days in period, 360 days per year.act/365: Uses actual days in period, 365 days per year.act/act: Uses actual number of days in period and year.act/act (ISDA): ISDA convention for actual/actual.act/act (AFB): AFB convention for actual/actual.
30/360, 30/365, act/360, act/365, act/act, act/act (AFB), act/act (ISDA), act/act (ICMA) Date in ISO-8601 format (YYYY-MM-DD) from which interest accrues.
Type of interest:
zero rate / discount rate: A bond that does pay or accrue interest.fixed rate: Pays a fixed coupon throughout the bond's life.variable rate: Coupon varies with a reference rate (e.g., SOFR, SONIA, Inflation indexes, etc.).misc.: Miscellaneous interest types.payment in kind: Interest paid in additional securities.dividend payments: Interest paid as dividends.cash payment: Interest paid in cash.at maturity: Interest paid at maturity.
fixed rate, zero rate / discount rate, cab, cab-to-fixed, at maturity, variable rate, step rate, term rate, cash payment, payment in kind, fixed interest payments, dividend payments, variable interest payments, no payments, misc. Whether the bond is Rule 144A compliant,can be sold to qualified US institutional buyers.
Whether the bond is callable before maturity.
Whether the bond is secured by collateral.
Whether the bond is a green bond.
Whether the bond is inflation-linked, its payments are linked to an inflation index.
Whether the bond is currently outstanding, has not matured, been called, or otherwise redeemed.
Whether the bond is puttable before maturity.
Whether the bond is Regulation S (RegS) compliant, can be sold to non-US investors.
International Securities Identification Number (ISIN), unique 12-character code for the security.
12"CH0282526133"
Date the bond was issued in ISO-8601 format (YYYY-MM-DD).
Issue rating group, based on TP composite long-term ratings:
investment_grade: High credit quality (BBB- and above)high_yield: Lower credit quality (BB+ and below)
investment_grade, high_yield Total amount issued (face value) in the bond's currency.
Name of the issuing entity.
"EUROBANK SA"
Issuer rating group, based on TP composite long-term ratings:
investment_grade: High credit quality (BBB- and above)high_yield: Lower credit quality (BB+ and below)
investment_grade, high_yield corporate, government, municipal, state, government_linked, international_organization Legal Entity Identifier (LEI) of the issuer:
A 20-character, alpha-numeric code based on the ISO 17442 standard used to uniquely identify legal entities in financial transactions. Most LEIs follow this structure, but there are exceptions that use local national standards.
20"213800KGF4EFNUQKAT69"
LEI of the direct parent of the issuer:
A 20-character, alpha-numeric code based on the ISO 17442 standard used to uniquely identify legal entities in financial transactions. Most LEIs follow this structure, but there are exceptions that use local national standards.
20"JEUVK5RWVJEN8W0C9M24"
LEI of the ultimate parent of the issuer:
A 20-character, alpha-numeric code based on the ISO 17442 standard used to uniquely identify legal entities in financial transactions. Most LEIs follow this structure, but there are exceptions that use local national standards.
20"JEUVK5RWVJEN8W0C9M24"
Date when the bond principal is due to be repaid in ISO-8601 format (YYYY-MM-DD).
Maturity type:
fixed: Principal repaid at maturity.amortized: Principal repaid gradually before maturity.perpetual: No maturity date; principal is never repaid.extendible: Maturity date can be extended by issuer or holder.
fixed, amortized, perpetual, extendible Minimum denomination in which the bond can be purchased.
Full name of the bond.
"EUROBANK SA FRN 2029"
Seniority or rank of the bond:
senior unsecured: Highest priority among unsecured debt.senior: Standard senior debt.secured: Backed by collateral.government / state: Government or state-issued debt.subordinated: Lower priority, paid after senior debt.supranational: Issued by supranational entities.senior subordinated: Senior within subordinated class.junior secured: Junior secured debt.junior subordinated: Junior within subordinated class.junior: Junior debt.
supranational, government / state, secured, senior, junior, subordinated, senior unsecured, junior secured, senior subordinated, junior subordinated, mezzanine Registration type:
bearer: Ownership is determined by physical possession.registered: Ownership is recorded and tracked by issuer or agent.misc.: Miscellaneous registration types.bearer / registered: Hybrid registration type.
bearer, registered, bearer / registered, misc. Sector of the issuer.
communication services, consumer discretionary, consumer staples, education, energy, financials, health care, industrials, information technology, materials, real estate, utilities Bond ticker symbol.
"EUROB V5.875 11/28/29 EMTN"
Total number of results in the database that match the query filters.