How to listen to the balance of the Stake Key address in using Telegram, Discord

Allows users to connect via API to receive information on changes to the Cardano blockchain stake balance about Telegram and Discord

Read more: https://docs.dconecrypto.finance/community-user/wallets-tracking-notify
Document Github: https://github.com/DCOneCrypto/StakeAddress-Tracking-Telegram-Discord

Note: Create an account before using the APIs

Create an account: Mainnet https://dconecrypto.finance

Note: Website direct menu (please login before):

Live: Mainnet Telegram: https://dconecrypto.finance/DC_TelegramWallets
Live: Mainnet Discord: https://dconecrypto.finance/DC_DiscordWallets

REST API

Network: Mainnet Endpoint: https://dconecrypto-mainnet.dconecrypto.finance

Credentials when using API

Authorization: Bearer {{accessToken}}

Authenticate

Example api request:

Required field:
- userNameOrEmailAddress (login account name) ,
- password (login password)

curl --location '{{domain}}/api/TokenAuth/Authenticate' \
--header 'Content-Type: application/json' \
--data '{
  "userNameOrEmailAddress": "",
  "password": "",
  "rememberClient": true
}'

Example api Authenticate responses

{
  "accessToken": "string",
  "encryptedAccessToken": "string",
  "expireInSeconds": 0,
  "shouldResetPassword": true,
  "passwordResetCode": "string",
  "userId": 0,
  "requiresTwoFactorVerification": true,
  "twoFactorAuthProviders": ["string"],
  "twoFactorRememberClientToken": "string",
  "returnUrl": "string",
  "refreshToken": "string",
  "refreshTokenExpireInSeconds": 0
}

Telegram API

Get userId by token. (GetAllUserForTableDropdown)

Get the userId variable and put in the userId input parameter in the "CreateOrEdit" api

Example api request:

curl --location '{{domain}}/api/services/app/DC_TelegramWallets/GetAllUserForTableDropdown' \
--header 'Authorization: Bearer {{accessToken}}' \
--data ''

Example api response:

{
  "result": [
    {
      "id": 1,
      "displayName": "dconecrypto"
    }
  ],
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

Send security code "CodeOTP" to Telegram. (TelegramSendOTP)

Security code is 6 digits long & valid for 2 minutes
Required fields to enter
- telegramId (get telegramId https://t.me/DCOneCryptoBot)
- stakeAddress (stakexxxxxxxxxxxxxxxxxxxxx)
- userId (get userId at API GetAllUserForTableDropdown)

Example api request:

curl --location '{{domain}}/api/services/app/DC_TelegramWallets/TelegramSendOTP' \
--header 'Authorization: Bearer {{accessToken}}' \
--data '{
  "telegramId": 806901872,
  "stakeAddress": "stake1782cckupa4zyp95edhghqwegr5spyglt7dsu5wpqsrkdaxcmhyjr5",
  "userId": 1,
  "telegramCodeOTP": "",
  "id": ""
}'

Example api response:

{
  "result": null,
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

Create a new connection to track balance via Telegram. (CreateOrEdit)

When a payment is detected in the stake address, it will be sent information to Telegram

Required fields to enter
- telegramId (get telegramId https://t.me/DCOneCryptoBot)
- stakeAddress (stakexxxxxxxxxxxxxxxxxxxxx)
- userId (get userId at API GetAllUserForTableDropdown)
- telegramCodeOTP (security code sent via Telegram at API TelegramSendOTP)

Example api request:

curl --location '{{domain}}/api/services/app/DC_TelegramWallets/CreateOrEdit' \
--header 'Authorization: Bearer {{accessToken}}' \
--data '{
  "telegramId": 806901872,
  "stakeAddress": "stake1782cckupa4zyp95edhghqwegr5spyglt7dsu5wpqsrkdaxcmhyjr5",
  "userId": 1,
  "telegramCodeOTP": "473653",
  "id": ""
}'

Example api response:

{
  "result": null,
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

Delete stake address balance connection tracking via Telegram. (Delete)

Required fields to enter
- Id (the Id field is taken from the API GetAll)

Example api request:

curl --location --request DELETE '{{domain}}/api/services/app/DC_TelegramWallets/Delete?Id=0b28648a-4e35-4670-e92b-08db2ba3d184' \
--header 'Authorization: Bearer {{accessToken}}' \
--data ''

Example api response:

{
  "result": null,
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

List of Telegram connections (GetAll)

Get a list of all Telegram connected to the system

Example api request:

curl --location '{{domain}}/api/services/app/DC_TelegramWallets/GetAll' \
--header 'Authorization: Bearer {{accessToken}}' \
--data ''

Example api response:

{
  "result": {
    "totalCount": 1,
    "items": [
      {
        "dC_TelegramWallet": {
          "telegramId": 806901872,
          "stakeAddress": "stake1782cckupa4zyp95edhghqwegr5spyglt7dsu5wpqsrkdaxcmhyjr5",
          "userId": 1,
          "id": "0b28648a-4e35-4670-e92b-08db2ba3d184"
        },
        "userName": "dconecrypto"
      }
    ]
  },
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

Discord API

Get userId by token. (GetAllUserForTableDropdown)

Get the userId variable and put in the userId input parameter in the "CreateOrEdit" api

Example api request:

curl --location '{{domain}}/api/services/app/DC_DiscordWallets/GetAllUserForTableDropdown' \
--header 'Authorization: Bearer {{accessToken}}' \
--data ''

Example api response:

{
  "result": [
    {
      "id": 1,
      "displayName": "dconecrypto"
    }
  ],
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

Send security code "CodeOTP" to Discord. (DiscordWebhookSendOTP)

Security code is 6 digits long & valid for 2 minutes
Required fields to enter
- discordId (your display name)
- stakeAddress (stakexxxxxxxxxxxxxxxxxxxxx)
- webhookUrl (webhook address is taken from discord channel settings)
- discordStatus (notification on/off status)
- userId (get userId at API GetAllUserForTableDropdown)

Example api request:

curl --location '{{domain}}/api/services/app/DC_DiscordWallets/DiscordWebhookSendOTP' \
--header 'Authorization: Bearer {{accessToken}}' \
--header 'Content-Type: application/json' \
--data '{
    "discordId": "Your display name",
    "stakeAddress": "stake1782cckupa4zyp95edhghqwegr5spyglt7dsu5wpqsrkdaxcmhyjr5",
    "webhookUrl": "https://discord.com/api/webhooks/1079715947830579231/5Yi-I3Anq1SMrjIz6Ka5SfcuhSpRi4Lz0rXIdc7pO7VpVV34fPSgFYZS6utkTqcQ30ur",
    "discordStatus": true,
    "userId": 1,
    "discordCodeOTP": "",
    "id": ""
}'

Example api response:

{
  "result": null,
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

Create a new connection to track balance via Discord. (CreateOrEdit)

When a payment is detected in the stake address, it will be sent information to Discord

Required fields to enter
- discordId (your display name)
- stakeAddress (stakexxxxxxxxxxxxxxxxxxxxx)
- webhookUrl (webhook address is taken from discord channel settings)
- discordStatus (notification on/off status)
- userId (get userId at API GetAllUserForTableDropdown)
- discordCodeOTP (security code sent via Discord at API DiscordWebhookSendOTP)

Example api request:

curl --location '{{domain}}/api/services/app/DC_DiscordWallets/CreateOrEdit' \
--header 'Authorization: Bearer {{accessToken}}' \
--header 'Content-Type: application/json' \
--data '{
    "discordId": "Your display name",
    "stakeAddress": "stake1782cckupa4zyp95edhghqwegr5spyglt7dsu5wpqsrkdaxcmhyjr5",
    "webhookUrl": "https://discord.com/api/webhooks/1079715947830579231/5Yi-I3Anq1SMrjIz6Ka5SfcuhSpRi4Lz0rXIdc7pO7VpVV34fPSgFYZS6utkTqcQ30ur",
    "discordStatus": true,
    "userId": 1,
    "discordCodeOTP": "310379",
    "id": ""
}'

Example api response:

{
  "result": null,
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

Delete stake address balance connection tracking via Discord. (Delete)

Required fields to enter
- Id (the Id field is taken from the API GetAll)

Example api request:

curl --location --request DELETE '{{domain}}/api/services/app/DC_DiscordWallets/Delete?Id=719893f4-e3d4-410a-6803-08db262d5910' \
--header 'Authorization: Bearer {{accessToken}}' \
--data ''

Example api response:

{
  "result": null,
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

List of Discord connections (GetAll)

Get a list of all Discord connected to the system

Example api request:

curl --location '{{domain}}/api/services/app/DC_DiscordWallets/GetAll' \
--header 'Authorization: Bearer {{accessToken}}' \
--data ''

Example api response:

{
  "result": {
    "totalCount": 1,
    "items": [
      {
        "dC_DiscordWallet": {
          "discordId": "DCOne Crypto",
          "stakeAddress": "stake1782cckupa4zyp95edhghqwegr5spyglt7dsu5wpqsrkdaxcmhyjr5",
          "webhookUrl": "https://discord.com/api/webhooks/1079715947830579231/5Yi-I3Anq1SMrjIz6Ka5SfcuhSpRi4Lz0rXIdc7pO7VpVV34fPSgFYZS6utkTqcQ30ur",
          "discordStatus": true,
          "userId": 1,
          "id": "719893f4-e3d4-410a-6803-08db262d5910"
        },
        "userName": "dconecrypto"
      }
    ]
  },
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

Example success response:

{
  "result": null,
  "targetUrl": null,
  "success": true,
  "error": null,
  "unAuthorizedRequest": false,
  "__abp": true
}

Example error response:

{
  "result": null,
  "targetUrl": null,
  "success": false,
  "error": {
    "code": 0,
    "message": "Wallet address already exists",
    "details": null,
    "validationErrors": null
  },
  "unAuthorizedRequest": false,
  "__abp": true
}

{
  "result": null,
  "targetUrl": null,
  "success": false,
  "error": {
    "code": 0,
    "message": "Discord code otp error",
    "details": null,
    "validationErrors": null
  },
  "unAuthorizedRequest": false,
  "__abp": true
}

Some sample data results sent to Telegram, Discord

Automatically send notifications when there is a balance change
List of all stake addresses
Automatically send notifications when there is a balance change

1 contributors

DCOne Cryptocontributed March 24, 2023

Would you like to suggest changes to this developer resource?

We encourage you to actively participate in the creation and moderation of our content—your contributions are invaluable. All content is reviewed by another community member.

Suggest edit