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.ioRequest
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"`
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 |
Last modified 3mo ago