Build with FinAegis
Multiple ways to integrate our core banking infrastructure into your applications. Choose the approach that fits your needs.
Integration Approaches
Choose the integration method that best suits your application architecture and development needs
REST API
Direct HTTP/JSON integration
Integrate directly with our RESTful API using any programming language. Full OpenAPI 3.0 specification available.
Native SDKs
Language-specific libraries
Official SDKs for popular programming languages with idiomatic APIs and comprehensive type safety.
Native SDKs are planned for future development. Currently, use our REST API directly.
AI Agent Integration
Connect to our AI-powered banking agents with simple API calls
AI Agent API
const agent = new FinAegisAI({
apiKey: 'your-api-key'
});
// Send a message to the AI agent
const response = await agent.chat({
message: 'What is my account balance?',
context: { accountId: 'acc_123' }
});
console.log(response.message);
// "Your current balance is $12,456.78"
MCP Tool Integration
from finaegis import MCPClient
# Initialize MCP client
mcp = MCPClient(api_key='your-api-key')
# Use banking tools directly
balance = mcp.tools.get_account_balance(
account_id='acc_123',
currency='USD'
)
print(f"Balance: {balance.amount} {balance.currency}")
Model Context Protocol (MCP)
Standard protocol for AI model integration with banking tools
15+ Banking Tools
Account, transaction, compliance, and analytics tools
Built-in Security
Authentication, authorization, and audit logging
Real-time Processing
Stream responses with WebSocket support
{
"name": "finaegis-mcp-server",
"version": "1.0.0",
"tools": [
"GetAccountBalance",
"TransferMoney",
"KycVerification",
"AmlScreening",
"SpendingAnalysis"
],
"capabilities": {
"streaming": true,
"authentication": "bearer",
"rateLimit": 1000
}
}
Native SDKs Are Planned
We're planning to build native SDKs for all major programming languages to make integration even easier.
BaaS SDK Generation
Generate type-safe, versioned SDKs for your partner integration in TypeScript, Python, Java, Go, and PHP -- directly through the Partner API.
TypeScript
@finaegis/sdk
AvailablePython
finaegis-sdk
AvailableJava
com.finaegis:sdk
AvailableGo
finaegis-go
AvailablePHP
finaegis/sdk
AvailableGenerate Your SDK via Partner API
When you onboard as a BaaS partner, SDKs are automatically generated for your requested languages. You can also regenerate or request additional language SDKs at any time.
# Request SDK generation for your partner account curl -X POST https://api.finaegis.org/api/v1/partner/sdk/generate \ -H "Authorization: Bearer YOUR_PARTNER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "languages": ["typescript", "python", "java", "go", "php"], "api_version": "v5", "include_modules": ["accounts", "transfers", "crosschain", "defi", "compliance"], "options": { "include_types": true, "include_examples": true, "include_tests": true } }' # Response includes download URLs for each SDK { "data": { "generation_id": "sdkgen_abc123", "status": "completed", "packages": [ { "language": "typescript", "version": "5.0.0", "package_name": "@finaegis/sdk", "download_url": "https://sdk.finaegis.org/packages/typescript/finaegis-sdk-5.0.0.tgz", "install_command": "npm install @finaegis/[email protected]" }, { "language": "python", "version": "5.0.0", "package_name": "finaegis-sdk", "download_url": "https://sdk.finaegis.org/packages/python/finaegis-sdk-5.0.0.tar.gz", "install_command": "pip install finaegis-sdk==5.0.0" }, { "language": "java", "version": "5.0.0", "package_name": "com.finaegis:sdk", "download_url": "https://sdk.finaegis.org/packages/java/finaegis-sdk-5.0.0.jar", "install_command": "mvn install com.finaegis:sdk:5.0.0" }, { "language": "go", "version": "5.0.0", "package_name": "github.com/finaegis/sdk-go", "download_url": "https://sdk.finaegis.org/packages/go/finaegis-sdk-go-5.2.0.tar.gz", "install_command": "go get github.com/finaegis/[email protected]" }, { "language": "php", "version": "5.0.0", "package_name": "finaegis/sdk", "download_url": "https://sdk.finaegis.org/packages/php/finaegis-sdk-5.0.0.zip", "install_command": "composer require finaegis/sdk:^5.0" } ] } }
Quick Install
TypeScript / JavaScript
npm install @finaegis/[email protected]
Python
pip install finaegis-sdk==5.0.0
Java (Maven)
mvn install com.finaegis:sdk:5.0.0
Go
go get github.com/finaegis/[email protected]
PHP (Composer)
composer require finaegis/sdk:^5.0
Partner SDK Integration Guide
Step-by-step guide to integrating the FinAegis BaaS SDK into your partner application, covering authentication, module access, and advanced features like Cross-Chain and DeFi.
Initialize the SDK with Your Partner Credentials
Use the API key and partner ID from your onboarding response. The SDK auto-configures based on your enabled modules.
TypeScript
import { FinAegis } from '@finaegis/sdk';
const client = new FinAegis({
apiKey: process.env.FINAEGIS_PARTNER_KEY,
partnerId: 'partner_acme_abc123',
environment: 'production', // or 'sandbox'
modules: ['accounts', 'transfers',
'crosschain', 'defi', 'compliance']
});
Python
from finaegis import FinAegis
client = FinAegis(
api_key=os.environ['FINAEGIS_PARTNER_KEY'],
partner_id='partner_acme_abc123',
environment='production',
modules=['accounts', 'transfers',
'crosschain', 'defi', 'compliance']
)
Access Cross-Chain and DeFi Modules (v5.2)
The SDK provides typed interfaces for bridge operations (Wormhole, LayerZero, Axelar), DEX aggregation (Uniswap, Aave, Curve, Lido), cross-chain swaps, and multi-chain portfolio management.
// TypeScript -- Cross-Chain Bridge + DeFi Swap in one workflow async function crossChainSwapWorkflow() { // Bridge USDC from Ethereum to Polygon const bridgeQuote = await client.crosschain.bridge.quote({ source_chain: 'ethereum', destination_chain: 'polygon', token: 'USDC', amount: '5000.00' }); const bridgeTx = await client.crosschain.bridge.initiate({ quote_id: bridgeQuote.data.quote_id, sender_address: '0x1234...abcd', recipient_address: '0x1234...abcd' }); // Wait for bridge completion, then swap on Polygon await client.crosschain.bridge.waitForCompletion(bridgeTx.data.bridge_tx_id); const swapQuote = await client.defi.swap.quote({ chain: 'polygon', token_in: 'USDC', token_out: 'WMATIC', amount_in: '5000.00' }); const swap = await client.defi.swap.execute({ quote_id: swapQuote.data.quote_id, wallet_address: '0x1234...abcd' }); // Get multi-chain portfolio overview const portfolio = await client.crosschain.portfolio.get({ wallet_address: '0x1234...abcd', chains: ['ethereum', 'polygon', 'arbitrum'] }); console.log('Portfolio total value:', portfolio.data.total_value_usd); }
Integrate RegTech Compliance (v2.8)
Built-in compliance modules for MiFID II reporting, MiCA compliance, and FATF Travel Rule -- automatically enforced based on your jurisdiction configuration.
// TypeScript -- Compliance-aware transfer async function compliantTransfer(transferParams) { // Travel Rule check is automatic for transfers above threshold const complianceResult = await client.regtech.travelRule.check({ transfer_id: transferParams.id, originator: transferParams.originator, beneficiary: transferParams.beneficiary, transfer_details: { amount: transferParams.amount, currency: transferParams.currency } }); if (!complianceResult.data.is_compliant) { throw new Error( `Compliance failed: ${complianceResult.data.compliance_issues .map(i => i.description).join(', ')}` ); } // MiCA compliance for crypto assets const micaCheck = await client.regtech.mica.validate({ asset_type: 'crypto', transaction_type: 'transfer', amount: transferParams.amount, jurisdiction: 'EU' }); // Proceed with transfer only if all checks pass return await client.transfers.create(transferParams); }
Use AI Transaction Queries (v2.8)
The SDK includes AI-powered transaction search that accepts natural language queries and returns structured, filterable results with risk scoring.
// TypeScript -- AI-powered transaction intelligence
const insights = await client.ai.transactions({
query: 'Large DeFi swaps on Ethereum this month with high slippage',
account_id: 'acct_primary',
options: {
include_analytics: true,
include_risk_scores: true
}
});
console.log('Interpreted as:', insights.data.interpreted_query);
console.log('Found:', insights.data.total_results, 'transactions');
console.log('Total volume:', insights.data.analytics.total_volume);
SDK Module Reference
Each BaaS partner SDK includes the following modules, based on the modules enabled during onboarding.
client.accounts
Account creation, balances, transactions
v1.0+client.transfers
Payments, P2P transfers, bulk operations
v1.0+client.wallets
Blockchain wallets, hardware wallet support
v2.1+client.compliance
KYC/AML, sanctions screening
v1.0+client.regtech
MiFID II, MiCA, Travel Rule compliance
v2.8+client.crosschain
Bridge protocols, multi-chain portfolio
v5.2+client.defi
DEX aggregation, lending, staking, yield
v5.2+client.ai
Transaction queries, spending insights
v2.8+client.partner
SDK generation, tenant management, config
v2.9+Built for Your Use Case
Whether you're building a fintech app, marketplace, or enterprise platform, FinAegis provides the banking infrastructure you need
Digital Wallets
Create secure digital wallets with multi-currency support, instant transfers, and comprehensive transaction history.
- Multi-currency accounts
- Instant peer-to-peer transfers
- QR code payments
Marketplace Banking
Enable split payments, escrow services, and automated payouts for your marketplace platform.
- Automated split payments
- Escrow services
- Seller payouts
Neobanking
Launch a complete digital banking solution with accounts, cards, and lending capabilities.
- Digital account opening
- Virtual card issuance
- Personal finance tools
Corporate Banking
Streamline business banking with bulk payments, expense management, and team permissions.
- Bulk payment processing
- Multi-user permissions
- Expense management
Lending Platform
Build lending products with automated underwriting, loan management, and repayment processing.
- Credit scoring integration
- Automated disbursements
- Repayment tracking
Investment Platform
Enable investment accounts, portfolio management, and automated investing features.
- Fractional investing
- Portfolio tracking
- Automated rebalancing
Get Started in Minutes
Three simple steps to integrate FinAegis into your application
Sign Up & Get API Keys
Create your free account and generate API keys from your dashboard. You'll get instant access to our sandbox environment.
Create Your First Account
Use our API to create customer accounts. Each account can hold multiple currencies and support various transaction types.
Process Transactions
Start processing payments, transfers, and other transactions. Monitor everything in real-time through webhooks or API polling.
See full code examples with syntax highlighting for all operations
Ready to integrate?
Choose your preferred language and start building with FinAegis today