Look up a token's contract address by its symbol on a specific network.

This is useful when you know the token symbol but not the address.

Args:

• symbolOrAddress: Token symbol (e.g., 'USDC', 'WETH', 'COW') or an address (returns info if found)

• network: The blockchain network

Returns:

• Token address

• Symbol and name

• Decimals

• Chain ID

Search for tokens by symbol or name across networks.

Args:

• query: Search string (e.g., 'USDC', 'cow', 'wrapped')

• network: Optional network filter

Returns up to 10 matching tokens with addresses and metadata.

Get a price and fee quote for a potential trade on CoW Protocol.

This returns the estimated amounts, fees, and a prepared order structure that can be signed and submitted.

Args:

• network: The blockchain network (mainnet, gnosis, arbitrum, base, avalanche, polygon, bnb, sepolia)

• sellToken: Token to sell (address or symbol like 'WETH')

• buyToken: Token to buy (address or symbol like 'USDC')

• kind: 'sell' for market sell (exact sell amount), 'buy' for market buy (exact buy amount)

• amount: The amount in wei as a string

• from: The trader's address (used for balance/allowance simulation)

• receiver: Optional address to receive bought tokens (defaults to 'from')

• partiallyFillable: Whether the order can be partially filled (default: false)

• slippageBps: Optional slippage tolerance in basis points

Returns the quoted order with:

• sellAmount, buyAmount, feeAmount

• expiration timestamp

• quote ID for tracking

• Whether the quote was verified via simulation

Get the current status of an order on CoW Protocol.

Args:

• network: The blockchain network

• orderUid: The unique order identifier

Returns the order status which can be:

• presignaturePending: Order is waiting for on-chain signature

• open: Order is active and waiting to be matched

• fulfilled: Order has been completely filled

• cancelled: Order has been cancelled

• expired: Order has expired

Get trade history for an address or order on CoW Protocol.

Args:

• network: The blockchain network

• owner: The address to fetch trades for (optional if orderUid provided)

• orderUid: Filter trades by specific order (optional if owner provided)

• limit: Maximum number of trades to return (1-100, default 20)

• offset: Pagination offset (default 0)

Note: Either owner or orderUid must be provided, but not both.

Returns a list of executed trades with:

• Transaction hash

• Sell/buy amounts and tokens

• Block number and timestamp

Get information about the current auction batch on CoW Protocol.

CoW Protocol batches orders into auctions that solvers compete to settle. This returns the current auction state.

Args:

• network: The blockchain network

Returns:

• Current auction ID

• Block number

• Orders in the batch

• Prices for tokens in the batch

Get full details of an order on CoW Protocol.

Args:

• network: The blockchain network

• orderUid: The unique order identifier

Returns the complete order data including:

• Sell/buy tokens and amounts

• Fee amount

• Validity period

• Signature and signing scheme

• App data

• Creation timestamp

Prepare an order for signing with EIP-712.

This generates the typed data structure needed to sign a CoW Protocol order. Use this after getting a quote from cow_get_quote.

Args:

• network: The blockchain network

• sellToken, buyToken: Token addresses or symbols

• sellAmount, buyAmount, feeAmount: Amounts from the quote

• validTo: Expiration timestamp from the quote

• from: The address that will sign the order

• kind: Order kind (sell/buy)

• partiallyFillable: Whether partial fills are allowed

• receiver: Optional receiver (defaults to from)

• appData: Optional app data hash

Returns:

• EIP-712 typed data JSON

• Foundry cast command to sign the order

• curl command to submit the signed order