API Documentation

A-MX™ API Documentation

Institutional Commodity Infrastructure API

The AgaOne A-MX™ API provides programmatic access to the full commodity trading infrastructure — from real-time precious metals pricing and trade execution to vault operations, tokenization, compliance, and physical asset verification. This reference covers everything you need to integrate with the A-MX™ layer, from authentication to webhooks.

🔑Don't have an API key yet? Contact info@agaone.com to request institutional access.

Base URL

https://api.agaone.com/v1

All API endpoints are served over HTTPS. HTTP requests will be rejected.

Authentication

All API requests require a Bearer token in the Authorization header. API keys are issued during institutional onboarding and can be managed through the A-MX™ dashboard.

curl https://api.agaone.com/v1/commodities/prices \
  -H "Authorization: Bearer amx_live_..." \
  -H "Content-Type: application/json"

API keys are prefixed with amx_live_ for production and amx_test_ for sandbox environments.

Quick Start

Get up and running in three steps:

1.Get your API key

Contact AgaOne to receive your institutional API credentials.

2.Make your first request

Fetch live gold prices:

curl -X GET "https://api.agaone.com/v1/commodities/prices" \
  -H "Authorization: Bearer amx_live_..." \
  -d '{"commodity": "XAU", "currency": "USD", "source": "LBMA"}'

3.Explore the API

Browse the endpoint reference below to discover trading, vault, tokenization, and compliance capabilities.

{
  "commodity": "XAU",
  "bid": 2648.30,
  "ask": 2649.10,
  "spread": 0.80,
  "source": "LBMA",
  "timestamp": "2026-03-16T14:30:00Z",
  "unit": "troy_oz"
}

Platform Architecture

The AgaOne platform operates on a dual-layer architecture. A-CORE™ is the institutional ERP backbone built on Dynamics 365, serving as the system of record. A-MX™ is the orchestration and API layer that exposes platform capabilities to external integrations. A-INTELLIGENCE™ provides AI-driven compliance, risk analytics, and operational intelligence across both layers.

A-MX™ Layer

The orchestration, settlement, and API layer connecting all modules to external institutions. Handles pricing feeds, banking rails, custody connectors, super app integrations, and cross-border logic.

A-CORE™ Layer

The institutional infrastructure backbone built on Dynamics 365 — multi-entity accounting, treasury logic, regulatory traceability, audit trail, settlement control, and financial reporting.

A-INTELLIGENCE™ Layer

AI-driven layer wrapping the entire platform — automated AML screening, KYC verification, risk analytics, sanctions monitoring, anomaly detection, and operational insights.

API Reference

POST/v1/trades

Execute a commodity trade. Supports spot and forward settlement with automatic counterparty validation and vault allocation.

Parameter	Type	Required	Description
commodity	string	Yes	Commodity code (e.g. XAU, XAG)
side	string	Yes	BUY or SELL
quantity_oz	number	Yes	Quantity in troy ounces
counterparty_id	string	Yes	Verified counterparty identifier
settlement	string	Yes	T+0, T+1, or T+2
vault_destination	string	No	Target vault identifier

curl -X POST "https://api.agaone.com/v1/trades" \
  -H "Authorization: Bearer amx_live_..." \
  -d '{
    "commodity": "XAU",
    "side": "BUY",
    "quantity_oz": 100,
    "counterparty_id": "CP-00482",
    "settlement": "T+2",
    "vault_destination": "DIFC-V01"
  }'

{
  "trade_id": "TRD-2026-08471",
  "status": "confirmed",
  "commodity": "XAU",
  "side": "BUY",
  "quantity_oz": 100,
  "price_per_oz": 2648.30,
  "total_value": 264830.00,
  "settlement_date": "2026-03-18",
  "vault_destination": "DIFC-V01"
}

GET/v1/commodities/prices

Get real-time commodity prices from institutional data feeds including LBMA, COMEX, and Bloomberg.

Parameter	Type	Required	Description
commodity	string	Yes	Commodity code (e.g. XAU, XAG, XPT)
currency	string	No	Quote currency (default: USD)
source	string	No	LBMA, COMEX, or BLOOMBERG

curl -X GET "https://api.agaone.com/v1/commodities/prices" \
  -H "Authorization: Bearer amx_live_..." \
  -d '{"commodity": "XAU", "currency": "USD", "source": "LBMA"}'

{
  "commodity": "XAU",
  "bid": 2648.30,
  "ask": 2649.10,
  "spread": 0.80,
  "source": "LBMA",
  "timestamp": "2026-03-16T14:30:00Z",
  "unit": "troy_oz"
}

GET/v1/vault/inventory

Query bar-level vault inventory across all connected custodians including Brink's, Loomis, and Malca-Amit.

Parameter	Type	Required	Description
vault_id	string	No	Filter by vault identifier
commodity	string	No	Filter by commodity code
status	string	No	stored, in_transit, or allocated

curl -X GET "https://api.agaone.com/v1/vault/inventory?vault_id=DIFC-V01" \
  -H "Authorization: Bearer amx_live_..."

{
  "vault_id": "DIFC-V01",
  "total_bars": 847,
  "total_weight_oz": 27104,
  "items": [
    {
      "bar_id": "BAR-AU-2026-00147",
      "commodity": "XAU",
      "weight_oz": 32.15,
      "purity": 0.9999,
      "status": "stored",
      "location": "DIFC-V01-A3"
    }
  ]
}

POST/v1/tokens/mint

Mint a commodity-backed digital token with 1:1 physical reserve verification.

Parameter	Type	Required	Description
bar_id	string	Yes	Physical bar identifier
quantity_oz	number	Yes	Token quantity in troy ounces
recipient_id	string	Yes	Recipient entity identifier

curl -X POST "https://api.agaone.com/v1/tokens/mint" \
  -H "Authorization: Bearer amx_live_..." \
  -d '{
    "bar_id": "BAR-AU-2026-00147",
    "quantity_oz": 10,
    "recipient_id": "ENT-00291"
  }'

{
  "token_id": "TKN-AU-2026-04821",
  "bar_id": "BAR-AU-2026-00147",
  "quantity_oz": 10,
  "status": "minted",
  "reserve_verified": true,
  "created_at": "2026-03-16T15:00:00Z"
}

GET/v1/tokens/reserve-proof

Get proof of reserve attestation reconciling outstanding digital tokens against verified physical inventory.

Parameter	Type	Required	Description
token_id	string	No	Specific token identifier
as_of	string	No	Point-in-time date (ISO 8601)

curl -X GET "https://api.agaone.com/v1/tokens/reserve-proof" \
  -H "Authorization: Bearer amx_live_..."

{
  "attestation_id": "ATT-2026-03-16",
  "total_tokens_oz": 84200,
  "total_physical_oz": 84200,
  "coverage_ratio": 1.0,
  "status": "fully_backed",
  "auditor": "independent",
  "generated_at": "2026-03-16T16:00:00Z"
}

POST/v1/compliance/kyc

Submit KYC verification for a counterparty through the A-INTELLIGENCE™ compliance layer.

Parameter	Type	Required	Description
entity_type	string	Yes	individual or institution
entity_data	object	Yes	Entity identification data
documents	array	No	Supporting document references

curl -X POST "https://api.agaone.com/v1/compliance/kyc" \
  -H "Authorization: Bearer amx_live_..." \
  -d '{
    "entity_type": "institution",
    "entity_data": {
      "name": "Acme Trading Ltd",
      "jurisdiction": "UAE",
      "registration_number": "DMCC-12345"
    },
    "documents": ["DOC-001", "DOC-002"]
  }'

{
  "kyc_id": "KYC-2026-00891",
  "entity_type": "institution",
  "status": "approved",
  "risk_score": "low",
  "verified_at": "2026-03-16T15:30:00Z",
  "valid_until": "2027-03-16"
}

GET/v1/traceability/{barId}

Get the full provenance chain for a specific bar — from mine to refinery to vault, with every custody transfer recorded.

Parameter	Type	Required	Description
barId	string	Yes	Bar identifier (path parameter)

curl -X GET "https://api.agaone.com/v1/traceability/BAR-AU-2026-00147" \
  -H "Authorization: Bearer amx_live_..."

{
  "bar_id": "BAR-AU-2026-00147",
  "commodity": "XAU",
  "weight_oz": 32.15,
  "purity": 0.9999,
  "chain": [
    {"event": "refined", "location": "Istanbul", "date": "2026-01-15"},
    {"event": "assayed", "location": "Istanbul", "date": "2026-01-16"},
    {"event": "shipped", "location": "Istanbul → Dubai", "date": "2026-01-20"},
    {"event": "vaulted", "location": "DIFC-V01", "date": "2026-01-22"}
  ]
}

PUT/v1/vault/transfer

Initiate an inter-vault transfer between connected custodians.

curl -X PUT "https://api.agaone.com/v1/vault/transfer" \
  -H "Authorization: Bearer amx_live_..." \
  -d '{
    "bar_id": "BAR-AU-2026-00147",
    "source_vault": "DIFC-V01",
    "destination_vault": "SG-V02",
    "reason": "client_allocation"
  }'

POST/v1/settlement/execute

Execute trade settlement with automatic reconciliation and ledger posting through A-CORE™.

curl -X POST "https://api.agaone.com/v1/settlement/execute" \
  -H "Authorization: Bearer amx_live_..." \
  -d '{"trade_id": "TRD-2026-08471"}'

DELETE/v1/tokens/burn

Burn a redeemed digital token following physical delivery or redemption.

curl -X DELETE "https://api.agaone.com/v1/tokens/burn" \
  -H "Authorization: Bearer amx_live_..." \
  -d '{"token_id": "TKN-AU-2026-04821", "reason": "physical_redemption"}'

POST/v1/orders

Place a limit or market order for commodity execution.

curl -X POST "https://api.agaone.com/v1/orders" \
  -H "Authorization: Bearer amx_live_..." \
  -d '{
    "commodity": "XAU",
    "side": "BUY",
    "type": "limit",
    "quantity_oz": 50,
    "limit_price": 2645.00
  }'

GET/v1/positions

Retrieve current commodity positions and exposure across all accounts.

curl -X GET "https://api.agaone.com/v1/positions" \
  -H "Authorization: Bearer amx_live_..."

{
  "positions": [
    {
      "commodity": "XAU",
      "net_position_oz": 1420,
      "avg_cost": 2631.50,
      "unrealized_pnl": 23842.00,
      "vaults": ["DIFC-V01", "SG-V02"]
    }
  ]
}

Integrations

Vault Custodians

A-MX™ connects to institutional vault custodians including Brink's, Loomis, and Malca-Amit for real-time inventory synchronization, transfer orchestration, and proof-of-reserve attestation.

Banking Partners

Settlement rails connect through banking partner APIs for cross-border wire transfers, FX conversion, and real-time reconciliation across multiple currencies.

Market Data Feeds

Real-time pricing from LBMA, COMEX, Bloomberg, and Reuters feeds with sub-second latency for institutional trading operations.

Exchange Connectivity

Direct connectivity to DGCX and Borsa Istanbul for exchange-traded commodity execution and settlement.

Reference

Rate Limits

The A-MX™ API enforces rate limits to ensure fair usage across all institutional clients.

Tier	Requests/min	Requests/day
Standard	60	10,000
Professional	300	100,000
Enterprise	Custom

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Error Codes

Code	Name	Description
400	Bad Request	Invalid request parameters
401	Unauthorized	Missing or invalid API key
403	Forbidden	Insufficient permissions
404	Not Found	Resource not found
409	Conflict	Duplicate or conflicting operation
422	Unprocessable	Valid request but cannot be processed
429	Rate Limited	Too many requests
500	Server Error	Internal platform error

{
  "error": {
    "code": "INVALID_COMMODITY",
    "message": "The specified commodity 'XYZ' is not supported.",
    "status": 400
  }
}

Changelog

v1.2.0March 2026

Added /v1/orders and /v1/positions endpoints. Enhanced proof-of-reserve attestation with independent auditor support.

v1.1.0January 2026

Added tokenization endpoints, KYC verification, and full provenance traceability.

v1.0.0November 2025

Initial release — commodity pricing, trade execution, vault inventory, and settlement.

SDKs

Official SDKs are available for institutional integration:

Pythonpip install agaone-sdk

Node.jsnpm install @agaone/sdk

JavaMaven coordinatesCOMING SOON

.NETNuGet packageCOMING SOON