# Swippee

> The consented financial-data layer for Nepal. A developer-first API that turns Nepali bank-statement PDFs (and wallet exports) into structured, machine-readable financial data — accounts, balances, transactions, income, identity, liabilities — plus an open NRB economic-data API.

Swippee is documents-today, bank-APIs-tomorrow: apps collect a statement (their own, via the Uploader) or a consumer permissions one (hosted Connect → `public_token`). Output is one stable `StatementReport` schema across every supported bank.

## Products
- [API documentation](https://docs.swippee.com): Quickstart + reference for every endpoint.
- [OpenAPI spec](https://swippee.com/openapi.json): Machine-readable API contract.
- [Products overview](https://swippee.com/products): Parse, Income, Identity, Liabilities, Balance, Transactions, Asset Report, Verify, Score, Underwriting, Enrich, Connect.
- [Swippee Connect](https://swippee.com/products/connect): Hosted consumer-consent flow and embeddable app-owned uploader.
- [Swippee Data](https://swippee.com/products/data): Open NRB datasets (forex, banking, interest rates, macro, payments, BFIs).
- [Pricing](https://swippee.com/pricing): Sandbox (free), Growth, Scale tiers.
- [Playground](https://swippee.com/playground): Try a live parse against a sample statement.
- [Embeddable widgets](https://swippee.com/widgets): Free, no-API-key iframe widgets for any site — Nepal forex converter, market rates vs NRB, bank SWIFT/BIC lookup, interest rates. Hosted at `https://swippee.com/embed/{forex,market-rates,swift,interest-rates}`.

## Datasets (open Nepal Rastra Bank economic data API)
- [Daily Forex Reference Rates](https://swippee.com/products/data/nrb-forex): NRB buy/sell rates for 20+ currencies vs NPR, every business day.
- [Monthly Banking & Financial Statistics](https://swippee.com/products/data/nrb-banking): NPL, CD ratio, capital adequacy, deposits, credit, branches, by BFI class.
- [Interest Rates](https://swippee.com/products/data/nrb-interest-rates): Base, lending, deposit, spread rates for commercial banks.
- [Macro Indicators](https://swippee.com/products/data/nrb-macro): Inflation, BOP, reserves, trade and other headline macro figures.
- [Digital Payments](https://swippee.com/products/data/nrb-payments): Nepal payment-system statistics (cards, QR, mobile/wallet, RTGS).
- [Bank & Financial Institution directory](https://swippee.com/products/data/nrb-bfis): NRB BFI directory with SWIFT/BIC codes.

## Key endpoints
- `POST /v1/parse`: Upload a bank-statement PDF/image → structured JSON.
- `POST /v1/connect/request` → hosted flow → `POST /v1/connect/exchange`: consumer-permissioned sharing.
- `GET /v1/data/nrb/*`: NRB economic datasets (API key required, free tier included). Example: `GET /v1/data/nrb/forex/latest`.

## Notes
- Supported banks: Nabil, NIC Asia, NIMB, NMB, Kumari, Siddhartha, Global IME; wallets: eSewa, Khalti.
- Authentication: `Authorization: Bearer <api_key>`.
- All Swippee Data responses carry `meta.source` + `meta.source_url` attribution back to Nepal Rastra Bank.