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 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 `true`
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

Content type

application/json

{"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.",
"image": "https://cdn.degenscore.com/beacon/beacon_logo.png",
"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,
"external_url": "https://degenscore.com/beacon/0x0000000000000000000000000000000000000000",
"animation_url": "https://cdn.degenscore.com/beacon/beacon_logo_animated.webm"
}

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",
"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

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 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 `true`
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.",
"image": "https://cdn.degenscore.com/beacon/beacon_logo.png",
"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,
"external_url": "https://degenscore.com/beacon/0x0000000000000000000000000000000000000000",
"animation_url": "https://cdn.degenscore.com/beacon/beacon_logo_animated.webm"
}

List Beacons Response

	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"
}
}

Trait Info Response

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.",
"image": "https://cdn.degenscore.com/beacon/score_trait.png",
"properties": {"valueType": "TRAIT_VALUE_TYPE_SCORE"
}
}