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.
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 Beacon traits. (Primary Traits and Secondary Traits) | |
updatedAt | string <date-time> Timestamp of when the user last updated the beacon |
isConfirmed | boolean Indicates if the Beacon traits were successfully committed unchain. Integrators should always check if this value is |
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. (Primary Traits and Secondary Traits) |
Response samples
- 200
- default
{- "name": "DegenScore Beacon",
- "description": "The DegenScore Beacon is an Ethereum soulbound token that highlights your on-chain skills & traits across one or more wallets.\nUse it to leverage your on-chain reputation in the DegenScore Cafe and across web3.",
- "traits": {
- "degen_score": {
- "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.",
- "value": "500",
- "valueType": "TRAIT_VALUE_TYPE_SCORE",
- "traitType": "TRAIT_TYPE_PRIMARY",
- "rarity": "TRAIT_RARITY_COMMON",
- "tags": [
- {
- "id": "PROTOCOL_NAME",
- "value": "DegenScore Trait - DegenScore"
}
]
}, - "top_user_uniswap_v3": {
- "name": "Uniswap V3 top 10% user",
- "description": "According to Uniswap V3 on-chain usage,this user ranks in the top 10%",
- "value": "10",
- "valueType": "TRAIT_VALUE_TYPE_PERCENTAGE_RANK",
- "traitType": "TRAIT_TYPE_SECONDARY",
- "rarity": "TRAIT_RARITY_EPIC",
- "tags": [
- {
- "id": "PROTOCOL_NAME",
- "value": "Uniswap V3"
}
]
}
}, - "updatedAt": "2022-11-16T15:13:28Z",
- "isConfirmed": true,
}
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
{- "beacons": [
- {
- "address": "0x0000000000000000000000000000000000000000",
- "primaryTraits": {
- "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 |
object (Properties) |
Response samples
- 200
- default
{- "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.",
- "properties": {
- "valueType": "TRAIT_VALUE_TYPE_SCORE"
}
}
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 Beacon traits. (Primary Traits and Secondary Traits) | |
updatedAt | string <date-time> Timestamp of when the user last updated the beacon |
isConfirmed | boolean Indicates if the Beacon traits were successfully committed unchain. Integrators should always check if this value is |
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. (Primary Traits and Secondary Traits) |
{- "name": "DegenScore Beacon",
- "description": "The DegenScore Beacon is an Ethereum soulbound token that highlights your on-chain skills & traits across one or more wallets.\nUse it to leverage your on-chain reputation in the DegenScore Cafe and across web3.",
- "traits": {
- "degen_score": {
- "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.",
- "value": "500",
- "valueType": "TRAIT_VALUE_TYPE_SCORE",
- "traitType": "TRAIT_TYPE_PRIMARY",
- "rarity": "TRAIT_RARITY_COMMON",
- "tags": [
- {
- "id": "PROTOCOL_NAME",
- "value": "DegenScore Trait - DegenScore"
}
]
}, - "top_user_uniswap_v3": {
- "name": "Uniswap V3 top 10% user",
- "description": "According to Uniswap V3 on-chain usage,this user ranks in the top 10%",
- "value": "10",
- "valueType": "TRAIT_VALUE_TYPE_PERCENTAGE_RANK",
- "traitType": "TRAIT_TYPE_SECONDARY",
- "rarity": "TRAIT_RARITY_EPIC",
- "tags": [
- {
- "id": "PROTOCOL_NAME",
- "value": "Uniswap V3"
}
]
}
}, - "updatedAt": "2022-11-16T15:13:28Z",
- "isConfirmed": true,
}
Array of objects (Item) | |
object (Meta) |
{- "beacons": [
- {
- "address": "0x0000000000000000000000000000000000000000",
- "primaryTraits": {
- "degen_score": "1380"
}, - "updatedAt": "2022-11-15T18:45:02Z"
}, - {
- "address": "0x0000000000000000000000000000000000000001",
- "primaryTraits": {
- "degen_score": "1250"
}, - "updatedAt": "2022-11-15T21:10:09Z"
}
], - "meta": {
- "nextCursor": "eyJ0cyI6IjIwMjItMTEtMTVUMjE6MTA6MDlaIn0"
}
}
name | string Name of the trait |
description | string The description of the trait |
image | string The image URL of the trait |
object (Properties) |
{- "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.",
- "properties": {
- "valueType": "TRAIT_VALUE_TYPE_SCORE"
}
}