CUSIP Lookup API

Copyimport requests

API_KEY = "yex_sk_360ece523dcc8d4d93aa2331e698b0c8"
BASE    = "https://api-cusip.yieldexchange.ca"

def lookup(query: str, limit: int = 10, status: str = "active"):
    resp = requests.get(
        f"{BASE}/api/lookup",
        params={"q": query, "limit": limit, "status": status},
        headers={"X-API-Key": API_KEY},
        timeout=5,
    )
    resp.raise_for_status()
    return resp.json()["results"]

# Typeahead: called on each keystroke
for bond in lookup("1350"):
    print(f"{bond['cusip']}  {bond['issuer_name']}  mat={bond['maturity_date']}")

Copyconst API_KEY = "yex_sk_360ece523dcc8d4d93aa2331e698b0c8";
const BASE    = "https://api-cusip.yieldexchange.ca";

/**
 * Typeahead lookup — wire to an input's `oninput` handler with debounce.
 * @param {string} query - partial CUSIP, ISIN, or issuer name
 * @returns {Promise<BondRecord[]>}
 */
async function lookupBond(query, limit = 10, status = "active") {
  const url = new URL(`${BASE}/api/lookup`);
  url.searchParams.set("q", query);
  url.searchParams.set("limit", limit);
  url.searchParams.set("status", status);

  const res = await fetch(url, {
    headers: { "X-API-Key": API_KEY },
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const data = await res.json();
  return data.results;
}

// Debounce helper
function debounce(fn, ms) {
  let timer;
  return (...args) => { clearTimeout(timer); timer = setTimeout(() => fn(...args), ms); };
}

// Wire to input
const input = document.querySelector("#cusip-search");
input.addEventListener("input", debounce(async (e) => {
  if (e.target.value.length < 2) return;
  const results = await lookupBond(e.target.value);
  // render results …
}, 150));

Copyinterface PriceRecord {
  price_date:   string;
  mid_price:    number | null;
  yield_mid:    number | null;
  g_spread_bps: number | null;
}

interface BondRecord {
  id:                     number;
  cusip:                  string | null;
  isin:                   string | null;
  issuer_name:            string;
  issuer_type:            "GOC" | "PROV" | "FIN" | "CORP";
  province_code:          string | null;
  coupon_rate:            number | null;
  maturity_date:          string | null;
  issue_date:             string | null;
  currency:               string;
  amount_outstanding_cad: number | null;
  confidence_score:       number;
  source_name:            string;
  latest_price:           PriceRecord | null;
}

interface LookupResponse {
  query:   string;
  status:  string;
  count:   number;
  results: BondRecord[];
}

const API_KEY = "yex_sk_360ece523dcc8d4d93aa2331e698b0c8";
const BASE    = "https://api-cusip.yieldexchange.ca";

async function lookupBond(
  query:  string,
  limit:  number = 10,
  status: string = "active"
): Promise<BondRecord[]> {
  const url = new URL(`${BASE}/api/lookup`);
  url.searchParams.set("q", query);
  url.searchParams.set("limit", String(limit));
  url.searchParams.set("status", status);

  const res = await fetch(url.toString(), {
    headers: { "X-API-Key": API_KEY },
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const data: LookupResponse = await res.json();
  return data.results;
}

Copydef get_bond(identifier: str):
    """Fetch a single bond by CUSIP or ISIN."""
    resp = requests.get(
        f"{BASE}/api/bonds/{identifier.upper()}",
        headers={"X-API-Key": API_KEY},
    )
    if resp.status_code == 404:
        return None
    resp.raise_for_status()
    return resp.json()

bond = get_bond("CA135087T537")
print(bond["cusip"], bond["coupon_rate"], bond["maturity_date"])