Score API

Base URL: http://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
1
{
2
   "data":{
3
      "id":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
4
      "score":86,
5
      "expiration":"2022-06-02T03:14:55.836652Z",
6
      "last_updated":"2022-06-01T03:14:55.836652Z",
7
      "score_data":{
8
         "score":86.37999570482314,
9
         "ens":{
10
            "score":53.8,
11
            "primary":"vitalik.eth",
12
            "domains":[
13
               {
14
                  "name":"vbuterin.eth",
15
                  "owner":{
16
                     "id":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
17
                  }
18
               },
19
               ...
20
            ],
21
            "count":19
22
         },
23
         "eth_balance": {
24
            "score": 100,
25
            "balance": 4092.474632847039,
26
            "chain_id": "1"
27
         },
28
         "eth_nfts":{
29
            "score":100,
30
            "foundation":0,
31
            "bayc":0,
32
            "superrare":0,
33
            "ens":3
34
         },
35
         "gnosis_nfts":{
36
            "score":25,
37
            "poap":47,
38
            "kudos":0
39
         },
40
         "polygon_nfts":{
41
            "score":100,
42
            "ud":0,
43
            "git":0
44
         },
45
         "polygon_balance":{
46
            "score":78.51598768715968,
47
            "balance":39.25799384357984,
48
            "chain_id":"137"
49
         },
50
         "eth_activity":{
51
            "score":100,
52
            "activity":692.3058773187234
53
         },
54
         "eth_age":{
55
            "score":100,
56
            "age":638.1378441765851
57
         },
58
         "eth_txn_count":{
59
            "score":90.5,
60
            "count":805
61
         },
62
         "recent_polygon_transfers":{
63
            "score":0,
64
            "start_period":27779705,
65
            "end_period":29017311,
66
            "related_addresses":[],
67
            "chain":"137"
68
         },
69
         "recent_eth_transfers":{
70
            "score":100,
71
            "start_period":14689484,
72
            "end_period":14882507,
73
            "related_addresses":[
74
               "vitalik.eth",
75
               "dingaling.eth",
76
               "ʕ◕ᴥ◕ʔ.eth",
77
               "0x5ea9681c3ab9b5739810f8b91ae65ec47de62119",
78
               "tim.eth"
79
            ],
80
            "chain":"1"
81
         },
82
         "eth_erc20_tokens":{
83
            "score":100,
84
            "tokens_held":11
85
         },
86
         "snapshot_votes":{
87
            "score":0,
88
            "votes":null,
89
            "count":0
90
         },
91
         "poh":{
92
            "registered":false
93
         },
94
         "partial":false
95
      },
96
      "score_weights":{
97
         "ens":0.14,
98
         "eth_balance":0.15,
99
         "polygon_balance":0.15,
100
         "polygon_nfts":0.16,
101
         "gnosis_nfts":0.064,
102
         "eth_nfts":0.096,
103
         "eth_activity":0.08,
104
         "recent_polygon_transfers":0.04,
105
         "recent_eth_transfers":0.04,
106
         "snapshot_votes":0.04,
107
         "eth_erc20_tokens":0.04
108
      }
109
   }
110
}
Copied!
1
 Score               *float64               `json:"score"`
2
 Ens                 *EnsResult             `json:"ens"`
3
 EthBalance          *NativeBalanceResult   `json:"eth_balance"`
4
 EthNfts             *NFTEthResult          `json:"eth_nfts"`
5
 GnosisNFts          *NFTGnosisResult       `json:"gnosis_nfts"`
6
 PolygonNfts         *NFTPolyResult         `json:"polygon_nfts"`
7
 PolygonBalance      *NativeBalanceResult   `json:"polygon_balance"`
8
 EthActivity         *EthActivityResult     `json:"eth_activity"`
9
 RecentPolyTransfers *RecentTransfersResult `json:"recent_polygon_transfers"`
10
 RecentEthTransfers  *RecentTransfersResult `json:"recent_eth_transfers"`
11
 EthERC20Tokens      *ETHERC20Result        `json:"eth_erc20_tokens"`
12
 Snapshot            *SnapshotResult        `json:"snapshot_votes"`
13
 PoH                 *PoHResult             `json:"poh"`
14
 Partial             bool                   `json:"partial"`
Copied!
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
Protocol - Previous
Yup API
Next - Protocol
Liquidity Providers
Last modified 25d ago
Copy link
Contents
Adapters
Description