RubyScore Ranking API

Introduction to RubyScore Ranking API

In the Web3 world, efficiency depends on the ability to accurately identify and reward users. But currently, many Web3 projects face challenges related to it. Speculators and bots often receive disproportionate benefits, while real users remain underestimated. These problems hinder the development of projects and the fair distribution of incentives.

RubyScore offers a solution to these problems by effectively identifying and rewarding users for their contributions. RubyScore helps build reputation in Web3 projects through a user contribution system, and creates a unified rating system based on community actions.

How RubyScore API works

The RubyScore ranking API provides tools to filter and rank users based on various parameters. This allows Web3 projects to accurately analyze user activity and make more reasoned.

Using filters in RubyScore API

Filters in the RubyScore API allow you to customize queries to retrieve user data based on various criteria. Below are the main filters and parameters:

Filters

  • Active users

  • Balance in USD

  • Gas spent in USD

  • By networks

  • Number of transactions

  • Rank

  • Top wallets

  • Transaction volume in USD

  • Number of unique contracts

  • Number of active days with transactions

  • Number of active weeks with transactions

  • Number of active months with transactions

Active users filter :

activeUsersFilter[start]=1715853489&activeUsersFilter[end]=1716853489

Example request:

https://rubyscore.io/public_api/get_addresses?activeUsersFilter[start]=1715853489&activeUsersFilter[end]=1715863489

Filter by balance in USD :

balanceUSDFilter[start]=1&balanceUSDFilter[end]=10

Example request:

https://rubyscore.io/public_api/get_addresses?balanceUSDFilter[start]=1&balanceUSDFilter[end]=10

Filter for gas spent in USD :

gasSpentUSDFilter[ start ] = 1 & gasSpentUSDFilter[ end ] = 10

Example request:

https://rubyscore.io/public_api/get_addresses?gasSpentUSDFilter[start]=1&gasSpentUSDFilter[end]=10

Filter by networks :

networkFilter[]=1101&networkFilter[]=324

Example request:

https://rubyscore.io/public_api/get_addresses?networkFilter[]=1101&networkFilter[]=324

Filter by number of transactions :

numberOfTxsFilter[start]=1&numberOfTxsFilter[end]=10

Example request:

https://rubyscore.io/public_api/get_addresses?numberOfTxsFilter[start]=1&numberOfTxsFilter[end]=10

Filter by rank :

rankFilter[start]=1&rankFilter[end]=2

Example request:

https://rubyscore.io/public_api/get_addresses?rankFilter[start]=1&rankFilter[end]=2

Filter by top wallets :

topFilter[start]=0&topFilter[end]=2

Example request:

https://rubyscore.io/public_api/get_addresses?topFilter[start]=0&topFilter[end]=2

Filter by transaction volume in USD :

volumeUSDFilter[start]=1&volumeUSDFilter[end]=10

Example request:

https://rubyscore.io/public_api/get_addresses?volumeUSDFilter[start]=1&volumeUSDFilter[end]=10

Filter by number of unique contracts :

uniqueContractsFilter[start]=1&uniqueContractsFilter[end]=10

Example request:

https://rubyscore.io/public_api/get_addresses?uniqueContractsFilter[start]=1&uniqueContractsFilter[end]=10

Filter by the number of active days with transactions:

txsOnDiffDaysFilter[start]=1&txsOnDiffDaysFilter[end]=10

Example request:

https://rubyscore.io/public_api/get_addresses?txsOnDiffDaysFilter[start]=1&txsOnDiffDaysFilter[end]=10

Filter by the number of active weeks with transactions:

txsOnDiffWeeksFilter[start]=1&txsOnDiffWeeksFilter[end]=10

Example request:

https://rubyscore.io/public_api/get_addresses?txsOnDiffWeeksFilter[start]=1&txsOnDiffWeeksFilter[end]=10

Filter by the number of active months with transactions:

txsOnDiffMonthFilter[start]=1&txsOnDiffMonthFilter[end]=10

Example request:

https://rubyscore.io/public_api/get_addresses?txsOnDiffMonthFilter[start]=1&txsOnDiffMonthFilter[end]=10

Pagination

You can control pagination using the pageand parameters page_size:

  • The parameter pagespecifies the current page (default 1).

  • The parameter page_sizespecifies the number of records per page (default 10, maximum 1500).

Example request:

https://rubyscore.io/public_api/get_addresses?page=2&page_size=20

Conclusion

RubyScore ranking API provides powerful tools for analyzing and segmenting users in Web3 projects. Using our filters, you can gain deeper insight into user behavior, effectively identify genuine contributors, and reward them fairly for it. Start using the RubyScore ranking API today to improve your strategies and drive the growth of your Web3 project.

Last updated