Copy Trade Simulator

Request cost: 10 credits

post

Simulate wallets copy trading results

Authorizations

xApiKey

X-API-KeystringRequired

API key for authentication

Body

application/json

Simulation input data

walletsstring[] · min: 1 · max: 100Required

List of wallets to follow

networkstring · enumRequired

Supported blockchain networks

Example: ethPossible values:

from_datestringRequired

Time interval start date. UTC timezone. YYYY-MM-DD format

to_datestringRequired

Time interval end date. UTC timezone. YYYY-MM-DD format

buy_percentageintegerRequired

Copy trading buy percentage (%)

max_buy_amountnumberRequired

Maximum purchase amount, in USD ($)

max_position_amountnumberRequired

Maximum position amount per deal, in USD ($)

priority_feenumberRequired

Priority fee amount, in network native currency

bribenumberRequired

Bribe amount, in network native currency

max_dupe_buy_timesintegerRequired

Maximum number of additional purchases

close_allbooleanOptional

Close deal on first sell

Default: false

include_bot_feesbooleanOptional

Include fees in calculations

Default: false

Responses

200

Simulation result

application/json

400

Request fail

application/json

401

API Key invalid or missing

403

API access forbidden

application/json

post

/wallets/simulator

HTTPcURLJavaScriptPython

POST /api/analytics/v1/wallets/simulator HTTP/1.1
Host: definest.ai
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 255

{
  "wallets": [
    "9ex23LM7UgMqWv9M9iE5wGvas6NiYKSsEUKHdK5XoUcn"
  ],
  "network": "sol",
  "from_date": "2025-07-01",
  "to_date": "2025-07-30",
  "buy_percentage": 100,
  "max_buy_amount": 1000,
  "max_position_amount": 10000,
  "priority_fee": 0.0001,
  "bribe": 0.001,
  "max_dupe_buy_times": 10
}

Basic request (SOL)With optional settings (SOL)

{
  "summary": {
    "pnl_total": 1000,
    "pnl_realized": 1000,
    "pnl_unrealized": 1000,
    "roi_total": 10,
    "roi_realized": 10,
    "bot_fees": 10,
    "network_fees": 10,
    "linearity_r2_closed_deals": 0.97,
    "top_deal_dominance": 5.5,
    "trading_volume": 10000,
    "slippage_loss": 10,
    "investment_amount": 10000,
    "investment_amount_closed_deals": 10000,
    "investment_amount_open_deals": 10000
  },
  "cumulative_pnl_and_fee_chart": {
    "pnl_realized": [
      1000
    ],
    "pnl_unrealized": [
      1000
    ],
    "pnl_total": [
      1000
    ],
    "fee_sum": [
      10
    ],
    "bot_fee": [
      10
    ],
    "deal_indexes": [
      1
    ],
    "timestamps": [
      1738303428
    ]
  },
  "cumulative_usd_closed_deals_chart": {
    "values": [
      100
    ],
    "timestamps": [
      1738303428
    ]
  },
  "cumulative_usd_open_deals_chart": {
    "values": [
      100
    ],
    "timestamps": [
      1738303428
    ]
  },
  "deals": [
    {
      "open_time": 1738303428,
      "last_operation_time": 1738303428,
      "status": "open",
      "token": {
        "name": "Wrapped BTC",
        "symbol": "WBTC",
        "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
      },
      "pnl_realized": 1000,
      "pnl_unrealized": 1000,
      "pnl_total": 1000,
      "roi_realized": 10,
      "roi_total": 10,
      "usd_slippage_loss": 0.5,
      "usd_network_fee": 10,
      "usd_bot_fee": 10,
      "investment_amount": 10000,
      "trades_number": 1,
      "closed_position": 50,
      "special_tag": "sell_timefix_final",
      "trades": [
        {
          "type": "buy",
          "time": 1738303428,
          "usd_amount": 100,
          "quantity": 2000,
          "usd_price": 0.15,
          "usd_liquidity": 10000,
          "usd_buy_price_avg": 0.6,
          "usd_invested": 1000,
          "slippage": 1,
          "usd_network_fee": 100,
          "usd_bot_fee": 0.5
        }
      ]
    }
  ]
}