Package Exports
- @moneygraph/sdk
Readme
MoneyGraph SDK
Global payments infrastructure for cross-border transfers, FX, and payouts.
Installation
npm install @moneygraph/sdkAI Agent Setup (Optional)
# Cursor
cp node_modules/@moneygraph/sdk/.cursorrules .cursorrules
mkdir -p .cursor/rules
cp node_modules/@moneygraph/sdk/.cursor/rules/moneygraph.mdc .cursor/rules/
# Windsurf
cp node_modules/@moneygraph/sdk/.windsurfrules .windsurfrules
# Amazon Q
mkdir -p .amazonq
cp node_modules/@moneygraph/sdk/.amazonq/rules.md .amazonq/Quick Start
import MoneyGraph from '@moneygraph/sdk';
const mg = new MoneyGraph({ apiKey: process.env.MONEYGRAPH_API_KEY });
// Get FX quote
const quote = await mg.fx.quote({
source_currency: 'USD',
destination_currency: 'NGN',
source_amount: 100
});
// Confirm rate (valid for 2 minutes)
await mg.fx.confirm(quote.id);
// Send payout
const payout = await mg.payouts.create({
customer_id: 'cust_xxx',
quote_id: quote.id,
recipient: {
name: 'Recipient Name',
bank_code: '058',
account_number: '0123456789'
},
idempotency_key: `payout-${Date.now()}`
});Serverless Sandbox
const mg = new MoneyGraph({ apiKey: 'sk_test_demo' });
const customer = await mg.customers.createMockPersona('business_verified');API Keys
- Sandbox: Get at moneygraph.ai or use
sk_test_demo - Live: Create account > Complete KYB > Choose plan > Get approved
SDK Methods
Customers
mg.customers.create(params)
mg.customers.retrieve(id)
mg.customers.kyc.submit(id)
mg.customers.createMockPersona(type)FX
mg.fx.quote(params)
mg.fx.confirm(quoteId)
mg.fx.rates()Payouts
mg.payouts.create(params)
mg.payouts.swift.create(params)
mg.payouts.mobileMoney.create(params)
mg.payouts.crypto.create(params)Cards
mg.cards.create(params)
mg.cards.fund(params)
mg.cards.freeze(id)Crypto
mg.crypto.addresses.create(params)
mg.crypto.deposits.list(params)
mg.crypto.convert.quote(params)Critical Rules
- Date Format: DD-MM-YYYY
- KYC Required: Verify before payouts
- FX Expiry: Quotes expire in 2 minutes
- Idempotency: Always include unique keys
Links
- Website: moneygraph.ai
- Docs: docs.moneygraph.ai
License
MIT