Skip to main content

DegenScore Public API (1.0)

Download OpenAPI specification:Download

DegenScore Team: [email protected]

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

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.",
  • "traits": {
    },
  • "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

Content type
application/json
{
  • "beacons": [
    ],
  • "meta": {
    }
}

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

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.",
  • "properties": {
    }
}

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.",
  • "traits": {
    },
  • "updatedAt": "2022-11-16T15:13:28Z",
  • "isConfirmed": true,
}

List Beacons Response

Array of objects (Item)
object (Meta)
{
  • "beacons": [
    ],
  • "meta": {
    }
}

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.",
  • "properties": {
    }
}