💸Step 7 - Dollar Cost Average

As you may already know, Dollar Cost Average (DCA) is the possibilité pour the User to program their investment.

For instance, they will be able to buy a certain amount of the token of their choice on a regular basis (daily, weekly or monthly).

1 - The following endpoints, allows you to create a new DCA by specifying the original token, the destination token, the frequency of the transactions:

post

/v1/dca

Authorizations

Body

jwtobject

viewobject

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/dca' \
  --header 'Content-Type: application/json' \
  --data '{
    "jwt": {
      "tokenValue": "text",
      "issuedAt": "2025-03-12T04:34:05.825Z",
      "expiresAt": "2025-03-12T04:34:05.825Z",
      "headers": {
        "ANY_ADDITIONAL_PROPERTY": {}
      },
      "claims": {
        "ANY_ADDITIONAL_PROPERTY": {}
      },
      "id": "text",
      "issuer": "text",
      "notBefore": "2025-03-12T04:34:05.825Z",
      "subject": "text",
      "audience": [
        "text"
      ]
    },
    "view": {
      "quantity": 1,
      "from": "text",
      "to": "text",
      "frequency": "DAILY"
    }
  }'

200

200

{
  "success": true,
  "data": {
    "accountId": "text",
    "id": "text",
    "creationTs": "2025-03-12T04:34:05.825Z",
    "status": "ACTIVE",
    "quantity": 1,
    "fromCoin": {
      "slug": "text",
      "name": "text",
      "logoUrl": "text",
      "availableNetworks": [
        "text"
      ]
    },
    "toCoin": {
      "slug": "text",
      "name": "text",
      "logoUrl": "text",
      "availableNetworks": [
        "text"
      ]
    },
    "frequency": "DAILY"
  },
  "errorCode": 1,
  "errorMessage": "text"
}

OK

OAuth : user_auth

2 - The following endpoint, allows you to consult the active DCAs on an AccountId:

get

/v1/dca

Authorizations

Query parameters

jwtobjectrequired

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/dca?jwt=%5Bobject+Object%5D'

200

200

{
  "success": true,
  "data": [
    {
      "accountId": "text",
      "id": "text",
      "creationTs": "2025-03-12T04:34:05.825Z",
      "status": "ACTIVE",
      "quantity": 1,
      "fromCoin": {
        "slug": "text",
        "name": "text",
        "logoUrl": "text",
        "availableNetworks": [
          "text"
        ]
      },
      "toCoin": {
        "slug": "text",
        "name": "text",
        "logoUrl": "text",
        "availableNetworks": [
          "text"
        ]
      },
      "frequency": "DAILY"
    }
  ],
  "errorCode": 1,
  "errorMessage": "text"
}

OK

OAuth : user_auth

3 - Finally, this endpoint will give you the possibility to activate/deactivate a DCA:

put

/v1/dca/{id}//{status}

Authorizations

Path parameters

idstringrequired

statusstring · enumrequired

Options: ACTIVE, INACTIVE

Body

tokenValuestring

issuedAtstring · date-time

expiresAtstring · date-time

headersobject

claimsobject

idstring

issuerstring · url

notBeforestring · date-time

subjectstring

audiencestring[]

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url '/v1/dca/{id}/{status}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tokenValue": "text",
    "issuedAt": "2025-03-12T04:34:05.825Z",
    "expiresAt": "2025-03-12T04:34:05.825Z",
    "headers": {
      "ANY_ADDITIONAL_PROPERTY": {}
    },
    "claims": {
      "ANY_ADDITIONAL_PROPERTY": {}
    },
    "id": "text",
    "issuer": "text",
    "notBefore": "2025-03-12T04:34:05.825Z",
    "subject": "text",
    "audience": [
      "text"
    ]
  }'

200

200

{
  "success": true,
  "data": {
    "accountId": "text",
    "id": "text",
    "creationTs": "2025-03-12T04:34:05.825Z",
    "status": "ACTIVE",
    "quantity": 1,
    "fromCoin": {
      "slug": "text",
      "name": "text",
      "logoUrl": "text",
      "availableNetworks": [
        "text"
      ]
    },
    "toCoin": {
      "slug": "text",
      "name": "text",
      "logoUrl": "text",
      "availableNetworks": [
        "text"
      ]
    },
    "frequency": "DAILY"
  },
  "errorCode": 1,
  "errorMessage": "text"
}

OK

OAuth : user_auth