@extends('layouts.public') @section('title', 'Developer APIs - FinAegis') @section('seo') @include('partials.seo', [ 'title' => 'Developer APIs', 'description' => 'Comprehensive REST APIs and webhooks for seamless integration. Build powerful applications on our platform.', 'keywords' => 'API, REST API, webhooks, developer tools, integration, FinAegis API', ]) {{-- Schema.org Markup --}} @endsection @push('styles') @endpush @section('content')

Developer APIs

Build the future of finance with our comprehensive REST APIs, webhooks, and SDKs. Everything you need to integrate FinAegis into your applications.

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: 'user@example.com',
    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
@endsection