Skip to main content
POST
/
dca
/
v3
/
orders
curl -X POST "https://starknet.api.avnu.fi/dca/v3/orders" \\
  -H "Content-Type: application/json" \\
  -d '{
    "traderAddress": "0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
    "sellTokenAddress": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
    "sellAmount": "1000000000000000000",
    "sellAmountPerCycle": "100000000000000000",
    "buyTokenAddress": "0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
    "frequency": "P1D",
    "pricingStrategy": {
      "tokenToMinAmount": null,
      "tokenToMaxAmount": null
    }
  }'

{
  "chainId": "0x534e5f4d41494e",
  "calls": [
    {
      "contractAddress": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
      "entrypoint": "approve",
      "calldata": [
        "0x073f6e3f2e5f8f8e7d3d2b1a0c9b8a7f6e5d4c3b2a1",
        "0xde0b6b3a7640000",
        "0x0"
      ]
    },
    {
      "contractAddress": "0x073f6e3f2e5f8f8e7d3d2b1a0c9b8a7f6e5d4c3b2a1",
      "entrypoint": "deploy_dca_order",
      "calldata": [
        "0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
        "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
        "0xde0b6b3a7640000",
        "0x16345785d8a0000",
        "0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
        "0x15180",
        "0x0",
        "0x1"
      ]
    }
  ]
}

​
Overview

Creates a DCA (Dollar-Cost Averaging) order that automatically executes recurring swaps at specified intervals. Each order is deployed as a dedicated smart contract that manages your funds and executes trades autonomously.

​
Request

​
traderAddress
string
required
Address that will own the DCA order
​
sellTokenAddress
string
required
Token to sell over time
​
sellAmount
string
required
Total amount to sell across all cycles
​
sellAmountPerCycle
string
required
Amount to sell in each cycle
​
buyTokenAddress
string
required
Token to purchase
​
frequency
string
required
ISO 8601 duration format (e.g., “P1D” for daily, “PT12H” for 12 hours)
  • PT1H - Every hour
  • PT6H - Every 6 hours
  • P1D - Daily
  • P1W - Weekly
  • P1M - Monthly
​
startDate
string
ISO 8601 start date (defaults to now)
​
pricingStrategy
object
required
Price constraints for order execution

​
Response

​
chainId
string
required
Network identifier (e.g., “0x534e5f4d41494e”)
​
calls
array
required
Array of transaction calls to create the order
curl -X POST "https://starknet.api.avnu.fi/dca/v3/orders" \\
  -H "Content-Type: application/json" \\
  -d '{
    "traderAddress": "0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
    "sellTokenAddress": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
    "sellAmount": "1000000000000000000",
    "sellAmountPerCycle": "100000000000000000",
    "buyTokenAddress": "0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
    "frequency": "P1D",
    "pricingStrategy": {
      "tokenToMinAmount": null,
      "tokenToMaxAmount": null
    }
  }'

{
  "chainId": "0x534e5f4d41494e",
  "calls": [
    {
      "contractAddress": "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
      "entrypoint": "approve",
      "calldata": [
        "0x073f6e3f2e5f8f8e7d3d2b1a0c9b8a7f6e5d4c3b2a1",
        "0xde0b6b3a7640000",
        "0x0"
      ]
    },
    {
      "contractAddress": "0x073f6e3f2e5f8f8e7d3d2b1a0c9b8a7f6e5d4c3b2a1",
      "entrypoint": "deploy_dca_order",
      "calldata": [
        "0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
        "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
        "0xde0b6b3a7640000",
        "0x16345785d8a0000",
        "0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
        "0x15180",
        "0x0",
        "0x1"
      ]
    }
  ]
}

​
Order Calculation

Number of cycles = Total Amount ÷ Amount Per CycleDuration = Number of Cycles × FrequencyExample: 1 ETH total, 0.1 ETH per cycle, daily frequency = 10 days duration