# Quickstart Integrate Fynd into your application in two steps. {% hint style="info" %} To interact with live quotes directly in your terminal, go to [swap CLI](/guides/swap-cli.md) instead. {% endhint %} ## Prerequisites * **Tycho API key** (set as `TYCHO_API_KEY`, [get one here](https://t.me/fynd_portal_bot)) * **Rust 1.92+** ([install via rustup](https://rustup.rs/)) or **Docker** ([install Docker](https://docs.docker.com/get-started/get-docker/)) ## Step 0 — Start Fynd {% tabs %} {% tab title="cargo install" %} ```bash cargo install fynd export TYCHO_API_KEY=your-api-key export RUST_LOG=fynd=info fynd serve ``` {% endtab %} {% tab title="Docker" %} Images are available for linux/amd64 and linux/arm64. ```bash docker run \ -e TYCHO_API_KEY=your-api-key \ -e RUST_LOG=fynd=info \ -p 3000:3000 -p 9898:9898 \ ghcr.io/propeller-heads/fynd serve ``` {% endtab %} {% tab title="Build from source" %} ```bash git clone https://github.com/propeller-heads/fynd.git cd fynd cargo install --locked --path . export TYCHO_API_KEY=your-api-key export RUST_LOG=fynd=info fynd serve ``` {% endtab %} {% endtabs %} ## Step 1 — Execute a swap {% hint style="info" %} Fynd currently only supports **sell orders** (exact input). Set `"side": "sell"` in your order. Buy orders (exact output) are not yet supported. {% endhint %} {% tabs %} {% tab title="TypeScript" %} Full example: [`clients/typescript/examples/tutorial/main.ts`](https://github.com/propeller-heads/fynd/blob/main/clients/typescript/examples/tutorial/main.ts) Install the [`@kayibal/fynd-client`](https://www.npmjs.com/package/@kayibal/fynd-client) package: ```bash npm install @kayibal/fynd-client ``` ```typescript const client = new FyndClient({ baseUrl: FYND_URL, chainId: mainnet.id, sender: account.address, provider: viemProvider(publicClient, account.address), fetchRevertReason: true, }); // 1. Quote const quote = await client.quote({ order: { tokenIn: WETH, tokenOut: USDC, amount: SELL_AMOUNT, side: 'sell', sender: account.address }, options: { encodingOptions: encodingOptions(0.005) }, }); console.log(`amount_out: ${quote.amountOut}`); // 2. Approve if needed (checks on-chain allowance, skips if sufficient) const approvalPayload = await client.approval({ token: WETH, amount: SELL_AMOUNT, checkAllowance: true }); if (approvalPayload !== null) { const sig = await account.sign({ hash: approvalSigningHash(approvalPayload) }); await client.executeApproval({ tx: approvalPayload.tx, signature: sig }); } // 3. Sign and execute swap const payload = await client.swapPayload(quote); const sig = await account.sign({ hash: swapSigningHash(payload) }); const settled = await (await client.executeSwap(assembleSignedSwap(payload, sig))).settle(); console.log(`settled: ${settled.settledAmount}, gas: ${settled.gasCost}`); ``` {% endtab %} {% tab title="Rust" %} Full example: [`clients/rust/examples/swap_erc20.rs`](https://github.com/propeller-heads/fynd/blob/main/clients/rust/examples/swap_erc20.rs) Add the [`fynd-client`](https://crates.io/crates/fynd-client) crate to your `Cargo.toml`: ```toml cargo add fynd-client ``` ```rust let client = FyndClientBuilder::new(FYND_URL, RPC_URL) .with_sender(sender) .build() .await?; // 1. Quote let quote = client .quote(QuoteParams::new( Order::new( Bytes::copy_from_slice(sell_token.as_slice()), Bytes::copy_from_slice(buy_token.as_slice()), BigUint::from(SELL_AMOUNT), OrderSide::Sell, Bytes::copy_from_slice(sender.as_slice()), None, ), QuoteOptions::default() .with_timeout_ms(5_000) .with_encoding_options(EncodingOptions::new(SLIPPAGE)), )) .await?; println!("amount_out: {}", quote.amount_out()); // 2. Approve if needed (checks on-chain allowance, skips if sufficient) if let Some(approval_payload) = client .approval( &ApprovalParams::new( Bytes::copy_from_slice(sell_token.as_slice()), BigUint::from(SELL_AMOUNT), true, ), &SigningHints::default(), ) .await? { let sig = signer.sign_hash(&approval_payload.signing_hash()).await?; client .execute_approval(SignedApproval::assemble(approval_payload, sig)) .await? .await?; } // 3. Sign and execute swap let payload = client.swap_payload(quote, &SigningHints::default()).await?; let sig = signer.sign_hash(&payload.signing_hash()).await?; let receipt = client .execute_swap(SignedSwap::assemble(payload, sig), &ExecutionOptions::default()) .await? .await?; println!("gas: {}", receipt.gas_cost()); ``` {% endtab %} {% tab title="curl" %} ```bash # Wait until healthy curl http://localhost:3000/v1/health # → {"healthy":true,...} # Request a quote — 1000 USDC → WETH curl -X POST http://localhost:3000/v1/quote \ -H "Content-Type: application/json" \ -d '{ "orders": [ { "token_in": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "token_out": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "amount": "1000000000", "side": "sell", "sender": "0x0000000000000000000000000000000000000001" } ], "options": { "timeout_ms": 5000, "min_responses": 1 } }' ``` This quotes 1000 USDC (6 decimals → 1 000 000 000 atomic units) for WETH. {% endtab %} {% endtabs %} ## Next steps * [Encoding options](/guides/encoding-options.md) — encode quotes into ready-to-submit transactions * [Client fees](/guides/client-fees.md) — charge integrator fees on swaps * [Server configuration](/guides/server-configuration.md) * [Custom algorithm](/guides/custom-algorithm.md) * [Benchmarking](/guides/benchmarking.md) * [Swap CLI](/guides/swap-cli.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.fynd.xyz/get-started/quickstart.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.