# Ivy - U.S. Credit Union & Bank Data API

> Fetch real-time regulatory data for ~4,400 credit unions and ~4,300 banks.

## How to Use

Fetch JSON data directly with the institution ID:
- Credit unions: `https://cu.ivy.com.co/cu/{id}.json`
- Banks: `https://cu.ivy.com.co/bank/{id}.json`

## Popular Institution IDs (use these directly)

| Institution | Type | URL |
|-------------|------|-----|
| Navy Federal | CU | https://cu.ivy.com.co/cu/7769.json |
| Pentagon Federal | CU | https://cu.ivy.com.co/cu/5328.json |
| State Employees (NC) | CU | https://cu.ivy.com.co/cu/11682.json |
| Golden 1 | CU | https://cu.ivy.com.co/cu/11829.json |
| Alliant | CU | https://cu.ivy.com.co/cu/1422.json |
| JPMorgan Chase | Bank | https://cu.ivy.com.co/bank/628.json |
| Bank of America | Bank | https://cu.ivy.com.co/bank/3510.json |
| Wells Fargo | Bank | https://cu.ivy.com.co/bank/3511.json |
| Citibank | Bank | https://cu.ivy.com.co/bank/7213.json |

## Find Any Institution

Full index (JSON): https://cu.ivy.com.co/institutions/all.json
By state (JSON): `https://cu.ivy.com.co/institutions/{STATE}.json` (e.g., TX, CA, NY)

JSON format: `[{"name":"...","identifier":"...","state":"...","id":"...","type":"cu|bank"}, ...]`

## What's in the JSON

- `assets`, `deposits`, `loans`, `net_income` - financial data
- `loan_portfolio` - breakdown by loan type (auto, mortgage, etc.)
- `historical` - quarterly data back to 2020 Q1
- `interest_rates` - current rates (credit unions only)
- `members` or `employees`, `branches` - operational data

## Example Prompt

"Fetch https://cu.ivy.com.co/cu/7769.json and analyze Navy Federal's financial health and loan portfolio."