EVM Endpoints

Complete API reference for EVM-compatible chains including Ethereum, Base, and BNB Chain.

Supported Chains

Chain	Identifier	Native Token
Ethereum	`eth`	ETH
Base	`base`	ETH
BNB Chain	`bsc`	BNB

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

Parameter	Type	Required	Description
`chain`	string	Yes	Chain identifier: `eth`, `base`, or `bsc`
`token`	string	Yes	Token contract address
`swapMode`	string	Yes	`ExactIn` (specify input) or `ExactOut` (specify output)
`amountIn`	string	Conditional	Amount of native currency in wei. Required for `ExactIn`
`amountOut`	string	Conditional	Amount of tokens to receive. Required for `ExactOut`
`wallet`	string	Yes	Wallet 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

Parameter	Type	Required	Description
`chain`	string	Yes	Chain identifier
`token`	string	Yes	Token contract address
`swapMode`	string	Yes	`ExactIn` or `ExactOut`
`amountIn`	string	Conditional	Amount of tokens to sell. Required for `ExactIn`
`wallet`	string	Yes	Wallet address

Transactions

Build unsigned transactions for token swaps.

Get Buy Transaction

Build an unsigned transaction for buying tokens.

Endpoint: /evm/buy/transaction

Parameter	Type	Required	Description
`chain`	string	Yes	Chain identifier
`token`	string	Yes	Token contract address
`swapMode`	string	Yes	`ExactIn` or `ExactOut`
`amountIn`	string	Yes	Amount of native currency in wei
`wallet`	string	Yes	Wallet address
`slippageBps`	number	No	Slippage tolerance in basis points (default: 100 = 1%)
`feeBps`	number	No	Fee in basis points (0-175)
`feeRecipient`	string	No	Wallet to receive fees
`sendRoute`	string	No	`Public`, `Private`, or `Both` for MEV protection

Example:

typescript

socket.emit("/evm/buy/transaction", {
  chain: "eth",
  token: "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
  swapMode: "ExactIn",
  amountIn: "1000000000000000000",
  wallet: "0x10a64c6d7f12c47b7c66c5b4e20e72bc1fcd5d9e",
  slippageBps: 100,
  sendRoute: "Private",
});

Get Sell Transaction

Endpoint: /evm/sell/transaction

Same parameters as buy transaction. May require a permit for V3 pools.

Get Approve Transaction

Build a transaction to approve token spending.

Endpoint: /evm/approve/transaction

Parameter	Type	Required	Description
`chain`	string	Yes	Chain identifier
`token`	string	Yes	Token contract address
`wallet`	string	Yes	Wallet granting approval
`spender`	string	Yes	Contract address to approve

Transfers

Build transactions for native and token transfers.

Native Transfer

Transfer ETH/BNB to another address.

Endpoint: /evm/transfer/transaction

Parameter	Type	Required	Description
`chain`	string	Yes	Chain identifier
`recipient`	string	Yes	Recipient address
`amount`	string	Yes	Amount in wei
`wallet`	string	Yes	Sender address

Token Transfer

Transfer ERC-20 tokens.

Endpoint: /evm/transfer/token/transaction

Parameter	Type	Required	Description
`chain`	string	Yes	Chain identifier
`token`	string	Yes	Token contract address
`recipient`	string	Yes	Recipient address
`amount`	string	Yes	Amount in token decimals
`wallet`	string	Yes	Sender address

Wallet

Query wallet balances.

Get Native Balance

Endpoint: /evm/wallet/balance

typescript

socket.emit("/evm/wallet/balance", {
  chain: "eth",
  wallet: "0x10a64c6d7f12c47b7c66c5b4e20e72bc1fcd5d9e",
});

Get Token Balance

Endpoint: /evm/wallet/balance/token

typescript

socket.emit("/evm/wallet/balance/token", {
  chain: "eth",
  token: "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
  wallet: "0x10a64c6d7f12c47b7c66c5b4e20e72bc1fcd5d9e",
});

Token Information

Get Token Metadata

Endpoint: /evm/token/meta

Returns name, symbol, decimals, and total supply.

Get Token Report

Endpoint: /evm/token/report

Returns comprehensive token analysis:

Basic metadata (name, symbol, decimals)
Liquidity information
Buy/sell taxes
Transfer limits
Market cap and volume

Send Transaction

Broadcast signed transactions to the network.

Endpoint: /evm/send-transaction

⚠️ Warning: This endpoint sends real transactions to the blockchain.

Parameter	Type	Required	Description
`chain`	string	Yes	Chain identifier
`signedTransactions`	string[]	Yes	Array of signed transaction hex strings
`simulateBeforeSend`	boolean	No	Simulate before sending (default: true)

Next Steps

SVM Endpoints — Explore Solana endpoints
Error Handling — Learn about error codes
Playground — Test endpoints interactively