API reference

Savings

Locked savings, check-ins and referral growth.

Overview

Savings locks move wallet funds into a time-locked balance for a fixed number of days. Locks can be broken early, subject to the configured penalty. Growth endpoints cover daily check-in rewards, milestone acknowledgement and referral status.

Creating a lock debits the wallet immediately and credits it back on maturity.
Referral bonuses remain permanently locked and are never spendable.

Not implemented

Do not build against these

Savings goals / plans catalogue
Interest accrual schedules

Endpoints

9 operations available to your account.

getMyReferralStatus

Bearer token required

Referral code, invitees and locked bonus.

Endpoint

GET/_serverFn/getMyReferralStatus

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X GET https://centuryvtu.com/_serverFn/getMyReferralStatus \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -G

Runs against Production using your own signed-in session. No shared or secret credential is used.

getPendingMilestones

Bearer token required

Milestones awaiting acknowledgement.

Endpoint

GET/_serverFn/getPendingMilestones

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X GET https://centuryvtu.com/_serverFn/getPendingMilestones \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -G

Runs against Production using your own signed-in session. No shared or secret credential is used.

ackMilestone

Bearer token required

Acknowledge a milestone.

Endpoint

POST/_serverFn/ackMilestone

Request body

Field	Type	Required
threshold	number	Yes

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X POST https://centuryvtu.com/_serverFn/ackMilestone \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"data":{"threshold":500}}'

Example response

{ ok: true }

getCheckinStatus

Bearer token required

Daily check-in status.

Endpoint

GET/_serverFn/getCheckinStatus

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X GET https://centuryvtu.com/_serverFn/getCheckinStatus \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -G

Runs against Production using your own signed-in session. No shared or secret credential is used.

claimCheckin

Bearer token required

Claim today's check-in.

Endpoint

POST/_serverFn/claimCheckin

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X POST https://centuryvtu.com/_serverFn/claimCheckin \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

withdrawCheckin

Bearer token required

Withdraw accrued check-in bonus.

Endpoint

POST/_serverFn/withdrawCheckin

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X POST https://centuryvtu.com/_serverFn/withdrawCheckin \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

listSavingsLocks

Bearer token required

List savings locks.

Endpoint

GET/_serverFn/listSavingsLocks

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X GET https://centuryvtu.com/_serverFn/listSavingsLocks \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -G

Runs against Production using your own signed-in session. No shared or secret credential is used.

createSavingsLock

Bearer token required

Lock funds for N days.

Endpoint

POST/_serverFn/createSavingsLock

Request body

Field	Type	Required
amount	number	Yes
days	number	Yes

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X POST https://centuryvtu.com/_serverFn/createSavingsLock \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"data":{"amount":500,"days":500}}'

Example response

{ ok: true }

breakSavingsLock

Bearer token required

Break a savings lock early.

Endpoint

POST/_serverFn/breakSavingsLock

Request body

Field	Type	Required
lockId	uuid	Yes

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X POST https://centuryvtu.com/_serverFn/breakSavingsLock \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"data":{"lockId":"00000000-0000-0000-0000-000000000000"}}'

Example response

{ ok: true }