DegenScore Public API (1.0)

Download OpenAPI specification:Download

This public API can be used by anyone who wants to integrate the DegenScore Beacon in their product or wants to read Beacon Data.

BeaconService

API to fetch data about degenscore Beacons

Get Beacon Info

path Parameters

beaconAddress

required

string

Responses

Response Schema: application/json

name	string General name for the DegenScore Beacon
description	string Description for the DegenScore Beacon
image	string URL of the Beacon image
	object Do not use! Only for ERC1155 compatibility. Contains the scores of the beacon Traits.
updatedAt	string <date-time> Timestamp of when the user last updated the beacon
external_url	string Link to the beacon page on degenscore.com
animation_url	string URL of the animated beacon image
	object Contains the Beacon traits.

Response samples

200
default

Content type

application/json

{"name": "string",
"description": "string",
"image": "string",
"properties": {"property1": 0,
"property2": 0
},
"updatedAt": "2019-08-24T14:15:22Z",
"external_url": "string",
"animation_url": "string",
"traits": {"property1": {"name": "DegenScore Trait - DegenScore",
"description": "How good of a crypto user are you? The DegenScore stands for how good of a crypto user you are: mastery of protocols,risk taking skills,winning and helping others win across crypto. The score is calculated using your on-chain history across the addresses privately bundled in your Beacon.",
"score": 500,
"metadata": {"degenscore": {"updatedAt": "2023-05-10T16:33:40Z"
},
"actions": {"actions": [{"name": "Uniswap V3 Top 1% user",
"description": "According to Uniswap V3 on-chain usage, this user ranks in the top 1%",
"actionTier": "ACTION_TIER_COMMON"
}
]
},
"activity": {"title": "Reasonably active Blockspace Lord",
"rank": "RANK_LEGENDARY",
"categoryMetric": {"frequency": "METRIC_BOTLIKE",
"variety": "METRIC_BOTLIKE",
"gasSpent": "METRIC_BOTLIKE",
"rush": "METRIC_BOTLIKE"
}
},
"friendTech": {"handle": "DegenScore",
"keyPriceEth": "0.01",
"holders": "5",
"selfOwnedKeys": "2",
"topHolders": [{"handle": "VitalikButerin",
"keyCount": "3",
"address": "0x0521fa0bf785ae9759c7cb3cbe7512ebf20fbdaa"
}
],
"address": "0x0521fa0bf785ae9759c7cb3cbe7512ebf20fbdaa"
}
}
},
"property2": {"name": "DegenScore Trait - DegenScore",
"description": "How good of a crypto user are you? The DegenScore stands for how good of a crypto user you are: mastery of protocols,risk taking skills,winning and helping others win across crypto. The score is calculated using your on-chain history across the addresses privately bundled in your Beacon.",
"score": 500,
"metadata": {"degenscore": {"updatedAt": "2023-05-10T16:33:40Z"
},
"actions": {"actions": [{"name": "Uniswap V3 Top 1% user",
"description": "According to Uniswap V3 on-chain usage, this user ranks in the top 1%",
"actionTier": "ACTION_TIER_COMMON"
}
]
},
"activity": {"title": "Reasonably active Blockspace Lord",
"rank": "RANK_LEGENDARY",
"categoryMetric": {"frequency": "METRIC_BOTLIKE",
"variety": "METRIC_BOTLIKE",
"gasSpent": "METRIC_BOTLIKE",
"rush": "METRIC_BOTLIKE"
}
},
"friendTech": {"handle": "DegenScore",
"keyPriceEth": "0.01",
"holders": "5",
"selfOwnedKeys": "2",
"topHolders": [{"handle": "VitalikButerin",
"keyCount": "3",
"address": "0x0521fa0bf785ae9759c7cb3cbe7512ebf20fbdaa"
}
],
"address": "0x0521fa0bf785ae9759c7cb3cbe7512ebf20fbdaa"
}
}
}
}
}

List Beacons

query Parameters

limit	integer <int32> Default: "10" Limit for pagination. (Max 200)
cursor	string Cursor from previous page

Responses

Response Schema: application/json

	Array of objects (Item)
	object (Meta)

Response samples

200
default

Content type

application/json

{"beacons": [{"address": "0x0000000000000000000000000000000000000000",
"traits": {"degen_score": "1380"
},
"updatedAt": "2022-11-15T18:45:02Z"
},
{"address": "0x0000000000000000000000000000000000000001",
"primaryTraits": {"degen_score": "1250"
},
"updatedAt": "2022-11-15T21:10:09Z"
}
],
"meta": {"nextCursor": "eyJ0cyI6IjIwMjItMTEtMTVUMjE6MTA6MDlaIn0"
}
}

Get Trait Info

path Parameters

traitId

required

string

Responses

Response Schema: application/json

name	string Name of the trait
description	string The description of the trait
image	string The image URL of the trait
id	string The api ID of the trait

Response samples

200
default

Content type

application/json

{"name": "DegenScore Trait - DegenScore",
"description": "How good of a crypto user are you?\nThe DegenScore stands for how good of a crypto user you are: mastery of protocols, risk taking skills, winning and helping others win across crypto.\nThe score is calculated using your on-chain history across the addresses privately bundled in your Beacon.",
"image": "https://cdn.degenscore.com/beacon/score_trait.png",
"properties": {"valueType": "TRAIT_VALUE_TYPE_SCORE"
}
}

Beacon Info Response

name	string General name for the DegenScore Beacon
description	string Description for the DegenScore Beacon
image	string URL of the Beacon image
	object Do not use! Only for ERC1155 compatibility. Contains the scores of the beacon Traits.
updatedAt	string <date-time> Timestamp of when the user last updated the beacon
external_url	string Link to the beacon page on degenscore.com
animation_url	string URL of the animated beacon image
	object Contains the Beacon traits.

{"name": "string",
"description": "string",
"image": "string",
"properties": {"property1": 0,
"property2": 0
},
"updatedAt": "2019-08-24T14:15:22Z",
"external_url": "string",
"animation_url": "string",
"traits": {"property1": {"name": "DegenScore Trait - DegenScore",
"description": "How good of a crypto user are you? The DegenScore stands for how good of a crypto user you are: mastery of protocols,risk taking skills,winning and helping others win across crypto. The score is calculated using your on-chain history across the addresses privately bundled in your Beacon.",
"score": 500,
"metadata": {"degenscore": {"updatedAt": "2023-05-10T16:33:40Z"
},
"actions": {"actions": [{"name": "Uniswap V3 Top 1% user",
"description": "According to Uniswap V3 on-chain usage, this user ranks in the top 1%",
"actionTier": "ACTION_TIER_COMMON"
}
]
},
"activity": {"title": "Reasonably active Blockspace Lord",
"rank": "RANK_LEGENDARY",
"categoryMetric": {"frequency": "METRIC_BOTLIKE",
"variety": "METRIC_BOTLIKE",
"gasSpent": "METRIC_BOTLIKE",
"rush": "METRIC_BOTLIKE"
}
},
"friendTech": {"handle": "DegenScore",
"keyPriceEth": "0.01",
"holders": "5",
"selfOwnedKeys": "2",
"topHolders": [{"handle": "VitalikButerin",
"keyCount": "3",
"address": "0x0521fa0bf785ae9759c7cb3cbe7512ebf20fbdaa"
}
],
"address": "0x0521fa0bf785ae9759c7cb3cbe7512ebf20fbdaa"
}
}
},
"property2": {"name": "DegenScore Trait - DegenScore",
"description": "How good of a crypto user are you? The DegenScore stands for how good of a crypto user you are: mastery of protocols,risk taking skills,winning and helping others win across crypto. The score is calculated using your on-chain history across the addresses privately bundled in your Beacon.",
"score": 500,
"metadata": {"degenscore": {"updatedAt": "2023-05-10T16:33:40Z"
},
"actions": {"actions": [{"name": "Uniswap V3 Top 1% user",
"description": "According to Uniswap V3 on-chain usage, this user ranks in the top 1%",
"actionTier": "ACTION_TIER_COMMON"
}
]
},
"activity": {"title": "Reasonably active Blockspace Lord",
"rank": "RANK_LEGENDARY",
"categoryMetric": {"frequency": "METRIC_BOTLIKE",
"variety": "METRIC_BOTLIKE",
"gasSpent": "METRIC_BOTLIKE",
"rush": "METRIC_BOTLIKE"
}
},
"friendTech": {"handle": "DegenScore",
"keyPriceEth": "0.01",
"holders": "5",
"selfOwnedKeys": "2",
"topHolders": [{"handle": "VitalikButerin",
"keyCount": "3",
"address": "0x0521fa0bf785ae9759c7cb3cbe7512ebf20fbdaa"
}
],
"address": "0x0521fa0bf785ae9759c7cb3cbe7512ebf20fbdaa"
}
}
}
}
}

List Beacons Response

	Array of objects (Item)
	object (Meta)

{"beacons": [{"address": "0x0000000000000000000000000000000000000000",
"traits": {"degen_score": "1380"
},
"updatedAt": "2022-11-15T18:45:02Z"
},
{"address": "0x0000000000000000000000000000000000000001",
"primaryTraits": {"degen_score": "1250"
},
"updatedAt": "2022-11-15T21:10:09Z"
}
],
"meta": {"nextCursor": "eyJ0cyI6IjIwMjItMTEtMTVUMjE6MTA6MDlaIn0"
}
}

Trait Info Response

name	string Name of the trait
description	string The description of the trait
image	string The image URL of the trait
id	string The api ID of the trait

{"name": "DegenScore Trait - DegenScore",
"description": "How good of a crypto user are you?\nThe DegenScore stands for how good of a crypto user you are: mastery of protocols, risk taking skills, winning and helping others win across crypto.\nThe score is calculated using your on-chain history across the addresses privately bundled in your Beacon.",
"image": "https://cdn.degenscore.com/beacon/score_trait.png",
"properties": {"valueType": "TRAIT_VALUE_TYPE_SCORE"
}
}

DegenScore Trait

updatedAt

string <date-time>

The timestamp of when the trait was last updated

{"updatedAt": "2023-05-10T16:33:40Z"
}

Actions Trait

Array of objects (A on-chain action of this user)

Actions of this beacon owner

Array

name	string Name of the action
description	string The description of the action
actionTier	string (ActionTier) Enum: "ACTION_TIER_COMMON" "ACTION_TIER_UNCOMMON" "ACTION_TIER_RARE" "ACTION_TIER_EPIC" "ACTION_TIER_LEGENDARY"

{"actions": [{"name": "Uniswap V3 Top 1% user",
"description": "According to Uniswap V3 on-chain usage, this user ranks in the top 1%",
"actionTier": "ACTION_TIER_COMMON"
}
]
}

Activity Trait

title	string The title according to the users activity
rank	string (Rank) Enum: "RANK_LEGENDARY" "RANK_EPIC" "RANK_RARE" "RANK_COMMON"
	object (CategoryMetric)

{"title": "Reasonably active Blockspace Lord",
"rank": "RANK_LEGENDARY",
"categoryMetric": {"frequency": "METRIC_BOTLIKE",
"variety": "METRIC_BOTLIKE",
"gasSpent": "METRIC_BOTLIKE",
"rush": "METRIC_BOTLIKE"
}
}