API Reference

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdstring · uuidRequired

Body

application/json

amountstringRequired

rewardIdstringOptional

Responses

200

Funds added to account

application/json

successbooleanRequired

400Error

application/json

404

Account not found

application/json

500Error

application/json

post

/earn/accounts/{accountId}/funds

HTTPcURLJavaScriptPython

POST /earn/accounts/{accountId}/funds HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "amount": "text",
  "rewardId": "text"
}

{
  "success": true
}

delete

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdstring · uuidRequired

withdrawalIdstringRequired

Responses

200

Withdrawal canceled

application/json

successbooleanRequired

400Error

application/json

404

Account not found

application/json

500Error

application/json

delete

/earn/accounts/{accountId}/withdrawals/{withdrawalId}

HTTPcURLJavaScriptPython

DELETE /earn/accounts/{accountId}/withdrawals/{withdrawalId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

unitsstringOptional

includeParametersstringOptional

Responses

200

Accounts

application/json

nextstringOptional

countnumberRequired

500Error

application/json

get

/earn/accounts

HTTPcURLJavaScriptPython

GET /earn/accounts HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "next": "text",
  "count": 1,
  "data": [
    {
      "currency": "EUR",
      "activeAmount": "text",
      "blockedAmount": "text",
      "accruedInterest": "text",
      "pendingWithdrawAmount": "text",
      "status": {
        "status": "ACTIVE",
        "reason": "text"
      },
      "allowedDestinations": [
        "CARD"
      ],
      "target": "EARN",
      "userId": "text",
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

unitsstringOptional

Body

application/json

currencystring · enumRequiredPossible values:

Responses

201

Account created

application/json

400Error

application/json

500Error

application/json

post

/earn/accounts

HTTPcURLJavaScriptPython

POST /earn/accounts HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "currency": "EUR"
}

{
  "currency": "EUR",
  "activeAmount": "text",
  "blockedAmount": "text",
  "accruedInterest": "text",
  "pendingWithdrawAmount": "text",
  "status": {
    "status": "ACTIVE",
    "reason": "text"
  },
  "allowedDestinations": [
    "CARD"
  ],
  "target": "EARN",
  "userId": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdstring · uuidRequired

Query parameters

unitsstringOptional

Responses

200

Account Withdrawals

application/json

nextstringOptional

countnumberRequired

404Error

application/json

500Error

application/json

get

/earn/accounts/{accountId}/withdrawals

HTTPcURLJavaScriptPython

GET /earn/accounts/{accountId}/withdrawals HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "next": "text",
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "currency": "EUR",
      "withdrawalFee": "text",
      "withdrawalDate": "2026-03-20T13:52:21.726Z",
      "amount": "text",
      "status": "PENDING"
    }
  ],
  "count": 1
}

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdstring · uuidRequired

Body

application/json

amountstringRequired

withdrawalDatestringRequired

Responses

201

Withdrawal created

application/json

400Error

application/json

500Error

application/json

post

/earn/accounts/{accountId}/withdrawals

HTTPcURLJavaScriptPython

POST /earn/accounts/{accountId}/withdrawals HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "amount": "text",
  "withdrawalDate": "text"
}

{
  "success": true
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdstring · uuidRequired

Query parameters

unitsstringOptional

Responses

200

Account

application/json

currencystring · enumRequiredPossible values:

activeAmountstringRequired

blockedAmountstringRequired

accruedIntereststringRequired

pendingWithdrawAmountstringRequired

targetstring · enumRequiredPossible values:

userIdstringRequired

idstring · uuidRequired

404Error

application/json

500Error

application/json

get

/earn/accounts/{accountId}

HTTPcURLJavaScriptPython

GET /earn/accounts/{accountId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "currency": "EUR",
  "activeAmount": "text",
  "blockedAmount": "text",
  "accruedInterest": "text",
  "pendingWithdrawAmount": "text",
  "status": {
    "status": "ACTIVE",
    "reason": "text"
  },
  "allowedDestinations": [
    "CARD"
  ],
  "target": "EARN",
  "userId": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdstring · uuidRequired

Query parameters

unitsstringOptional

Responses

200

Account transactions

application/json

nextstringOptional

countnumberRequired

500Error

application/json

get

/earn/accounts/{accountId}/transactions

HTTPcURLJavaScriptPython

GET /earn/accounts/{accountId}/transactions HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "next": "text",
  "count": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "currency": "EUR",
      "fee": "text",
      "timestamp": "2026-03-20T13:52:21.726Z",
      "amount": "text",
      "type": "EARN"
    }
  ]
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Parameters

application/json

500Error

application/json

get

/earn/accounts/parameters

HTTPcURLJavaScriptPython

GET /earn/accounts/parameters HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "BTC": {
    "interestRate": "text",
    "interestRateGross": "text",
    "weeklyPercentage": "text",
    "weeklyPercentageGross": "text",
    "withdrawalRates": {
      "maxDaysForVariableFee": 1,
      "minLiquidityPeriod": 1,
      "variableFee": 1,
      "fixedFee": 1,
      "minFees": [
        1
      ]
    },
    "withdrawalDailyLimit": "text"
  },
  "ETH": {
    "interestRate": "text",
    "interestRateGross": "text",
    "weeklyPercentage": "text",
    "weeklyPercentageGross": "text",
    "withdrawalRates": {
      "maxDaysForVariableFee": 1,
      "minLiquidityPeriod": 1,
      "variableFee": 1,
      "fixedFee": 1,
      "minFees": [
        1
      ]
    },
    "withdrawalDailyLimit": "text"
  },
  "EUR": {
    "interestRate": "text",
    "interestRateGross": "text",
    "weeklyPercentage": "text",
    "weeklyPercentageGross": "text",
    "withdrawalRates": {
      "maxDaysForVariableFee": 1,
      "minLiquidityPeriod": 1,
      "variableFee": 1,
      "fixedFee": 1,
      "minFees": [
        1
      ]
    },
    "withdrawalDailyLimit": "text"
  },
  "USDC": {
    "interestRate": "text",
    "interestRateGross": "text",
    "weeklyPercentage": "text",
    "weeklyPercentageGross": "text",
    "withdrawalRates": {
      "maxDaysForVariableFee": 1,
      "minLiquidityPeriod": 1,
      "variableFee": 1,
      "fixedFee": 1,
      "minFees": [
        1
      ]
    },
    "withdrawalDailyLimit": "text"
  }
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

currencystring · enumRequiredPossible values:

Responses

200

Parameters

application/json

interestRatestringRequired

interestRateGrossstringRequired

weeklyPercentagestringRequired

weeklyPercentageGrossstringRequired

withdrawalDailyLimitstringRequired

500Error

application/json

get

/earn/accounts/parameters/{currency}

HTTPcURLJavaScriptPython

GET /earn/accounts/parameters/{currency} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "interestRate": "text",
  "interestRateGross": "text",
  "weeklyPercentage": "text",
  "weeklyPercentageGross": "text",
  "withdrawalRates": {
    "maxDaysForVariableFee": 1,
    "minLiquidityPeriod": 1,
    "variableFee": 1,
    "fixedFee": 1,
    "minFees": [
      1
    ]
  },
  "withdrawalDailyLimit": "text"
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200Success

application/json

earnTutorialReadbooleanRequired

earn90TutorialReadbooleanRequired

earn180TutorialReadbooleanRequired

earn360TutorialReadbooleanRequired

500Error

application/json

get

/earn/preferences

HTTPcURLJavaScriptPython

GET /earn/preferences HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "earnTutorialRead": true,
  "earn90TutorialRead": true,
  "earn180TutorialRead": true,
  "earn360TutorialRead": true
}

put

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

earnTutorialReadbooleanOptional

earn90TutorialReadbooleanOptional

earn180TutorialReadbooleanOptional

earn360TutorialReadbooleanOptional

Responses

200Success

application/json

earnTutorialReadbooleanRequired

earn90TutorialReadbooleanRequired

earn180TutorialReadbooleanRequired

earn360TutorialReadbooleanRequired

500Error

application/json

put

/earn/preferences

HTTPcURLJavaScriptPython

PUT /earn/preferences HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "earnTutorialRead": true,
  "earn90TutorialRead": true,
  "earn180TutorialRead": true,
  "earn360TutorialRead": true
}

{
  "earnTutorialRead": true,
  "earn90TutorialRead": true,
  "earn180TutorialRead": true,
  "earn360TutorialRead": true
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

investmentIdstring · uuidRequired

Query parameters

unitsstringOptional

Responses

200

Investment

application/json

currencystring · enumRequiredPossible values:

dateEndstring · date-timeRequired

dateFirstRewardstring · date-timeRequired

statusstring · enumRequiredPossible values:

timesRewardedstringRequired

userIdstringRequired

idstring · uuidRequired

productstring · enumRequiredPossible values:

autorenewalbooleanRequiredDefault: false

amountstringRequired

dateStartstring · date-timeRequired

expectedAmountstringRequired

numberOfRewardsstringRequired

apystringRequired

apyGrossstringRequired

roistringRequired

roiGrossstringRequired

weeklyRewardstringRequired

500Error

application/json

get

/earn/investments/{investmentId}

HTTPcURLJavaScriptPython

GET /earn/investments/{investmentId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "currency": "EUR",
  "dateEnd": "2026-03-20T13:52:21.726Z",
  "dateFirstReward": "2026-03-20T13:52:21.726Z",
  "status": "COMPLETED",
  "timesRewarded": "text",
  "userId": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "product": "EARN_90",
  "autorenewal": false,
  "amount": "text",
  "dateStart": "2026-03-20T13:52:21.726Z",
  "expectedAmount": "text",
  "numberOfRewards": "text",
  "apy": "text",
  "apyGross": "text",
  "roi": "text",
  "roiGross": "text",
  "weeklyReward": "text"
}

patch

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

investmentIdstring · uuidRequired

Body

application/json

autorenewbooleanRequired

Responses

200

Investment updated

application/json

currencystring · enumRequiredPossible values:

dateEndstring · date-timeRequired

dateFirstRewardstring · date-timeRequired

statusstring · enumRequiredPossible values:

timesRewardedstringRequired

userIdstringRequired

idstring · uuidRequired

productstring · enumRequiredPossible values:

autorenewalbooleanRequiredDefault: false

amountstringRequired

dateStartstring · date-timeRequired

expectedAmountstringRequired

numberOfRewardsstringRequired

apystringRequired

apyGrossstringRequired

roistringRequired

roiGrossstringRequired

weeklyRewardstringRequired

400Error

application/json

404Error

application/json

500Error

application/json

patch

/earn/investments/{investmentId}

HTTPcURLJavaScriptPython

PATCH /earn/investments/{investmentId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "autorenew": true
}

{
  "currency": "EUR",
  "dateEnd": "2026-03-20T13:52:21.726Z",
  "dateFirstReward": "2026-03-20T13:52:21.726Z",
  "status": "COMPLETED",
  "timesRewarded": "text",
  "userId": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "product": "EARN_90",
  "autorenewal": false,
  "amount": "text",
  "dateStart": "2026-03-20T13:52:21.726Z",
  "expectedAmount": "text",
  "numberOfRewards": "text",
  "apy": "text",
  "apyGross": "text",
  "roi": "text",
  "roiGross": "text",
  "weeklyReward": "text"
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

currencystring · enumOptionalPossible values:

unitsstringOptional

nextstringOptional

limitstringOptional

Responses

200

Investments

application/json

nextstringOptional

countnumberRequired

500Error

application/json

get

/earn/investments

HTTPcURLJavaScriptPython

GET /earn/investments HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "next": "text",
  "count": 1,
  "data": [
    {
      "currency": "EUR",
      "dateEnd": "2026-03-20T13:52:21.726Z",
      "dateFirstReward": "2026-03-20T13:52:21.726Z",
      "status": "COMPLETED",
      "timesRewarded": "text",
      "userId": "text",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "product": "EARN_90",
      "autorenewal": false,
      "amount": "text",
      "dateStart": "2026-03-20T13:52:21.726Z",
      "expectedAmount": "text",
      "numberOfRewards": "text",
      "apy": "text",
      "apyGross": "text",
      "roi": "text",
      "roiGross": "text",
      "weeklyReward": "text"
    }
  ]
}

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

amountstringRequired

autorenewalbooleanRequiredDefault: false

currencystring · enumRequiredPossible values:

offerIdstringRequired

rewardIdstringOptional

Responses

201

Investment created

application/json

400Error

application/json

500Error

application/json

post

/earn/investments

HTTPcURLJavaScriptPython

POST /earn/investments HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 89

{
  "amount": "text",
  "autorenewal": false,
  "currency": "EUR",
  "offerId": "text",
  "rewardId": "text"
}

{
  "currency": "EUR",
  "dateEnd": "2026-03-20T13:52:21.726Z",
  "dateFirstReward": "2026-03-20T13:52:21.726Z",
  "status": "COMPLETED",
  "timesRewarded": "text",
  "userId": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "product": "EARN_90",
  "autorenewal": false,
  "amount": "text",
  "dateStart": "2026-03-20T13:52:21.726Z",
  "expectedAmount": "text",
  "numberOfRewards": "text",
  "apy": "text",
  "apyGross": "text",
  "roi": "text",
  "roiGross": "text",
  "weeklyReward": "text"
}

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

currencystring · enumOptionalPossible values:

Responses

200

Offers

application/json

countnumberRequired

500Error

application/json

get

/earn/investments/offers

HTTPcURLJavaScriptPython

GET /earn/investments/offers HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "product": "EARN_90",
      "currency": "EUR",
      "minDepositAmount": "text",
      "apy": "text",
      "roi": "text",
      "roiGross": "text",
      "apyGross": "text",
      "numberOfRewards": "text",
      "id": "text",
      "dateStart": "2026-03-20T13:52:21.726Z",
      "dateEnd": "2026-03-20T13:52:21.726Z"
    }
  ],
  "count": 1
}