Pools

Liquidity Pool information and listing.

List all liquidity pools

get

Returns information about all available liquidity pools.

Responses

200

List of liquidity pools

application/json

400

Bad request

application/json

get/pools

GET /v1/pools HTTP/1.1
Host: api.tradecraft.fi
Accept: */*

{
  "pools": [
    {
      "token1": "CC",
      "token2": "USDCx",
      "lp_token_name": "TC CC/USDCx LP",
      "token1_holdings": 5000,
      "token2_holdings": 10000,
      "total_lp_tokens": 1000,
      "lp_fee_percent": 0.3,
      "operator_fee_percent": 0.1,
      "yield24h": 0.052
    }
  ]
}

Get a liquidity pool's ID

get

Returns the liquidity pool identifier for a token pair.

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

Liquidity pool ID

application/json

amm_idstringRequired

The AMM pool identifier

Example: TC CC/USDCx LP

400

Liquidity pool not found or invalid token names given

application/json

get/ammid/{tokenA}/{tokenB}

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

{
  "amm_id": "TC CC/USDCx LP"
}

Get liquidity pool state

get

Returns detailed information about the liquidity pool state including holdings, supply, and the constant product K.

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 state

application/json

Detailed AMM pool state (V4 contract format).

total_lp_token_supplynumber · doubleRequired

Total supply of LP tokens.

Example: 1000

token_a_idstringRequired

Identifier for token A.

Example: CC

token_a_holdingsnumber · doubleRequired

Amount of token A in the pool.

Example: 5000

token_b_idstringRequired

Identifier for token B.

Example: USDCx

token_b_holdingsnumber · doubleRequired

Amount of token B in the pool.

Example: 10000

knumber · doubleRequired

The constant product (token_a_holdings * token_b_holdings).

Example: 50000000

unclaimed_operator_feesnumber · doubleRequired

Accumulated operator fees awaiting claim (V4).

Example: 0.5

updated_atstring · date-timeRequired

Timestamp of the last pool operation (V4).

Example: 2026-01-20T14:35:00Z

400

Pool not found or token unknown

application/json

get/inspect/{tokenA}/{tokenB}

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

{
  "total_lp_token_supply": 1000,
  "token_a_id": "CC",
  "token_a_holdings": 5000,
  "token_b_id": "USDCx",
  "token_b_holdings": 10000,
  "k": 50000000,
  "unclaimed_operator_fees": 0.5,
  "updated_at": "2026-01-20T14:35:00Z"
}

Get pool disclosures

get

Returns disclosed contract blobs for the pool's AMM, AMMFees, AMMRules, LP instrument config, allocation factory, and featured app right contracts. These disclosures are required by clients to submit transactions (swaps, deposits, withdrawals) against the pool.

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 disclosures

application/json

Disclosed contracts needed to submit transactions against this pool. Includes the AMM, fees, rules, LP instrument config, allocation factory, and optionally the featured app right contract.

amm_dataobjectRequired

Parsed V4 AMM contract data

amm_fees_dataobjectRequired

Parsed V4 AMMFees contract data

amm_rules_dataobjectOptional

Parsed AMMRules contract data (if present)

featured_app_right_idstring · nullableOptional

Contract ID of the FeaturedAppRight (if present)

404

Pool not found

application/json

get/disclosures/{tokenA}/{tokenB}

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

{
  "amm": {
    "templateId": "text",
    "contractId": "text",
    "createdEventBlob": "Ynl0ZXM=",
    "synchronizerId": "text"
  },
  "amm_fees": {
    "templateId": "text",
    "contractId": "text",
    "createdEventBlob": "Ynl0ZXM=",
    "synchronizerId": "text"
  },
  "amm_rules": {
    "templateId": "text",
    "contractId": "text",
    "createdEventBlob": "Ynl0ZXM=",
    "synchronizerId": "text"
  },
  "instrument_config": {
    "templateId": "text",
    "contractId": "text",
    "createdEventBlob": "Ynl0ZXM=",
    "synchronizerId": "text"
  },
  "allocation_factory": {
    "templateId": "text",
    "contractId": "text",
    "createdEventBlob": "Ynl0ZXM=",
    "synchronizerId": "text"
  },
  "featured_app_right": {
    "templateId": "text",
    "contractId": "text",
    "createdEventBlob": "Ynl0ZXM=",
    "synchronizerId": "text"
  },
  "amm_data": {},
  "amm_fees_data": {},
  "amm_rules_data": {},
  "featured_app_right_id": "text"
}