mirror of
https://github.com/luxfi/treasury.git
synced 2026-10-30 15:15:00 +00:00
main
.hanzo/workflows copies GitHub never reads and no forge runs. Claude-Session: https://claude.ai/code/session_01HuMDfgFssPUptYUzgZ6Cp8
Lux Treasury
Institutional treasury management platform with 13 banking/payment providers, double-entry ledger, and OFAC compliance.
Providers
Banking
| Provider | Capabilities |
|---|---|
| Mercury | Business banking, ACH, wires |
| Column | Direct Fed member, ACH/wire/RTP/FedNow |
| Bridge | Stablecoin orchestration, on/off ramp |
| Increase | Banking infrastructure, ACH/wire/RTP/checks |
| Modern Treasury | Payment operations, ledger, virtual accounts |
| Unit | BaaS, white-label checking/savings |
Payments
| Provider | Capabilities |
|---|---|
| Square | Payments, commerce, invoicing |
| Wise | International transfers, multi-currency, FX |
| CurrencyCloud (Visa) | Institutional FX, cross-border payments |
Cards
| Provider | Capabilities |
|---|---|
| Lithic | Virtual + physical cards, spend controls, real-time auth |
| Marqeta | Card issuing, JIT funding, spend controls |
Compliance
| Provider | Capabilities |
|---|---|
| Plaid | Bank account linking, identity verification |
Features
- Multi-Provider Banking — Unified API across 13 providers
- Double-Entry Ledger — Journal entries with automatic balancing
- OFAC Sanctions Screening — SDN list checks on all counterparties
- FX Conversions — Cross-border payments with competitive FX rates
- Card Issuing — Virtual and physical cards with spend controls
- Payment Rails — ACH, wire, RTP, FedNow, SEPA, SWIFT, checks
Architecture
Client Request
|
[treasuryd :8091]
|
+---+---+---+
| | | |
API Ledger Compliance
| |
+------+-------+
| | |
Banking Payments Cards
| | |
6 prov 4 prov 2 prov + Plaid
Quick Start
# Build
go build -o treasuryd ./cmd/treasuryd/
# Run (configure at least one provider)
MERCURY_API_KEY=... ./treasuryd
# Or with multiple providers
COLUMN_API_KEY=... WISE_API_TOKEN=... ./treasuryd
API
All endpoints under /api/v1/ on port :8091 (configurable via TREASURY_LISTEN).
Accounts
| Method | Path | Description |
|---|---|---|
POST |
/api/v1/{provider}/accounts |
Create bank account |
GET |
/api/v1/{provider}/accounts |
List accounts |
GET |
/api/v1/{provider}/accounts/{id} |
Get account |
GET |
/api/v1/{provider}/accounts/{id}/balance |
Get balance |
Payments
| Method | Path | Description |
|---|---|---|
POST |
/api/v1/{provider}/payments |
Create payment |
GET |
/api/v1/{provider}/payments |
List payments |
GET |
/api/v1/{provider}/payments/{id} |
Get payment |
DELETE |
/api/v1/{provider}/payments/{id} |
Cancel payment |
FX
| Method | Path | Description |
|---|---|---|
GET |
/api/v1/{provider}/fx/quote |
Get FX quote |
POST |
/api/v1/{provider}/fx/convert |
Execute FX conversion |
GET |
/api/v1/{provider}/fx/conversions |
List conversions |
Counterparties
| Method | Path | Description |
|---|---|---|
POST |
/api/v1/{provider}/counterparties |
Create counterparty |
GET |
/api/v1/{provider}/counterparties |
List counterparties |
Ledger
| Method | Path | Description |
|---|---|---|
POST |
/api/v1/ledger/entries |
Create journal entry |
GET |
/api/v1/ledger/entries |
List entries |
GET |
/api/v1/ledger/accounts/{id}/balance |
Account balance |
Compliance
| Method | Path | Description |
|---|---|---|
POST |
/api/v1/compliance/screen |
OFAC sanctions check |
GET |
/api/v1/compliance/status/{entity} |
Screening status |
Configuration
| Env Var | Description |
|---|---|
TREASURY_LISTEN |
Listen address (default :8091) |
MERCURY_API_KEY |
Mercury |
COLUMN_API_KEY |
Column |
BRIDGE_API_KEY |
Bridge |
INCREASE_API_KEY |
Increase |
MODERN_TREASURY_ORG_ID / MODERN_TREASURY_API_KEY |
Modern Treasury |
UNIT_TOKEN |
Unit |
SQUARE_ACCESS_TOKEN |
Square |
WISE_API_TOKEN / WISE_PROFILE_ID |
Wise |
CURRENCYCLOUD_LOGIN_ID / CURRENCYCLOUD_API_KEY |
CurrencyCloud |
LITHIC_API_KEY |
Lithic |
MARQETA_APP_TOKEN / MARQETA_ACCESS_TOKEN |
Marqeta |
PLAID_CLIENT_ID / PLAID_SECRET |
Plaid |
Docker
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-w -s" -o treasuryd ./cmd/treasuryd/
docker build --platform linux/amd64 -t ghcr.io/luxfi/treasury:latest .
License
Copyright 2024-2026, Lux Industries Inc. All rights reserved.
Description
Treasury platform: 13 providers, banking, payments, FX, cards, compliance
984 KiB
Languages
Go
99.8%