1. Get Purchase Route Recommendations

This endpoint retrieves the best purchase route for a given cryptocurrency, based on AI-powered optimization.

Endpoint: GET /purchase-route

Parameters:

• asset (string): The cryptocurrency you want to purchase (e.g., `BTC`, `ETH`).
• amount (decimal): The amount of the cryptocurrency you want to buy.
• user_id (string): Optional, a unique user identifier for personalized recommendations.

Response Example:

{
  "asset": "BTC",
  "amount": 1.0,
  "recommended_routes": [
    {
      "platform": "Uniswap",
      "exchange_rate": 45000,
      "slippage": 0.02,
      "fees": 0.005,
      "route": "Uniswap > PancakeSwap",
      "estimated_cost": 45005
    },
    {
      "platform": "SushiSwap",
      "exchange_rate": 44950,
      "slippage": 0.01,
      "fees": 0.004,
      "route": "SushiSwap > 1inch",
      "estimated_cost": 44954
    }
  ]
}

2. Track Transaction History

Track all past cryptocurrency transactions, including the route used, fees paid, and slippage encountered.

Endpoint: GET /transaction-history

Parameters:

• user_id (string): The user ID to track transactions for.
• limit (integer): The number of transactions to return (default: 10).
• start_date (string, optional): Start date for filtering (YYYY-MM-DD).
• end_date (string, optional): End date for filtering (YYYY-MM-DD).

Response Example:

{
  "transactions": [
    {
      "transaction_id": "abc123",
      "asset": "BTC",
      "amount": 0.5,
      "platform": "Uniswap",
      "route": "Uniswap > PancakeSwap",
      "exchange_rate": 45000,
      "slippage": 0.02,
      "fees": 0.005,
      "total_cost": 22500,
      "status": "completed",
      "date": "2025-01-01T12:00:00Z"
    },
    {
      "transaction_id": "xyz456",
      "asset": "ETH",
      "amount": 10,
      "platform": "SushiSwap",
      "route": "SushiSwap > 1inch",
      "exchange_rate": 45050,
      "slippage": 0.01,
      "fees": 0.004,
      "total_cost": 45055,
      "status": "completed",
      "date": "2025-01-02T14:30:00Z"
    }
  ]
}

3. Get Real-Time Market Data

Retrieve the latest market data, including prices, liquidity, slippage, and fees for a particular cryptocurrency.

Endpoint: GET /market-data

Parameters:

• asset (string): The cryptocurrency to get market data for (e.g., `BTC`, `ETH`).
• exchange (string, optional): Specific exchange to retrieve data from (e.g., `Uniswap`, `SushiSwap`).

Response Example:

{
  "asset": "BTC",
  "market_data": [
    {
      "platform": "Uniswap",
      "price": 45000,
      "liquidity": 1000000,
      "slippage": 0.02,
      "fees": 0.005
    },
    {
      "platform": "SushiSwap",
      "price": 44950,
      "liquidity": 500000,
      "slippage": 0.01,
      "fees": 0.004
    }
  ]
}

4. Simulate Asset Purchase

Simulate a cryptocurrency purchase to test Jolunu AI's optimization for a given asset, helping you assess potential costs before making a real purchase.

Endpoint: POST /simulate-purchase

Request Body:

{
  "asset": "BTC",
  "amount": 1.0
}

Response Example:

{
  "asset": "BTC",
  "amount": 1.0,
  "recommended_route": {
    "platform": "Uniswap",
    "exchange_rate": 45000,
    "slippage": 0.02,
    "fees": 0.005,
    "estimated_cost": 45005
  },
  "estimated_transaction_fee": 225.025,
  "final_price": 45230.025
}