Register DCA Schedule
curl --request POST \
--url https://api.aegisintent.xyz/v1/actions/wealth/dca \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Aegis-Email: <x-aegis-email>' \
--header 'X-Aegis-Nonce: <x-aegis-nonce>' \
--data '
{
"tokenIn": "USDC",
"tokenOut": "cirBTC",
"amountInPerTx": "25.00",
"frequencyHours": 24,
"totalOrders": 30
}
'import requests
url = "https://api.aegisintent.xyz/v1/actions/wealth/dca"
payload = {
"tokenIn": "USDC",
"tokenOut": "cirBTC",
"amountInPerTx": "25.00",
"frequencyHours": 24,
"totalOrders": 30
}
headers = {
"X-Aegis-Email": "<x-aegis-email>",
"Idempotency-Key": "<idempotency-key>",
"X-Aegis-Nonce": "<x-aegis-nonce>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Aegis-Email': '<x-aegis-email>',
'Idempotency-Key': '<idempotency-key>',
'X-Aegis-Nonce': '<x-aegis-nonce>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
tokenIn: 'USDC',
tokenOut: 'cirBTC',
amountInPerTx: '25.00',
frequencyHours: 24,
totalOrders: 30
})
};
fetch('https://api.aegisintent.xyz/v1/actions/wealth/dca', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aegisintent.xyz/v1/actions/wealth/dca",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tokenIn' => 'USDC',
'tokenOut' => 'cirBTC',
'amountInPerTx' => '25.00',
'frequencyHours' => 24,
'totalOrders' => 30
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"X-Aegis-Email: <x-aegis-email>",
"X-Aegis-Nonce: <x-aegis-nonce>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aegisintent.xyz/v1/actions/wealth/dca"
payload := strings.NewReader("{\n \"tokenIn\": \"USDC\",\n \"tokenOut\": \"cirBTC\",\n \"amountInPerTx\": \"25.00\",\n \"frequencyHours\": 24,\n \"totalOrders\": 30\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Aegis-Email", "<x-aegis-email>")
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("X-Aegis-Nonce", "<x-aegis-nonce>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aegisintent.xyz/v1/actions/wealth/dca")
.header("X-Aegis-Email", "<x-aegis-email>")
.header("Idempotency-Key", "<idempotency-key>")
.header("X-Aegis-Nonce", "<x-aegis-nonce>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"tokenIn\": \"USDC\",\n \"tokenOut\": \"cirBTC\",\n \"amountInPerTx\": \"25.00\",\n \"frequencyHours\": 24,\n \"totalOrders\": 30\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aegisintent.xyz/v1/actions/wealth/dca")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Aegis-Email"] = '<x-aegis-email>'
request["Idempotency-Key"] = '<idempotency-key>'
request["X-Aegis-Nonce"] = '<x-aegis-nonce>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tokenIn\": \"USDC\",\n \"tokenOut\": \"cirBTC\",\n \"amountInPerTx\": \"25.00\",\n \"frequencyHours\": 24,\n \"totalOrders\": 30\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"scheduleId": "<string>"
}Actions API
Register DCA Schedule
Register a recurring dollar-cost averaging schedule with a fixed number of orders. The Wealth Sentinel executes each leg automatically at the specified interval and marks the schedule as COMPLETED once all orders are fulfilled.
POST
/
v1
/
actions
/
wealth
/
dca
Register DCA Schedule
curl --request POST \
--url https://api.aegisintent.xyz/v1/actions/wealth/dca \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Aegis-Email: <x-aegis-email>' \
--header 'X-Aegis-Nonce: <x-aegis-nonce>' \
--data '
{
"tokenIn": "USDC",
"tokenOut": "cirBTC",
"amountInPerTx": "25.00",
"frequencyHours": 24,
"totalOrders": 30
}
'import requests
url = "https://api.aegisintent.xyz/v1/actions/wealth/dca"
payload = {
"tokenIn": "USDC",
"tokenOut": "cirBTC",
"amountInPerTx": "25.00",
"frequencyHours": 24,
"totalOrders": 30
}
headers = {
"X-Aegis-Email": "<x-aegis-email>",
"Idempotency-Key": "<idempotency-key>",
"X-Aegis-Nonce": "<x-aegis-nonce>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-Aegis-Email': '<x-aegis-email>',
'Idempotency-Key': '<idempotency-key>',
'X-Aegis-Nonce': '<x-aegis-nonce>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
tokenIn: 'USDC',
tokenOut: 'cirBTC',
amountInPerTx: '25.00',
frequencyHours: 24,
totalOrders: 30
})
};
fetch('https://api.aegisintent.xyz/v1/actions/wealth/dca', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aegisintent.xyz/v1/actions/wealth/dca",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tokenIn' => 'USDC',
'tokenOut' => 'cirBTC',
'amountInPerTx' => '25.00',
'frequencyHours' => 24,
'totalOrders' => 30
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"X-Aegis-Email: <x-aegis-email>",
"X-Aegis-Nonce: <x-aegis-nonce>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aegisintent.xyz/v1/actions/wealth/dca"
payload := strings.NewReader("{\n \"tokenIn\": \"USDC\",\n \"tokenOut\": \"cirBTC\",\n \"amountInPerTx\": \"25.00\",\n \"frequencyHours\": 24,\n \"totalOrders\": 30\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Aegis-Email", "<x-aegis-email>")
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("X-Aegis-Nonce", "<x-aegis-nonce>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aegisintent.xyz/v1/actions/wealth/dca")
.header("X-Aegis-Email", "<x-aegis-email>")
.header("Idempotency-Key", "<idempotency-key>")
.header("X-Aegis-Nonce", "<x-aegis-nonce>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"tokenIn\": \"USDC\",\n \"tokenOut\": \"cirBTC\",\n \"amountInPerTx\": \"25.00\",\n \"frequencyHours\": 24,\n \"totalOrders\": 30\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aegisintent.xyz/v1/actions/wealth/dca")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Aegis-Email"] = '<x-aegis-email>'
request["Idempotency-Key"] = '<idempotency-key>'
request["X-Aegis-Nonce"] = '<x-aegis-nonce>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tokenIn\": \"USDC\",\n \"tokenOut\": \"cirBTC\",\n \"amountInPerTx\": \"25.00\",\n \"frequencyHours\": 24,\n \"totalOrders\": 30\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"scheduleId": "<string>"
}Register a recurring dollar cost averaging schedule. The Wealth Sentinel automatically executes each leg at the specified interval using the agent’s Circle Developer Controlled Wallet.
Authorizations
BearerAuthAegisEmail
Provide raw API session token issued by /v1/connect/complete
Headers
Agent email address
Unique UUID for financial idempotency
Current agent nonce
Body
application/json
Was this page helpful?
⌘I