Skip to content

AFXO-Oracle/afxo-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AFXO — Emerging Markets FX Oracle

Website Docs Network

Institutional-grade FX data infrastructure for emerging markets. Multi-source aggregation, AI quality control, and on-chain delivery for DeFi protocols and financial institutions.

Overview

AFXO provides reliable, verifiable FX rates for 27+ currencies that existing oracles don't adequately cover — including African, Middle Eastern, and Asian emerging market currencies.

Key Features

  • Multi-Source Aggregation — Rates aggregated from 10+ institutional data sources per currency
  • AI Quality Control — ML-powered anomaly detection and confidence scoring
  • On-Chain Delivery — Avalanche C-Chain as canonical root, expanding to Celo, Base, Arbitrum, Solana
  • Industry-Standard Interface — Drop-in compatible with existing DeFi protocols
  • Decentralized Verification — Multi-operator consensus before any rate is published

Supported Currencies (27 Live on Testnet)

East Africa

Code Currency
KES Kenyan Shilling
ETB Ethiopian Birr
TZS Tanzanian Shilling
UGX Ugandan Shilling
RWF Rwandan Franc

West Africa

Code Currency
NGN Nigerian Naira
GHS Ghanaian Cedi
XOF CFA Franc (BCEAO)

Central Africa

Code Currency
CDF Congolese Franc
XAF CFA Franc (BEAC)
AOA Angolan Kwanza

Southern Africa

Code Currency
ZAR South African Rand
ZMW Zambian Kwacha
MWK Malawian Kwacha
MZN Mozambican Metical
BWP Botswana Pula
SZL Swazi Lilangeni
LSL Lesotho Loti

North Africa

Code Currency
EGP Egyptian Pound
MAD Moroccan Dirham
DZD Algerian Dinar
TND Tunisian Dinar

Trade Partner Reference Currencies

Code Currency
AED UAE Dirham
INR Indian Rupee
CNY Chinese Yuan
EUR Euro
GBP British Pound

Quick Start

Solidity Integration

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.19;

import "./interfaces/IAFXOOracle.sol";

contract MyProtocol {
    IAFXOOracle public kesOracle;

    constructor(address _kesOracle) {
        kesOracle = IAFXOOracle(_kesOracle);
    }

    function getKESPrice() external view returns (int256) {
        (
            ,
            int256 price,
            ,
            uint256 updatedAt,
        ) = kesOracle.latestRoundData();

        // Check data freshness
        require(block.timestamp - updatedAt < 3600, "Stale data");

        // Check confidence (recommended)
        require(kesOracle.getConfidence() >= 70, "Low confidence");

        return price; // 8 decimals
    }
}

REST API

curl -X GET "https://api.afxo.ai/v1/rates/KES/USD" \
  -H "X-API-Key: your_api_key"

Response:

{
  "pair": "KES/USD",
  "rate": "0.00770000",
  "confidence": 94,
  "sources": 6,
  "timestamp": "2025-01-20T12:00:00Z"
}

JavaScript/TypeScript

import { AFXOClient } from '@afxo/sdk';

const client = new AFXOClient({ apiKey: 'your_api_key' });

// Get current rate
const rate = await client.getRate('KES', 'USD');
console.log(rate.price, rate.confidence);

// Subscribe to updates
client.subscribe('KES/USD', (update) => {
  console.log('New rate:', update.price);
});

Documentation

Document Description
API Reference REST & WebSocket API documentation
Smart Contracts Contract addresses and integration guide
Methodology How rates are calculated and validated
Confidence Scoring Understanding confidence scores

Contract Addresses

Access Control: All oracles require subscription or whitelist access. Unauthorized calls will revert with SubscriptionRequired().

Avalanche C-Chain (Mainnet) — Chain ID: 43114

Oracle Address
All currencies Coming Soon

Avalanche Fuji (Testnet) — Chain ID: 43113

All 27 oracles deployed and live. See full address list →

Key addresses:

Oracle Proxy Address
KES/USD 0x62200Cc809D7B80665caCF314c46d3d638c775b1
NGN/USD 0xCaf356b38100CE40EDC125513C375E3b42E11D17
GHS/USD 0xbE894Aa75Fa1dd6fA6B945B99DB71B18172F1086
ZAR/USD 0x6E506531DE2Ad22c34B3b828E5865f8f12b91027
ETB/USD 0x8027f2a5DC69Ca1384e71691881ecDC889d71339

Examples

Pricing

Plan Update Frequency Rate Limit
Sandbox Daily 100 req/day
Starter ($49/mo) Hourly 1,000 req/day
Builder ($99/mo) 5-minute 10,000 req/day
Growth ($299/mo) 1-minute 100,000 req/day
Enterprise Sub-minute Unlimited

View full pricing →

Security

  • Multi-signature on-chain updates
  • Rate change limits enforced on-chain
  • Minimum confidence thresholds
  • Full audit trail for all updates

Links

License

This documentation and example code is provided under the MIT License for integration purposes.

Note: The AFXO oracle smart contracts and backend services are proprietary software owned by Digitalyze Labs Ltd.


Built with Avalanche. Powered by institutional-grade data infrastructure.

About

Documentation, examples, and integration guides for AFXO oracle

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published