Liquidity

Liquidity provider operations.

Get liquidity withdrawal quote

get

/quoteLPWithdrawal/{tokenA}/{tokenB}

Calculate how much of each token the user will receive when redeeming LP tokens.

Path parameters

tokenAstring · enumRequired

The name/symbol of the first token (URL encoded).

Example: CCPossible values:

tokenBstring · enumRequired

The name/symbol of the second token (URL encoded).

Example: USDCxPossible values:

Query parameters

lpTokenAmountnumber · doubleRequired

The amount of LP tokens to redeem

Example: 10

Responses

200

Liquidity withdrawal quote

application/json

amount_instrument_1number · doubleRequired

Amount of instrument 1 to receive.

Example: 50

amount_instrument_2number · doubleRequired

Amount of instrument 2 to receive.

Example: 100

400

Invalid parameters or liquidity pool not found

application/json

get/quoteLPWithdrawal/{tokenA}/{tokenB}

GET /v1/quoteLPWithdrawal/{tokenA}/{tokenB}?lpTokenAmount=10 HTTP/1.1
Host: api.tradecraft.fi
Accept: */*

{
  "amount_instrument_1": 50,
  "amount_instrument_2": 100
}

Get liquidity deposit quote

get

/quoteLPDeposit/{tokenA}/{tokenB}

Calculate the maximum LP tokens that can be minted given the provided amounts of both instruments. Returns the optimal deposit amounts maintaining the pool ratio.

Path parameters

tokenAstring · enumRequired

The name/symbol of the first token (URL encoded).

Example: CCPossible values:

tokenBstring · enumRequired

The name/symbol of the second token (URL encoded).

Example: USDCxPossible values:

Query parameters

instrument1Amountnumber · doubleRequired

The amount of instrument 1 available for deposit

Example: 100

instrument2Amountnumber · doubleRequired

The available amount of instrument 2 available for deposit

Example: 200

Responses

200

Liquidity deposit quote

application/json

lp_tokens_to_mintnumber · doubleRequired

Amount of LP tokens that will be minted.

Example: 10

instrument_1_to_depositnumber · doubleRequired

Amount of instrument 1 required for deposit.

Example: 100

instrument_2_to_depositnumber · doubleRequired

Amount of instrument 2 required for deposit.

Example: 200

400

Invalid parameters or liquidity pool not found

application/json

get/quoteLPDeposit/{tokenA}/{tokenB}

GET /v1/quoteLPDeposit/{tokenA}/{tokenB}?instrument1Amount=100&instrument2Amount=200 HTTP/1.1
Host: api.tradecraft.fi
Accept: */*

{
  "lp_tokens_to_mint": 10,
  "instrument_1_to_deposit": 100,
  "instrument_2_to_deposit": 200
}

Get pool yield/APY

get

/yield/{tokenA}/{tokenB}

Returns annualized percentage yield (APY) calculations for the pool across multiple time periods. APY is calculated based on the growth of value per LP token (k / lpSupply) over time. Requires Apollo DB connection for historical data; returns empty yield data if unavailable.

Path parameters

tokenAstring · enumRequired

The name/symbol of the first token (URL encoded).

Example: CCPossible values:

tokenBstring · enumRequired

The name/symbol of the second token (URL encoded).

Example: USDCxPossible values:

Responses

200

Pool yield data

application/json

pool_idstringRequired

The AMM pool identifier

Example: TC CC/USDC LP

400

AMM not found

application/json

get/yield/{tokenA}/{tokenB}

GET /v1/yield/{tokenA}/{tokenB} HTTP/1.1
Host: api.tradecraft.fi
Accept: */*

{
  "pool_id": "TC CC/USDC LP",
  "yield": {
    "1h": 0,
    "4h": 0,
    "12h": 0,
    "1d": 0.052,
    "7d": 0.048
  }
}

Get historical yield/APY over time

get

/yield_history/{tokenA}/{tokenB}

Returns an array of timestamped APY data points for the pool. Each data point represents the annualized yield during that time interval, calculated based on the growth of value per LP token (sqrt(k) / lpSupply). Timestamps are aligned to interval boundaries (e.g., top of minute, top of hour, midnight).

Available windows:

hour: 60 data points at 1-minute intervals
day: 288 data points at 5-minute intervals
week: 168 data points at 1-hour intervals

Requires Apollo DB connection for historical data.

Path parameters

tokenAstring · enumRequired

The name/symbol of the first token (URL encoded).

Example: CCPossible values:

tokenBstring · enumRequired

The name/symbol of the second token (URL encoded).

Example: USDCxPossible values:

Query parameters

windowstring · enumRequired

The time window for the yield history

Example: dayPossible values:

Responses

200

Historical yield data

application/json

pool_idstringRequired

The AMM pool identifier

Example: TC CC/USDCx LP

windowstring · enumRequired

The requested time window

Example: dayPossible values:

400

AMM not found or invalid window

application/json

get/yield_history/{tokenA}/{tokenB}

GET /v1/yield_history/{tokenA}/{tokenB}?window=day HTTP/1.1
Host: api.tradecraft.fi
Accept: */*

{
  "pool_id": "TC CC/USDCx LP",
  "window": "day",
  "history": [
    {
      "timestamp": "2026-01-20T14:35:00Z",
      "apy": 0.05
    }
  ]
}

Get pool trading volume in USD

get

/volume/{tokenA}/{tokenB}

Returns USD-denominated trading volume for the pool across multiple time periods. Volume is calculated by tracking changes in AMM reserves between consecutive states. Each swap is converted to USD at the exchange rate that was active at the time of that swap. USD conversion is performed using:

Stablecoins (SBC, USDCx): 1:1 with USD
CC (Canton Coin): Historical exchange rate from OpenMiningRound contracts via Scan ACS API Returns an error if neither token can be converted to USD.

Path parameters

tokenAstring · enumRequired

The name/symbol of the first token (URL encoded).

Example: CCPossible values:

tokenBstring · enumRequired

The name/symbol of the second token (URL encoded).

Example: USDCxPossible values:

Responses

200

Pool volume data in USD

application/json

pool_idstringRequired

The AMM pool identifier

Example: TC CC/USDCx LP

400

AMM not found or cannot calculate USD volume

application/json

get/volume/{tokenA}/{tokenB}

GET /v1/volume/{tokenA}/{tokenB} HTTP/1.1
Host: api.tradecraft.fi
Accept: */*

{
  "pool_id": "TC CC/USDCx LP",
  "volume_usd": {
    "1h": 150,
    "1d": 1500,
    "7d": 10000
  }
}

Get historical trading volume over time

get

/volume_history/{tokenA}/{tokenB}

Returns an array of timestamped volume data points for the pool. Each data point represents the USD-denominated trading volume during that time interval. Timestamps are aligned to interval boundaries (e.g., top of minute, top of hour, midnight).

Available windows:

hour: 60 data points at 1-minute intervals
day: 288 data points at 5-minute intervals
week: 168 data points at 1-hour intervals

Volume calculation uses the same methodology as /volume endpoint.

Path parameters

tokenAstring · enumRequired

The name/symbol of the first token (URL encoded).

Example: CCPossible values:

tokenBstring · enumRequired

The name/symbol of the second token (URL encoded).

Example: USDCxPossible values:

Query parameters

windowstring · enumRequired

The time window for the volume history

Example: dayPossible values:

Responses

200

Historical volume data

application/json

pool_idstringRequired

The AMM pool identifier

Example: TC CC/USDCx LP

windowstring · enumRequired

The requested time window

Example: dayPossible values:

400

AMM not found, invalid window, or cannot calculate USD volume

application/json

get/volume_history/{tokenA}/{tokenB}

GET /v1/volume_history/{tokenA}/{tokenB}?window=day HTTP/1.1
Host: api.tradecraft.fi
Accept: */*

{
  "pool_id": "TC CC/USDCx LP",
  "window": "day",
  "history": [
    {
      "timestamp": "2026-01-20T14:35:00Z",
      "volume_usd": 150
    }
  ]
}

PreviousQuotes

NextModels

Last updated 27 days ago

Was this helpful?