API Reference

OnyxFlux API Endpoints

Complete reference for all API endpoints with request and response examples

Required Headers

Authorization: Bearer YOUR_API_KEY

Required for all requests

Content-Type: application/json

Required for POST requests

Base URL

https://api.onyxflux.com

GET/api/v1/balance/:address

Get the native token balance for an address

Parameters:

• address (required): Wallet address
• chain (optional): Chain identifier (default: ethereum)

Response:

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "balance": "1.234567890123456789",
  "chain": "ethereum",
  "timestamp": 1704067200
}

GET/api/v1/transaction/:hash

Get transaction details by hash

Parameters:

• hash (required): Transaction hash
• chain (optional): Chain identifier

Response:

{
  "hash": "0xabc123...",
  "from": "0x742d35Cc...",
  "to": "0x123abc...",
  "value": "1.5",
  "status": "confirmed",
  "blockNumber": 19234567,
  "timestamp": 1704067200
}

GET/api/v1/tokens/:address

Get all token balances for an address

Parameters:

• address (required): Wallet address
• chain (optional): Chain identifier

Response:

{
  "address": "0x742d35Cc...",
  "tokens": [
    {
      "symbol": "USDC",
      "balance": "1000.50",
      "contractAddress": "0xA0b8..."
    }
  ]
}

POST/api/v1/contract/call

Call a smart contract method

Parameters:

• contractAddress (required): Contract address
• method (required): Method name
• params (optional): Array of method parameters
• chain (optional): Chain identifier

Response:

{
  "result": "0x000000000000000...",
  "decoded": "1000000000000000000",
  "chain": "ethereum"
}

GET/api/v1/gas/price

Get current gas prices

Parameters:

• chain (required): Chain identifier

Response:

{
  "chain": "ethereum",
  "slow": "15",
  "standard": "20",
  "fast": "30",
  "instant": "45",
  "unit": "gwei"
}

GET/api/v1/nova/predictions

Get Nova AI market predictions (Pro/Enterprise only)

Parameters:

• asset (optional): Specific asset to predict
• timeframe (optional): Prediction timeframe (1h, 24h, 7d)

Response:

{
  "predictions": [
    {
      "asset": "ETH",
      "currentPrice": 2345.67,
      "predicted1h": 2350.12,
      "predicted24h": 2380.45,
      "confidence": 0.87,
      "lastUpdated": 1704067200
    }
  ],
  "disclaimer": "Predictions are not financial advice..."
}

Nova Intelligence AI Accuracy Disclaimer

Nova Intelligence AI uses real-time and historical blockchain data to produce predictions. While highly accurate most of the time, no model can guarantee 100% accuracy. Use Nova insights responsibly and always conduct your own research before making financial decisions. Past performance is not indicative of future results.