{
  "schema": "v1",
  "base": "https://dirigon.com/v1",
  "auth": "X-API-KEY header",
  "notes": [
    "Marks are fair value / cost from the filed Schedule of Investments.",
    "Money fields are $ millions.",
    "Identify funds by CIK. Ticker is extra when the fund is listed.",
    "If blocked is true on a credit, skip it for comparisons."
  ],
  "resources": [
    {
      "resource": "coverage",
      "help": "What is in the latest snapshot: fund count, credit count, total fair value.",
      "fields": []
    },
    {
      "resource": "issuers",
      "help": "Find a credit. Search by name or id. sort=holders or fv for rankings.",
      "fields": [
        {
          "name": "issuer_id",
          "help": "Credit id (ISS-######). Use this to open a name."
        },
        {
          "name": "display_name",
          "help": "Credit name."
        },
        {
          "name": "blocked",
          "help": "True when the name is disputed (more than one credit may share the label). Skip it for comparisons."
        },
        {
          "name": "identity",
          "help": "ok means this issuer_id is not blocked. related[] is family (holdco/OpCo/pref), not a merge. Do not blend marks across family."
        },
        {
          "name": "aliases",
          "help": "Other ids this credit has used."
        },
        {
          "name": "superseded_by",
          "help": "Replacement id if this one was split. Null if current."
        },
        {
          "name": "n_holders",
          "help": "How many funds print this name."
        },
        {
          "name": "total_fv_m",
          "help": "Fair value across holders, $ millions."
        }
      ]
    },
    {
      "resource": "filers",
      "help": "Fund profile. Search by name, ticker, or CIK.",
      "fields": [
        {
          "name": "cik",
          "help": "SEC CIK of the fund. This is how you identify a filer."
        },
        {
          "name": "name",
          "help": "Fund name."
        },
        {
          "name": "ticker",
          "help": "Listed ticker when there is one (e.g. ARCC)."
        },
        {
          "name": "manager",
          "help": "Adviser."
        },
        {
          "name": "period_end",
          "help": "Schedule of Investments period (YYYY-MM-DD)."
        },
        {
          "name": "gate",
          "help": "Latest filing is in the product."
        },
        {
          "name": "n_positions",
          "help": "Lines on the fund's SOI tape."
        },
        {
          "name": "total_fv_m",
          "help": "Fair value across holders, $ millions."
        },
        {
          "name": "form",
          "help": "10-Q or 10-K."
        },
        {
          "name": "filing_url",
          "help": "Link to the SEC filing."
        }
      ]
    },
    {
      "resource": "positions",
      "help": "The fund's Schedule of Investments tape, line by line.",
      "fields": [
        {
          "name": "issuer_id",
          "help": "Credit id (ISS-######). Use this to open a name."
        },
        {
          "name": "facility_id",
          "help": "Loan / facility id on that filing."
        },
        {
          "name": "cik",
          "help": "SEC CIK of the fund. This is how you identify a filer."
        },
        {
          "name": "period_end",
          "help": "Schedule of Investments period (YYYY-MM-DD)."
        },
        {
          "name": "accession",
          "help": "SEC accession number."
        },
        {
          "name": "filing_url",
          "help": "Link to the SEC filing."
        },
        {
          "name": "filed_at",
          "help": "Date the SEC accepted the filing."
        },
        {
          "name": "company_raw",
          "help": "Company name as printed on the SOI."
        },
        {
          "name": "investment_raw",
          "help": "Investment line as printed on the SOI."
        },
        {
          "name": "security_class",
          "help": "debt or equity."
        },
        {
          "name": "lien",
          "help": "first_lien, second_lien, unsecured, and so on."
        },
        {
          "name": "mark",
          "help": "Fair value / cost, in dollars (1.00 = par)."
        },
        {
          "name": "fv_m",
          "help": "Fair value, $ millions."
        },
        {
          "name": "cost_m",
          "help": "Amortized cost, $ millions."
        },
        {
          "name": "is_pik",
          "help": "True if the coupon is paid-in-kind."
        },
        {
          "name": "non_accrual",
          "help": "True if the fund footnoted this line as non-accrual."
        },
        {
          "name": "funded_status",
          "help": "funded, unfunded_commitment, or partially drawn."
        }
      ]
    },
    {
      "resource": "marks",
      "help": "Every fund that prints this credit, and the mark they filed.",
      "fields": [
        {
          "name": "issuer_id",
          "help": "Credit id (ISS-######). Use this to open a name."
        },
        {
          "name": "cik",
          "help": "SEC CIK of the fund. This is how you identify a filer."
        },
        {
          "name": "filer",
          "help": "Fund name."
        },
        {
          "name": "mark",
          "help": "Fair value / cost, in dollars (1.00 = par)."
        },
        {
          "name": "fv_m",
          "help": "Fair value, $ millions."
        },
        {
          "name": "cost_m",
          "help": "Amortized cost, $ millions."
        },
        {
          "name": "period_end",
          "help": "Schedule of Investments period (YYYY-MM-DD)."
        }
      ]
    },
    {
      "resource": "non_accrual",
      "help": "Lines the fund itself footnoted as non-accrual.",
      "fields": [
        {
          "name": "issuer_id",
          "help": "Credit id (ISS-######). Use this to open a name."
        },
        {
          "name": "cik",
          "help": "SEC CIK of the fund. This is how you identify a filer."
        },
        {
          "name": "filer",
          "help": "Fund name."
        },
        {
          "name": "company",
          "help": "Credit name."
        },
        {
          "name": "cost_m",
          "help": "Amortized cost, $ millions."
        },
        {
          "name": "fv_m",
          "help": "Fair value, $ millions."
        },
        {
          "name": "mark",
          "help": "Fair value / cost, in dollars (1.00 = par)."
        },
        {
          "name": "period",
          "help": "SOI period (YYYY-MM-DD)."
        },
        {
          "name": "security_class",
          "help": "debt or equity."
        }
      ]
    },
    {
      "resource": "clo_tranches",
      "help": "CLO note holder graph. Same tranche_key across CLO CEFs, BDCs, interval funds, and loan CEFs. Off Find Credit.",
      "fields": [
        {
          "name": "tranche_key",
          "help": "CLO note id (deal|class). Same grain as issuer_id, for a tranche holding rather than a borrower."
        },
        {
          "name": "deal",
          "help": "Normalized CLO deal name from the printed cell."
        },
        {
          "name": "klass",
          "help": "Printed class or residual (class_fr, subordinated, equity)."
        },
        {
          "name": "sleeve",
          "help": "equity (residual / sub / preferred) or debt (rated class notes)."
        },
        {
          "name": "n_holders",
          "help": "How many funds print this name."
        },
        {
          "name": "vehicles",
          "help": "Which vehicle types hold this tranche (clo, bdc, interval, loan_cef)."
        },
        {
          "name": "fv_m",
          "help": "Fair value, $ millions."
        },
        {
          "name": "mark_lo",
          "help": "Lowest holder mark (fair value / cost) on the latest books."
        },
        {
          "name": "mark_hi",
          "help": "Highest holder mark on the latest books."
        }
      ]
    }
  ],
  "mcp_tools": [
    {
      "name": "get_coverage",
      "help": "This compile's universe. funds = AG filers (BDCs + interval) plus CLO CEF tape. bdcs / interval / clo split. credits = peeled issuer_id count. total_fv_bn is $ billions; line fv_m is $ millions. meta.compile_id is the snapshot to cite. dictionary[] defines each field."
    },
    {
      "name": "get_issuer",
      "help": "issuer_id (or q= with one hit) opens the credit card: same-loan marks, family, history. q= with many hits is a thin list \u2014 pass issuer_id for the join. No q: most-held names (thin). preset=disagreement = widest same-loan screen. Do not merge family ids. Do not crawl every issuer_id."
    },
    {
      "name": "get_filer",
      "help": "Exact ticker or cik= opens the fund card. q= with many hits is a thin list. sort=fv limit=4 is the Allocator starter. get_sector q=software view=funds ranks software books. Chips: BCRED, OCIC, HLEND, ADS, ASIF."
    },
    {
      "name": "get_positions",
      "help": "SOI tape for one fund. Pass cik from get_filer. Default 100 lines, max 500. n is the full tape. q filters company_raw. cursor=next_cursor pages. Filter q= before paging a large book."
    },
    {
      "name": "get_disagreement",
      "help": "The disagreement screen: widest same-loan spreads on the latest common period (4+ holders, 15pt+). Stale interval marks do not rank. Pass issuer_id to get_issuer for the card. cursor pages."
    },
    {
      "name": "get_non_accrual",
      "help": "Lines the funds footnoted as non-accrual. Optional cik or q=credit name. Default 50. cursor pages."
    },
    {
      "name": "get_sector",
      "help": "Sectors page. No q: universe mix with denominator_fv_m. q=software|healthcare|industrials. view=credits|funds. Software fund ranking uses membership software_pct. Other sectors use printed mix. sort=fv|pct. cursor pages. cik= one fund's mix."
    },
    {
      "name": "get_clo_tranche",
      "help": "CLO note holder graph. q= or tranche_key= opens one deal|class (holders, marks, vehicles). No q: cross-vehicle connections (BDC / interval / loan_cef sleeves that share a CEF tranche). view=books is per-CEF field fill vs the canonical standard. Off Find Credit. Not collateral, WAS, or OC/IC."
    }
  ]
}