X-Payment Twitter

Note zachys (atomic units) are 10^6 in X-Cash
Stats
This method gets the stats
URL: https://api.xcash.foundation/v1/xpayment-twitter/twitter/unauthorized/stats/​
Method: GET
Inputs: None.
Results:
totalUsers - unsigned int; Total users registered.
avgTipAmount - unsigned int; Average tip amount sent in zachys (atomic units).
totalDeposits - unsigned int; Total deposits.
totalWithdraws - unsigned int; Total withdraws.
totalTipsPublic - unsigned int; Total public tips sent.
totalTipsPrivate - unsigned int; Total private tips sent.
totalVolumeSentPublic - unsigned long long; Total volume sent for public tips, in zachys (atomic units).
totalVolumeSentPrivate - unsigned long long; Total volume sent for private tips, in zachys (atomic units).
totalTipsLastDayPublic - unsigned int; Total public tips sent in last day.
totalTipsLastDayPrivate - unsigned int; Total private tips sent in last day.
totalVolumeSentLastDayPublic - unsigned long long; Total volume sent for public tips in last day, in zachys (atomic units).
totalVolumeSentLastDayPrivate - unsigned long long; Total volume sent for private tips in last day, in zachys (atomic units).
totalTipsLastHourPublic - unsigned int; Total public tips sent in last hour.
totalTipsLastHourPrivate - unsigned int; Total private tips sent in last hour.
totalVolumeSentLastHourPublic - unsigned long long; Total volume sent for public tips in last hour, in zachys (atomic units).
totalVolumeSentLastHourPrivate - unsigned long long; Total volume sent for private tips in last hour, in zachys (atomic units).
$ curl -X GET https://api.xcash.foundation/v1/xpayment-twitter/twitter/unauthorized/stats/ -H 'Accept: application/json'
{
  "totalUsers": 7,
  "avgTipAmount": 10,
  "totalDeposits": 5,
  "totalWithdraws": 17,
  "totalTipsPublic": 7,
  "totalTipsPrivate": 10,
  "totalVolumeSentPublic": 500000000,
  "totalVolumeSentPrivate": 1000000000,
  "totalTipsLastDayPublic": 7,
  "totalTipsLastDayPrivate": 10,
  "totalVolumeSentLastDayPublic": 500000000,
  "totalVolumeSentLastDayPrivate": 1000000000,
  "totalTipsLastHourPublic": 7,
  "totalTipsLastHourPrivate": 10,
  "totalVolumeSentLastHourPublic": 500000000,
  "totalVolumeSentLastHourPrivate": 1000000000
}
Stats Per Day
This method gets the daily amount of payments and volumes sent per day
URL: https://api.xcash.foundation/v1/xpayment-twitter/twitter/unauthorized/statsPerDay/{start}/{limit}​
Method: GET
Resources:
start - Required - The start day to return data (Default is 1, the first start day).
limit - Required - The maximum amount of days to return (Default is all).
Inputs: None.
Results:
Array of objects with the following structure:
time - unsigned int; Total users registered.
amount - unsigned long long; Total tips sent.
volume - unsigned long long; Total volume sent in zachys (atomic units).
$ curl -X GET https://api.xcash.foundation/v1/xpayment-twitter/twitter/unauthorized/statsPerDay/1/2/ -H 'Accept: application/json'
[
  {
    "time": 1654228489,
    "amount": 100,
    "volume": 100000000
  },
  {
    "time": 1654228489,
    "amount": 100,
    "volume": 100000000
  }
]
Top Stats
This method gets the top users for tips and volume
URL: https://api.xcash.foundation/v1/xpayment-twitter/twitter/unauthorized/topStats/{amount}​
Method: GET
Resources:
amount - not required - The amount of items to return (Default is 10).
Inputs: None.
Results:
topTips - Array of objects with the following structure:
username - string; The username.
tips - unsigned int; Total tips sent.
topVolumes - Array of objects with the following structure:
username - string; The username.
volume - unsigned long long; Total volume sent in zachys (atomic units).
$ curl -X GET https://api.xcash.foundation/v1/xpayment-twitter/twitter/unauthorized/topStats/2 -H 'Accept: application/json'
{
  "topTips": [
    {
      "username": "test1",
      "tips": 105
    },
    {
      "username": "test2",
      "tips": 100
    }
  ],
  "topVolumes": [
    {
      "username": "test1",
      "volume": 105000000
    },
    {
      "username": "test2",
      "volume": 100000000
    }
  ]
}
Recent Tips
This method gets the recent tips
URL: https://api.xcash.foundation/v1/xpayment-twitter/twitter/unauthorized/recentTips/{amount}​
Method: POST
Resources:
amount - not required - The amount of items to return (Default is 10).
Inputs (All are required):
sort - "First" for most recent tips, "Last" for the least recent tips.
type - "Public" for only public transactions, "Private" for only private transactions, "All" for both.
Results:
Array of objects with the following structure:
tweetId - string; The tweet id.
fromUser - string; The username who sent the tip.
toUser - string; The username who received the tip.
amount - unsigned long long; The anount of the tip in zachys (atomic units).
time - unsigned int; The time.
type - string; The tip type.
$ curl -X POST https://api.xcash.foundation/v1/xpayment-twitter/twitter/unauthorized/recentTips/2 -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Content-Type: application/json'  -d '{"sort":"First","type":"All"}'
[
  {
    "tweetId": "",
    "fromUser": "",
    "toUser": "",
    "amount": 0,
    "time": 1654204410,
    "type": "private"
  },
  {
    "tweetId": "1531918830276075521",
    "fromUser": "test1",
    "toUser": "test",
    "amount": 5000000,
    "time": 1654195778,
    "type": "public"
  }
]

API - Previous

Namespace

Next - Applications & Tools

Interacting with the network

Last modified 1mo ago

Export as PDF

Copy link

Outline