API Documentation
Last updated
Last updated
All the API calls require a pair of API access & secret keys. Please if you wish to get your API keys today. After your account is created, you can log in to .
Currently, there is only one API endpoint which is [<https://api.reputex.io/v1>](<https://api.reputex.io/v1>) .
The API access keys and secret key must be included in all the requests, in the following manner:
{
"X-API-Key": <Insert access key>,
"X-API-Secret": <Insert secret key>
};Sample CURL request
curl -X 'GET' '<https://api.reputex.io/v1/score/exists/0x6C2A780F93Ec560775133f3Ed2ae669744Fe0f49>' \\
-H 'x-api-key: <insert access key>'
-H 'x-api-secret : <insert secret key>'This API endpoint returns the score for the address provided.
Request
GET /score/breakdown/:addressOrDomain
Query Parameters:
addressOrDomain: The address or the domain must be included as a route param.
Response
{
"success": true,
"data": {
"address": "0x32cb9fd13af7635cc90d0713a80188b366a28205",
"reputeXScore": 48.12,
"legacyReputeXScore": 617.36,
"customScore": 48.12,
"blacklisted": false,
"lastUpdated": "2024-07-19T06:32:50.031Z",
"scoreBreakdown": {
"ethereum": {
"finalScore": 16,
"ethereumContribution": 53.15,
"defiCategoryScore": {
"finalScore": 11,
"aaveScore": 1,
"compoundScore": 0,
"tvlScore": 28,
"curveScore": 0,
"enzymeScore": 0,
"eulerScore": 0,
"lidoScore": 8,
"uniswapScore": 24,
"yearnScore": 0,
"ironBankScore": 0,
"riskScore": 0,
"eigenLayerScore": 42
},
"credibilityCategoryScore": {
"finalScore": 40,
"appsInteractionScore": 34,
"ensScore": 90,
"txHistoryScore": 60,
"udScore": 0,
"gitcoinScore": 20,
"fsaScore": 38
},
"metaCategoryScore": {
"finalScore": 3,
"metaverseScore": 0,
"nftScore": 0,
"nftTradingScore": 18,
"poolTogetherScore": 0,
"sandboxScore": 0
},
"socialImpactScore": {
"finalScore": 0,
"uniswapDaoScore": 0
}
},
"polygon": {
"finalScore": 27,
"polygonContribution": 9.79,
"defiCategoryScore": {
"finalScore": 18,
"aaveScore": 7,
"tvlScore": 16,
"riskScore": 0,
"uniswapScore": 34
},
"credibilityCategoryScore": {
"finalScore": 47,
"appsInteractionScore": 80,
"txHistoryScore": 72,
"udScore": 0,
"fsaScore": 28
},
"metaCategoryScore": {
"finalScore": 0,
"nftScore": 0,
"poolTogetherScore": 0,
"sandboxScore": 0
},
"socialImpactScore": {
"finalScore": 0
}
},
"bsc": {
"finalScore": 23,
"binanceContribution": 6.29,
"defiCategoryScore": {
"finalScore": 9,
"tvlScore": 14,
"venusScore": 0
},
"credibilityCategoryScore": {
"finalScore": 45,
"appsInteractionScore": 60,
"txHistoryScore": 64,
"fsaScore": 18
},
"metaCategoryScore": {
"finalScore": 0,
"nftScore": 0
},
"socialImpactScore": {
"finalScore": 0
}
},
"avalanche": {
"finalScore": 15,
"avalancheContribution": 2.8,
"defiCategoryScore": {
"finalScore": 1,
"aaveScore": 2,
"tvlScore": 0
},
"credibilityCategoryScore": {
"finalScore": 38,
"appsInteractionScore": 42,
"txHistoryScore": 62,
"fsaScore": 12
},
"metaCategoryScore": {
"finalScore": 0,
"nftScore": 0,
"poolTogetherScore": 0
},
"socialImpactScore": {
"finalScore": 0
}
},
"arbitrum": {
"finalScore": 18,
"arbitrumContribution": 6.29,
"defiCategoryScore": {
"finalScore": 11,
"aaveScore": 0,
"tvlScore": 22,
"uniswapScore": 44,
"yearnScore": 0,
"abracadabraScore": 0,
"siloFinanceScore": 0,
"qiDaoScore": 0
},
"credibilityCategoryScore": {
"finalScore": 46,
"appsInteractionScore": 32,
"txHistoryScore": 64,
"fsaScore": 36
},
"metaCategoryScore": {
"finalScore": 0,
"nftScore": 0
}
},
"optimism": {
"finalScore": 23,
"optimismContribution": 4.9,
"defiCategoryScore": {
"finalScore": 11,
"aaveScore": 2,
"tvlScore": 15,
"uniswapScore": 30,
"qiDaoScore": 0,
"sushiSwapScore": 0,
"curveScore": 8,
"sonneFinanceScore": 20
},
"credibilityCategoryScore": {
"finalScore": 44,
"appsInteractionScore": 60,
"txHistoryScore": 68,
"fsaScore": 6
},
"metaCategoryScore": {
"finalScore": 56,
"farcasterScore": 56
}
},
"base": {
"finalScore": 33,
"baseContribution": 4.2,
"defiCategoryScore": {
"finalScore": 24,
"tvlScore": 11,
"aaveScore": 66,
"uniswapScore": 32,
"sushiSwapScore": 0
},
"credibilityCategoryScore": {
"finalScore": 46,
"appsInteractionScore": 66,
"txHistoryScore": 72,
"fsaScore": 6
}
},
"moonbeam": {
"finalScore": 21,
"moonbeamContribution": 2.8,
"defiCategoryScore": {
"finalScore": 20,
"tvlScore": 47,
"curveScore": 0,
"sushiSwapScore": 8,
"moonwellScore": 0
},
"credibilityCategoryScore": {
"finalScore": 30,
"appsInteractionScore": 0,
"txHistoryScore": 46,
"fsaScore": 28
},
"socialImpactScore": {
"finalScore": 0,
"moonwellDaoScore": 0
}
},
"linea": {
"finalScore": 23,
"lineaContribution": 4.2,
"defiCategoryScore": {
"finalScore": 20,
"tvlScore": 15,
"pancakeSwapScore": 22,
"sushiSwapScore": 6,
"syncSwapScore": 48,
"nileExchangeScore": 0,
"iZiSwapScore": 54,
"zeroLendScore": 2
},
"credibilityCategoryScore": {
"finalScore": 45,
"appsInteractionScore": 82,
"txHistoryScore": 64,
"fsaScore": 6
},
"metaCategoryScore": {
"finalScore": 0,
"nftScore": 0
}
},
"zkSyncEra": {
"finalScore": 40,
"zkSyncEraContribution": 5.59,
"defiCategoryScore": {
"finalScore": 36,
"tvlScore": 15,
"pancakeSwapScore": 26,
"syncSwapScore": 56,
"koiFinanceScore": 76,
"iZiSwapScore": 28
},
"credibilityCategoryScore": {
"finalScore": 48,
"appsInteractionScore": 100,
"txHistoryScore": 64,
"fsaScore": 6
}
}
},
"syncBlockNumber": {
"ethereum": 20338800,
"polygon": 59540288,
"bsc": 40602051,
"avalanche": 48156025,
"arbitrum": 233750109,
"optimism": 122885925,
"base": 17290694,
"moonbeam": 6645758,
"linea": 6983742,
"zkSyncEra": 39474682
}
},
"message": "ReputeX Score exists for the address.",
"error": ""
}This API endpoint generates and stores the score for the address provided.
Request
POST /score/create/:addressOrDomain
Query Parameters:
addressOrDomain: The address or the domain must be included as a route param.
Response if the score doesn't exist
{
"success": true,
"data": {
"didResolved": false,
"did": "",
"addressWiseStatus": [
{
"address": "0x643bb72735e4912bd1a194a1c1517a5dcedbbfa8",
"success": true,
"message": "Score successfully updated!"
}
]
},
"message": "OK",
"error": ""
}Response if the score exists
{
"success": false,
"data": null,
"message": "ReputeX Score already exists for given address.",
"error": ""
}This API endpoint updates the score for the address provided.
Request
POST /score/update/:addressOrDomain
Parameters:
addressOrDomain: The address or the domain must be included as a route param.
Response
{
"success": true,
"data": {
"score": 46.77,
"legacyReputeXScore": 615.48
},
"message": "Score successfully updated!",
"error": ""
}Response if the score does not exist
{
"success": false,
"data": null,
"message": "ReputeX Score does not exist for given address.",
"error": ""
}This API endpoint fetches the HODL score for the address provided.
Request
GET /hodl/breakdown/:addressOrDomain
Parameters:
addressOrDomain: The address or the domain must be included as a route param.
Response if the score exists
{
"success": true,
"data": {
"createdAt": "2024-08-20T06:43:18.627Z",
"hodlScore": {
"OneInch": [
{
"network": "BSC",
"finalScore": "-3",
"hodlScore": "-3",
"hodlComputedData": {
"lowestBal": {
"index": 3,
"balance": 0,
"duration": 518
},
"totalDays": 1062,
"avgBalance": 14482442162801.254,
"highestBal": {
"index": 5,
"balance": 43353652853448720000,
"duration": 0
},
"firstTxDate": "2021-09-23T07:42:06.000Z",
"currentBalance": 0,
"zeroBalanceStats": {
"days": 1061,
"count": 5
},
"totalActiveBalanceDays": 1
},
"hodlCoreHodlScore": 3,
"hodlCurrentBalanceScore": 0,
"hodlZeroBalanceScore": -11,
"hodlHighestBalanceScore": 4,
"hodlLowestBalanceScore": 1,
"stakedScore": "0",
"stakedComputedData": {},
"stakedCoreHodlScore": null,
"stakedCurrentBalanceScore": null,
"stakedZeroBalanceScore": null,
"stakedHighestBalanceScore": null,
"stakedLowestBalanceScore": null
}
],
"Compound": [
{
"network": "Ethereum",
"finalScore": "2",
"hodlScore": "2",
"hodlComputedData": {
"lowestBal": {
"index": 1,
"balance": 0,
"duration": 520
},
"totalDays": 520,
"avgBalance": 0,
"highestBal": {
"index": 0,
"balance": 185402503061605730,
"duration": 0
},
"firstTxDate": "2023-03-19T10:34:47.000Z",
"currentBalance": 0,
"zeroBalanceStats": {
"days": 520,
"count": 1
},
"totalActiveBalanceDays": 0
},
"hodlCoreHodlScore": 0,
"hodlCurrentBalanceScore": 0,
"hodlZeroBalanceScore": -7,
"hodlHighestBalanceScore": 4,
"hodlLowestBalanceScore": 5,
"stakedScore": "0",
"stakedComputedData": {},
"stakedCoreHodlScore": null,
"stakedCurrentBalanceScore": null,
"stakedZeroBalanceScore": null,
"stakedHighestBalanceScore": null,
"stakedLowestBalanceScore": null
}
],
"Curve": [
{
"network": "Ethereum",
"finalScore": "-6.4",
"hodlScore": "-8",
"hodlComputedData": {
"lowestBal": {
"index": 2,
"balance": 0,
"duration": 123
},
"totalDays": 520,
"avgBalance": 9780543204735316000,
"highestBal": {
"index": 3,
"balance": 14594163580430404000,
"duration": 1
},
"firstTxDate": "2023-03-19T10:34:47.000Z",
"currentBalance": 0,
"zeroBalanceStats": {
"days": 519,
"count": 6
},
"totalActiveBalanceDays": 1
},
"hodlCoreHodlScore": 3,
"hodlCurrentBalanceScore": 0,
"hodlZeroBalanceScore": -13,
"hodlHighestBalanceScore": 1,
"hodlLowestBalanceScore": 1,
"stakedScore": "0",
"stakedComputedData": null,
"stakedCoreHodlScore": 0,
"stakedCurrentBalanceScore": 0,
"stakedZeroBalanceScore": 0,
"stakedHighestBalanceScore": 0,
"stakedLowestBalanceScore": 0
},
{
"network": "Polygon",
"finalScore": "-3",
"hodlScore": "-3",
"hodlComputedData": {
"lowestBal": {
"index": 1,
"balance": 0,
"duration": 272
},
"totalDays": 519,
"avgBalance": 228080611562219400,
"highestBal": {
"index": 2,
"balance": 236281344133602970000,
"duration": 0
},
"firstTxDate": "2023-03-20T07:07:28.000Z",
"currentBalance": 0,
"zeroBalanceStats": {
"days": 492,
"count": 7
},
"totalActiveBalanceDays": 27
},
"hodlCoreHodlScore": 3,
"hodlCurrentBalanceScore": 0,
"hodlZeroBalanceScore": -13,
"hodlHighestBalanceScore": 7,
"hodlLowestBalanceScore": 0,
"stakedScore": "0",
"stakedComputedData": {},
"stakedCoreHodlScore": null,
"stakedCurrentBalanceScore": null,
"stakedZeroBalanceScore": null,
"stakedHighestBalanceScore": null,
"stakedLowestBalanceScore": null
}
],
"Uniswap": [
{
"network": "Ethereum",
"finalScore": "-4",
"hodlScore": "-4",
"hodlComputedData": {
"lowestBal": {
"index": 1,
"balance": 0,
"duration": 421
},
"totalDays": 520,
"avgBalance": 248116246597692540,
"highestBal": {
"index": 0,
"balance": 1303236850816162800,
"duration": 99
},
"firstTxDate": "2023-03-19T10:34:47.000Z",
"currentBalance": 0,
"zeroBalanceStats": {
"days": 520,
"count": 2
},
"totalActiveBalanceDays": 0
},
"hodlCoreHodlScore": 2,
"hodlCurrentBalanceScore": 0,
"hodlZeroBalanceScore": -8,
"hodlHighestBalanceScore": 2,
"hodlLowestBalanceScore": 0,
"stakedScore": "0",
"stakedComputedData": {},
"stakedCoreHodlScore": null,
"stakedCurrentBalanceScore": null,
"stakedZeroBalanceScore": null,
"stakedHighestBalanceScore": null,
"stakedLowestBalanceScore": null
}
]
}
},
"message": "OK",
"error": ""
}Response if the score does not exist
{
"success": false,
"data": null,
"message": "HODL Score does not exist for given address.",
"error": ""
}This API endpoint creates or updates the HODL score for the address provided.
Request
POST /hodl/create/:addressOrDomain
Parameters:
addressOrDomain: The address or the domain must be included as a route param.
Response
{
"success": true,
"data": null,
"message": "Hodl score has been generated successfully.",
"error": ""
}You are likely to receive the following error messages in case you haven’t set the API key or secret correctly in the header, please cross-check with the documentation provided.
status 401
Unauthorized, access key is not providedstatus 401
Unauthorized, secret key is not providedstatus 401
Unauthorized, api key or secret is not valid.status 401
Unauthorized, access key has been disabled. Contact admin.