Yup Docs
English
Search…
⌃K

Score API

The Yup Score provides a reputation metric for every EVM/Ethereum address by aggregating their on-chain actions and ranking them between 1-100. The weight of each action is determined by its social value. Base URL: https://api.yup.io
Request
Score Response Example
Adapters Structure
Method
Endpoint
Description
GET
/score?address={ENS or ETH address}
Returns a reputation score from 0-100 for an EVM address or ENS name Query params: {address} - any EVM address or ENS
GET
/score/weights
Returns a json object with the current weights, names, and values
Rate limits: 50 requests per minute, per IP
Scores TTL: currently scores are refreshed after 1 day
{
"data":{
"id":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"yup_score":86,
"expiration":"2022-06-02T03:14:55.836652Z",
"last_updated":"2022-06-01T03:14:55.836652Z",
"score_data":{
"score":86.37999570482314,
"ens":{
"score":53.8,
"primary":"vitalik.eth",
"domains":[
{
"name":"vbuterin.eth",
"owner":{
"id":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
}
},
...
],
"count":19
},
"eth_balance": {
"score": 100,
"balance": 4092.474632847039,
"chain_id": "1"
},
"eth_nfts":{
"score":100,
"foundation":0,
"bayc":0,
"superrare":0,
"ens":3
},
"gnosis_nfts":{
"score":25,
"poap":47,
"kudos":0
},
"polygon_nfts":{
"score":100,
"ud":0,
"git":0
},
"polygon_balance":{
"score":78.51598768715968,
"balance":39.25799384357984,
"chain_id":"137"
},
"eth_activity":{
"score":100,
"activity":692.3058773187234
},
"eth_age":{
"score":100,
"age":638.1378441765851
},
"eth_txn_count":{
"score":90.5,
"count":805
},
"recent_polygon_transfers":{
"score":0,
"start_period":27779705,
"end_period":29017311,
"related_addresses":[],
"chain":"137"
},
"recent_eth_transfers":{
"score":100,
"start_period":14689484,
"end_period":14882507,
"related_addresses":[
"vitalik.eth",
"dingaling.eth",
"ʕ◕ᴥ◕ʔ.eth",
"0x5ea9681c3ab9b5739810f8b91ae65ec47de62119",
"tim.eth"
],
"chain":"1"
},
"eth_erc20_tokens":{
"score":100,
"tokens_held":11
},
"snapshot_votes":{
"score":0,
"votes":null,
"count":0
},
"poh":{
"registered":false
},
"partial":false
},
"score_weights":{
"ens":0.14,
"eth_balance":0.15,
"polygon_balance":0.15,
"polygon_nfts":0.16,
"gnosis_nfts":0.064,
"eth_nfts":0.096,
"eth_activity":0.08,
"recent_polygon_transfers":0.04,
"recent_eth_transfers":0.04,
"snapshot_votes":0.04,
"eth_erc20_tokens":0.04
}
}
}
Score *float64 `json:"yup_score"`
Ens *EnsResult `json:"ens"`
EthBalance *NativeBalanceResult `json:"eth_balance"`
EthNfts *NFTEthResult `json:"eth_nfts"`
GnosisNFts *NFTGnosisResult `json:"gnosis_nfts"`
PolygonNfts *NFTPolyResult `json:"polygon_nfts"`
PolygonBalance *NativeBalanceResult `json:"polygon_balance"`
EthActivity *EthActivityResult `json:"eth_activity"`
RecentPolyTransfers *RecentTransfersResult `json:"recent_polygon_transfers"`
RecentEthTransfers *RecentTransfersResult `json:"recent_eth_transfers"`
EthERC20Tokens *ETHERC20Result `json:"eth_erc20_tokens"`
Snapshot *SnapshotResult `json:"snapshot_votes"`
PoH *PoHResult `json:"poh"`
Partial bool `json:"partial"`

Adapters

Description

Each adapter calculates a score based on an accounts onchain activity. Adapter scores are weighted and summed to generate the final Yup score.
Adapters Description
Adapters Impact
Adapter
Description
ENS
retrieves ENS domains held
Ethereum Balance
retrieves Ethereum balance
Polygon Balance
retrieves Polygon balance
Ethereum NFTs
retrieves Ethereum NFTs held
Gnosis NFTs
retrieves Gnosis (xDai) NFTs held
Polygon NFTs
retrieves Polygon NFTs held
Ethereum Activity
retrieves Ethereum tx count and account age
Recent Polygon Transfers
retrieves recent transfers on Polygon and finds related addresses
Recent Ethereum Transfers
retrieves recent transfers on Ethereum and finds related addresses
Ethereum ERC20 Tokens
retrieves ERC20 tokens held
Snapshot
retrieves snapshot vote count
Proof of Humanity (PoH)
retrieves PoH status
Adapter Name
Description
ENS
by weight
Ethereum Balance
by weight
Polygon Balance
by weight
Ethereum NFTs
by weight
Gnosis NFTs
by weight
Polygon NFTs
by weight
Ethereum Activity
by weight
Recent Polygon Transfers
by weight
Recent Ethereum Transfers
by weight
Ethereum ERC20 Tokens
by weight
Snapshot
by weight
Proof of Humanity
boosts total score by 10% if registered