> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avnu.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration Guide

> Recurring Buy integration guide

## Overview

Integrating Recurring Buy involves managing the lifecycle of an order:

1. **Creation**: Execute the recurring buy order transaction (Standard or Advanced).
2. **Monitoring**: Fetch active orders to display in your UI.
3. **Cancellation**: Allow users to close orders and retrieve remaining funds.

## SDK Integration Flows

The SDK provides two methods for creating recurring buy orders, depending on your needs:

### 1. Standard Flow (`executeCreateDca`)

Use this for a simple, standalone recurring buy creation.

* **Handles everything**: Automatically checks allowance, builds the approval transaction (if needed), and executes the recurring buy creation.
* **Best for**: Standard UIs where the user just wants to "Create Order".

### 2. Advanced Flow (`createDcaToCalls`)

Use this when you need to compose the recurring buy creation with other actions (multicall).

* **Returns Calls**: Generates the necessary Starknet `Call` objects (including approval if needed).
* **Flexible**: You can bundle these calls with other transactions (e.g., a swap or a deposit) and execute them atomically.
* **Best for**: Complex flows, batching transactions, or using a custom account implementation.

## 1. Creating an Order

Use `executeCreateDca` to create the order. Ensure you import `moment` for the frequency.

```typescript theme={null}
import { executeCreateDca } from '@avnu/avnu-sdk';
import moment from 'moment';

const response = await executeCreateDca({
  provider: account,
  order: {
    sellTokenAddress: '0x...',
    buyTokenAddress: '0x...',
    sellAmount: '1000000000000000000', // 1 ETH
    sellAmountPerCycle: '100000000000000000', // 0.1 ETH
    frequency: moment.duration(1, 'day'),
    pricingStrategy: {},
    traderAddress: account.address
  }
});
```

## 2. Monitoring Orders

Use `getDcaOrders` to fetch a user's orders. You can filter by status:

* `INDEXING` - Order is being indexed after creation (temporary)
* `ACTIVE` - Order is currently executing
* `CLOSED` - Order completed or cancelled

```typescript theme={null}
import { getDcaOrders, DcaOrderStatus } from '@avnu/avnu-sdk';

const { content: orders } = await getDcaOrders({
  traderAddress: account.address,
  status: DcaOrderStatus.ACTIVE,
  page: 0,
  size: 20,
  sort: 'timestamp,desc'
});

orders.forEach(order => {
  console.log(`Order ${order.id}: ${order.amountSold} sold, ${order.amountBought} bought`);
});
```

## 3. Cancelling an Order

Users can cancel active orders to stop execution and retrieve unspent funds.

```typescript theme={null}
import { executeCancelDca } from '@avnu/avnu-sdk';

await executeCancelDca({
  provider: account,
  orderAddress: order.orderAddress // From the order object
});
```