Integrate CoW Protocol

​

Compare approaches

​

Widget Integration

• Zero configuration — works immediately with sensible defaults
• Responsive design — adapts to any container size
• Multi-network — supports all CoW Protocol chains
• Themeable — customize colors and styling to match your brand
• Interactive configurator — preview and generate code at widget.cow.fi

import { CowSwapWidget, CowSwapWidgetParams } from '@cowprotocol/widget-react'

const params: CowSwapWidgetParams = {
  appCode: 'My Dapp',
  width: '450px',
  height: '640px',
  sell: { asset: 'WETH' },
  buy: { asset: 'COW' },
}

<CowSwapWidget params={params} />

​

SDK Integration

• Multiple abstraction levels — from high-level trading functions to low-level API access
• Adapter support — works with Viem, Ethers v5, and Ethers v6
• Order management — create, sign, submit, and cancel orders
• All order types — market, limit, TWAP, and programmatic orders

npm install @cowprotocol/cow-sdk

import { OrderBookApi, SupportedChainId } from '@cowprotocol/cow-sdk'

const orderBookApi = new OrderBookApi({ chainId: SupportedChainId.MAINNET })
const quote = await orderBookApi.getQuote(quoteRequest)

​

Python SDK (cow-py)

• One-call swaps — swap_tokens() handles quoting, signing, and submission
• Async/await — native asyncio support for concurrent operations
• Multi-chain — Ethereum, Gnosis, Arbitrum, Base, Polygon, Avalanche, BNB, Lens
• Type-safe — full type hints and Pydantic models
• Subgraph access — query trading data and analytics via GraphQL

pip install cowdao-cowpy

from cowdao_cowpy.cow.swap import swap_tokens
from cowdao_cowpy.common.chains import Chain

result = await swap_tokens(
    amount=sell_amount,
    account=account,
    chain=Chain.MAINNET,
    sell_token=SELL_TOKEN,
    buy_token=BUY_TOKEN,
)
print(f"Order: {result.uid}")

​

API Integration

• Full control — manage the entire order lifecycle via REST
• Language agnostic — works with any programming language
• Real-time data — access to orderbook state, auction data, and trade history

​

Next steps