👤User Routes

Documentation for the Stelo Finance user routes

The /user routes are used for retrieving/updating any personal account information.

User Route Auth

All routes in /user utilize the user auth, please refer to Auth to learn more.

General user routes

Update username

PUT https://api.stelo.finance/user/username

Update your account's username.

Request Body

Name	Type	Description
username*	string	2-32 characters, alphanum

400: Bad Request

G000: Invalid JSON Body

U000: Username Taken

200: OK Username updated

Update password

PUT https://api.stelo.finance/user/password

Update your account's password.

Request Body

Name	Type	Description
password*	string	8-32 characters

400: Bad Request

G000: Invalid JSON Body

U000: Username Taken

200: OK Password updated

Update primary wallet

PUT https://api.stelo.finance/user/wallet

Update your account's primary wallet. This is the wallet you'll log into by default and the wallet that funds will arrive in if sent to your username.

Request Body

Name	Type	Description
wallet_id*	integer

400: Bad Request

G000: Invalid JSON Body

W000: Wallet Not Found

U003: User Not Found

200: OK Primary wallet updated

Get wallets

GET https://api.stelo.finance/user/wallets

Get a list of the wallets you own.

200: OK List of wallets owned

[
    {
        "id": 0,
        "address": "string",
        "user_id": 0
    }
]

Get assigned wallets

GET https://api.stelo.finance/user/assigned_wallets

Get a list of the wallets you are assigned to.

200: OK List of assigned wallets

[
    {
        "id": 0,
        "address": "string",
        "user_id": 0
    }
]

Create Wallet

POST https://api.stelo.finance/user/wallets

Create a new wallet on your account.

Request Body

Name	Type	Description
address	string	3-24 characters, alpha, lowercase. Must be unique to any other wallet. If left out, a random address will be chosen.

400: Bad Request

G000: Invalid JSON Body

201: Created Wallet created

{
    "message": "string",
    "address": "string"
}

Handling account session(s)

Update active wallet

PUT https://api.stelo.finance/user/session/wallet

Update your session's active wallet.

Request Body

Name	Type	Description
wallet_id*	integer

400: Bad Request

G000: Invalid JSON Body

200: OK Active wallet updated

404: Not Found

W000: Wallet Not Found

Get user session info

GET https://api.stelo.finance/user/session

Get info related to your currently active session.

200: OK Details of current session

{
    "user_id": 0,
    "username": "string",
    "primary_wallet_id": 0,
    "wallet_id": 0,
    "wallet_user_id": 0,
    "wallet_address": "string"
}

Get user sessions

GET https://api.stelo.finance/user/sessions

Get a list of your currently active user sessions.

200: OK List of active user sessions

[
  {
    "id": 0,
    "user_id": 0,
    "wallet_id": 0
  }
]

Delete current session

DELETE https://api.stelo.finance/user/session

Delete your current session, and remove the session cookie (sign out).

200: OK Current session deleted

Delete specific session

DELETE https://api.stelo.finance/user/sessions/{sessionid}

Delete a specific session.

Path Parameters

Name	Type	Description
sessionid*	integer

200: OK Session deleted

404: Not Found

U004: Session Not Found

Delete all sessions

DELETE https://api.stelo.finance/user/sessions

Delete all your user sessions including your current one (sign out everywhere).

200: OK All sessions deleted