Fixed Income API

Quick Start

1. Obtain your API key from the AbsoluteData client portal.
2. Ensure your server IP is whitelisted (contact support if needed).
3. Include the x-api-key header on every request.
4. Use HTTPS only — HTTP requests are rejected.
5. Respect rate limits (see rate limits) to avoid 429 errors.
6. Use cursor-based pagination for large result sets (see Pagination).

Authentication

Every request must include an API key in the x-api-key HTTP header. Unauthenticated requests receive a 401 Unauthorized response.

x-api-key: YOUR_API_KEY

IP Whitelisting

For enhanced security, AbsoluteData supports IP address whitelisting. Once configured, only requests from approved IP ranges are accepted.

Key Expiry

API keys may have an expiration date. Requests made with an expired key receive a 403 ACCESS_DENIED response. Contact support@absolutedata.ai to renew or extend your key.

Base URL

https://api.absolutedata.ai

GET /v1/health

Returns the current health status of the API. Does not require authentication.

curl https://api.absolutedata.ai/v1/health

{
  "status": "healthy",
  "service": "v1"
}

GET /v1/bonds/isin/{isin}

Parameters

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.absolutedata.ai/v1/bonds/isin/US3130B9V234"

{
  "pagination": {
    "page": 1,
    "page_size": 1,
    "total_records": 1,
    "total_pages": 1,
    "has_next": false,
    "next_cursor": null
  },
  "items": [
    {
      "_schema": "bond_reference_data_v1",
      "instrument_identifiers": { "isin": "US3130B9V234", "figi": "BBG020W0CFT3" },
      "issuer": { "issuer_name": "Federal Home Loan Banks", ... },
      "terms_and_conditions": { ... },
      "coupon": { ... },
      "third_party_identifiers": { ... }
    }
  ]
}

GET /v1/bonds/new-issuances

Returns bond reference data for recently announced instruments. Always queries a fixed ±7 day window from today, sorted by announcement date descending. Apply attribute filters within this window.

Parameters

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.absolutedata.ai/v1/bonds/new-issuances"

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.absolutedata.ai/v1/bonds/new-issuances?currency=USD&page_size=50"

POST /v1/bonds/search

Supports multi-value array filters (up to 25 values per field) for fields such as currency, country, sector, bond type, coupon type, and seniority. At least one filter is required.

Parameters

curl -X POST "https://api.absolutedata.ai/v1/bonds/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": ["USD", "EUR"],
    "bond_type": ["Fixed"],
    "coupon_rate_min": 4.0,
    "maturity_date_start": "2030-01-01",
    "page_size": 50
  }'

{
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_records": 1092,
    "total_pages": 22,
    "has_next": true,
    "next_cursor": "eyJ..."
  },
  "items": [
    {
      "_schema": "bond_reference_data_v1",
      "instrument_identifiers": { "isin": "US48130KTM98" },
      ...
    }
  ]
}

POST /v1/bonds/batch

Retrieve multiple bonds by ISIN in a single request. Results are bucketed into items (found), not_found, and invalid.

Parameters

curl -X POST "https://api.absolutedata.ai/v1/bonds/batch" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "isins": ["US48130KTM98", "US3130B9VY35", "US0000000000", "BADISIN"]
  }'

Response Structure

{
  "summary": { "found": 2, "not_found": 1, "invalid": 1 },
  "items": [
    {
      "_schema": "bond_reference_data_v1",
      "instrument_identifiers": { "isin": "US48130KTM98", "figi": "BBG00N1P0GZ7" },
      "issuer": {
        "issuer_name": "JPMORGAN CHASE & CO",
        "issuer_type": "Corporate",
        "lei": "8I5DZWZKVSZI1NUHU748",
        "domicile": { "country_of_incorporation": "US" },
        "classification": { "sector": "Financial" }
      },
      "terms_and_conditions": {
        "announcement_date": "2024-01-15",
        "issue_date": "2024-01-22",
        "maturity_date": "2029-01-22",
        "issue_currency": "USD",
        "amount_issued": "1500000000",
        "bond_type": "Fixed",
        "seniority": "SENIOR"
      },
      "coupon": {
        "coupon_type": "Fixed",
        "issuance_coupon": "4.750",
        "interest_payment_frequency": "Semi-Annual"
      }
    }
  ],
  "not_found": ["US0000000000"],
  "invalid": [
    { "input": "BADISIN", "reason": "Invalid ISIN format." }
  ]
}

Pagination

The API uses cursor-based pagination. Every paginated response includes a pagination object with full metadata.

Pagination Response Object

Parameters

# Step 1: First request — no cursor needed
GET /v1/bonds/new-issuances?currency=USD&coupon_type=Fixed&page_size=10

# Step 2: Response includes next_cursor → pass it in the next request
GET /v1/bonds/new-issuances?currency=USD&coupon_type=Fixed
    &page_size=10&next_cursor=eyJhbm5vdW5jZW1lbnR...

# Step 3: Keep repeating until has_next is false

Your Plan & Rate Limits

Each API key has configurable usage limits. When any limit is exceeded, the API returns 429 Too Many Requests.

Error Responses

All errors follow a standard JSON structure for consistent client-side handling.

{
  "error": {
    "type": "Bad Request",
    "code": "INVALID_PARAMETER",
    "message": "Human-readable description",
    "field": "parameter_name",
    "request_id": "uuid"
  }
}

Error Codes

Response Headers

Code Examples — cURL

Single Bond Lookup

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.absolutedata.ai/v1/bonds/isin/US3130B9V234"

New Issuances with Filters

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.absolutedata.ai/v1/bonds/new-issuances?currency=USD&coupon_type=Fixed&page_size=20"

POST Search

curl -X POST "https://api.absolutedata.ai/v1/bonds/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": ["USD", "EUR"],
    "bond_type": ["Fixed"],
    "coupon_rate_min": 4.0,
    "maturity_date_start": "2030-01-01",
    "page_size": 50
  }'

Batch Lookup

curl -X POST "https://api.absolutedata.ai/v1/bonds/batch" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "isins": ["US48130KTM98", "US3130B9VY35", "INVALID123"]
  }'

Code Examples — Python

Pagination (Fetch All Pages)

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.absolutedata.ai"
HEADERS = {"x-api-key": API_KEY}

def fetch_all_bonds(filters: dict) -> list:
    all_bonds = []
    params = dict(filters)
    while True:
        resp = requests.get(
            f"{BASE_URL}/v1/bonds/new-issuances",
            headers=HEADERS, params=params
        )
        resp.raise_for_status()
        data = resp.json()
        all_bonds.extend(data["items"])
        pagination = data["pagination"]
        print(f"  Page {pagination['page']}: {len(data['items'])} bonds")
        if not pagination["has_next"]:
            break
        params["next_cursor"] = pagination["next_cursor"]
    return all_bonds

bonds = fetch_all_bonds({"currency": "USD", "coupon_type": "Fixed"})
print(f"Total: {len(bonds)} bonds")

POST Search

import requests

resp = requests.post(
    "https://api.absolutedata.ai/v1/bonds/search",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "currency": ["USD", "EUR"],
        "bond_type": ["Fixed"],
        "coupon_rate_min": 4.0,
        "maturity_date_start": "2030-01-01",
        "page_size": 50
    }
)
data = resp.json()
print(f"Found {data['pagination']['total_records']} bonds")

Batch Lookup

import requests

resp = requests.post(
    "https://api.absolutedata.ai/v1/bonds/batch",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"isins": ["US48130KTM98", "US3130B9VY35", "INVALID123"]}
)
data = resp.json()
print(f"Found: {data['summary']['found']}, "
      f"Not found: {data['summary']['not_found']}, "
      f"Invalid: {data['summary']['invalid']}")

Client Class

import os, requests

class AbsoluteDataClient:
    BASE = "https://api.absolutedata.ai"

    def __init__(self, api_key=None):
        self.session = requests.Session()
        self.session.headers["x-api-key"] = api_key or os.environ["ABSOLUTEDATA_API_KEY"]

    def get_bond(self, isin):
        r = self.session.get(f"{self.BASE}/v1/bonds/isin/{isin}")
        r.raise_for_status()
        items = r.json().get("items", [])
        return items[0] if items else None

    def new_issuances(self, **filters):
        all_items = []
        params = {k: v for k, v in filters.items() if v is not None}
        while True:
            r = self.session.get(f"{self.BASE}/v1/bonds/new-issuances", params=params)
            r.raise_for_status()
            data = r.json()
            all_items.extend(data.get("items", []))
            if not data["pagination"]["has_next"]:
                break
            params["next_cursor"] = data["pagination"]["next_cursor"]
        return all_items

    def search(self, body):
        r = self.session.post(f"{self.BASE}/v1/bonds/search", json=body)
        r.raise_for_status()
        return r.json()

    def batch(self, isins):
        r = self.session.post(f"{self.BASE}/v1/bonds/batch", json={"isins": isins})
        r.raise_for_status()
        return r.json()

Code Examples — JavaScript / Node.js

const axios = require("axios");

const client = axios.create({
  baseURL: "https://api.absolutedata.ai",
  headers: { "x-api-key": process.env.ABSOLUTEDATA_API_KEY },
});

// Single bond lookup
async function getBondByISIN(isin) {
  const { data } = await client.get(`/v1/bonds/isin/${isin}`);
  return data.items[0] ?? null;
}

// Paginated fetch
async function fetchAllBonds(filters) {
  const allBonds = [];
  let nextCursor = null;
  do {
    const params = { ...filters };
    if (nextCursor) params.next_cursor = nextCursor;
    const { data } = await client.get("/v1/bonds/new-issuances", { params });
    allBonds.push(...data.items);
    nextCursor = data.pagination.has_next ? data.pagination.next_cursor : null;
  } while (nextCursor);
  return allBonds;
}

// Advanced search
async function searchBonds(body) {
  const { data } = await client.post("/v1/bonds/search", body);
  return data;
}

// Batch lookup
async function batchLookup(isins) {
  const { data } = await client.post("/v1/bonds/batch", { isins });
  return data;
}