RESTful APIs

Clean, predictable REST endpoints with comprehensive documentation and examples.

Real-time Webhooks

Get instant notifications for all important events in your integration.

SDKs & Libraries

Official SDKs for PHP, JavaScript, Python, Java, and more.

API Categories

Authentication & Users

Secure user authentication and profile management.

POST /api/auth/register

POST /api/auth/login

GET /api/auth/user

Account Management

Create and manage user accounts with multi-asset support.

GET /api/accounts

POST /api/accounts

GET /api/accounts/{uuid}/balances

Transactions & Transfers

Process payments and transfers with instant settlement.

POST /api/transfers

GET /api/transactions

POST /api/transactions/reverse

GCU & Governance

Global Currency Unit operations and voting endpoints.

GET /api/v2/gcu

POST /api/v2/gcu/buy

POST /api/voting/polls/{id}/vote

Quick Start Examples

Authentication

// Login and get access token
const response = await fetch('https://api.finaegis.com/api/auth/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: '[email protected]',
    password: 'secure_password'
  })
});

const { access_token } = await response.json();

// Use token for authenticated requests
const headers = {
  'Authorization': `Bearer ${access_token}`,
  'Content-Type': 'application/json'
};

Create Transfer

// Transfer between accounts
const transfer = await fetch('https://api.finaegis.com/api/transfers', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${access_token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    from_account: 'acc_123456',
    to_account: 'acc_789012',
    amount: 100.00,
    currency: 'EUR',
    description: 'Payment for services'
  })
});

const result = await transfer.json();
console.log('Transfer ID:', result.id);
console.log('Status:', result.status);

Webhook Handler

// Express.js webhook handler
app.post('/webhooks/finaegis', (req, res) => {
  const signature = req.headers['x-finaegis-signature'];
  const payload = req.body;
  
  // Verify webhook signature
  if (!verifyWebhookSignature(payload, signature)) {
    return res.status(401).send('Invalid signature');
  }
  
  // Handle different event types
  switch (payload.event_type) {
    case 'transaction.completed':
      handleTransactionCompleted(payload.data);
      break;
    case 'account.created':
      handleAccountCreated(payload.data);
      break;
    // Handle other events...
  }
  
  res.status(200).send('OK');
});

API Features

Technical Features

RESTful design with predictable endpoints
JSON request/response format
OAuth 2.0 and JWT authentication
Rate limiting with clear headers
Idempotency support for safe retries
Comprehensive error handling

Developer Experience

Interactive API documentation
Sandbox environment for testing
Code examples in multiple languages
Postman collection available
API changelog and versioning
Developer support channel

Official SDKs

PHP

PHP SDK

Composer package

JS

JavaScript SDK

NPM package

Py

Python SDK

PyPI package

Java

Java SDK

Maven package

Start Building Today

Get your API keys and start integrating FinAegis into your applications

Get API Keys View Documentation

Developer APIs