Chainworks
Documentation

EVM Quotes

Get price quotes for token swaps without executing transactions.


Get Buy Quote

Get a price quote for buying tokens with native currency.

Endpoint: /evm/buy/quote

ParameterTypeRequiredDescription
chainstringYes

Chain identifier: eth, base, or bsc

tokenstringYesToken contract address
swapModestringYes

ExactIn (specify input) or ExactOut (specify output)

amountInstringConditional

Amount of native currency in wei. Required for ExactIn

amountOutstringConditional

Amount of tokens to receive. Required for ExactOut

walletstringYesWallet address for the quote

Example:

typescript
socket.emit("/evm/buy/quote", {
  chain: "eth",
  token: "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
  swapMode: "ExactIn",
  amountIn: "1000000000000000000", // 1 ETH
  wallet: "0x10a64c6d7f12c47b7c66c5b4e20e72bc1fcd5d9e",
});

Response:

json
{
  "success": true,
  "result": {
    "chain": "eth",
    "isBuy": true,
    "token": "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
    "swapMode": "ExactIn",
    "price": 0.00000234,
    "priceImpact": 0.0012,
    "amountIn": "1000000000000000000",
    "expectedAmountOut": "427350427350427350427350"
  }
}

Get Sell Quote

Get a price quote for selling tokens for native currency.

Endpoint: /evm/sell/quote

ParameterTypeRequiredDescription
chainstringYesChain identifier
tokenstringYesToken contract address
swapModestringYes

ExactIn or ExactOut

amountInstringConditional

Amount of tokens to sell. Required for ExactIn

walletstringYesWallet address