Internal

Get user by embedded wallet

get

⚠️ Warning: This is an internal endpoint. It is not guaranteed to be stable and may change or break without notice.

Path parameters

addressstringRequired

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/internal/users/embedded-wallet/{address}

HTTPcURLJavaScriptPython

GET /api/v2/internal/users/embedded-wallet/{address} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "user": {
    "id": 1,
    "profileId": 1,
    "displayName": "text",
    "username": "text",
    "avatarUrl": "https://example.com",
    "description": "text",
    "score": 1,
    "status": "ACTIVE",
    "userkeys": [
      "text"
    ],
    "xpTotal": 1,
    "xpStreakDays": 1,
    "xpRemovedDueToAbuse": true,
    "influenceFactor": 1,
    "influenceFactorPercentile": 1,
    "mommyPawnshopBingo": "REQUESTED",
    "links": {
      "profile": "https://example.com",
      "scoreBreakdown": "https://example.com"
    },
    "stats": {
      "review": {
        "received": {
          "negative": 1,
          "neutral": 1,
          "positive": 1
        }
      },
      "vouch": {
        "given": {
          "amountWeiTotal": 1,
          "count": 1
        },
        "received": {
          "amountWeiTotal": 1,
          "count": 1
        }
      }
    }
  },
  "profile": {
    "id": 1,
    "archived": true,
    "createdAt": 1,
    "updatedAt": 1,
    "invitesAvailable": 1,
    "invitedBy": 1
  },
  "inviterUser": {
    "id": 1,
    "profileId": 1,
    "displayName": "text",
    "username": "text",
    "avatarUrl": "https://example.com",
    "description": "text",
    "score": 1,
    "status": "ACTIVE",
    "userkeys": [
      "text"
    ],
    "xpTotal": 1,
    "xpStreakDays": 1,
    "xpRemovedDueToAbuse": true,
    "influenceFactor": 1,
    "influenceFactorPercentile": 1,
    "mommyPawnshopBingo": "REQUESTED",
    "links": {
      "profile": "https://example.com",
      "scoreBreakdown": "https://example.com"
    },
    "stats": {
      "review": {
        "received": {
          "negative": 1,
          "neutral": 1,
          "positive": 1
        }
      },
      "vouch": {
        "given": {
          "amountWeiTotal": 1,
          "count": 1
        },
        "received": {
          "amountWeiTotal": 1,
          "count": 1
        }
      }
    }
  },
  "allAddresses": {
    "addresses": [
      "text"
    ],
    "primaryAddress": "text",
    "embeddedWallet": "text",
    "smartWallet": "text"
  },
  "attestations": [
    {
      "id": 1,
      "hash": "text",
      "archived": true,
      "profileId": 1,
      "service": "discord",
      "account": "text",
      "createdAt": 1,
      "extra": {
        "username": "text",
        "url": "https://example.com"
      }
    }
  ],
  "isValidator": true
}

Get user by userkey

get

⚠️ Warning: This is an internal endpoint. It is not guaranteed to be stable and may change or break without notice.

Path parameters

userkeystringRequired

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/internal/users/{userkey}

HTTPcURLJavaScriptPython

GET /api/v2/internal/users/{userkey} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "user": {
    "id": 1,
    "profileId": 1,
    "displayName": "text",
    "username": "text",
    "avatarUrl": "https://example.com",
    "description": "text",
    "score": 1,
    "status": "ACTIVE",
    "userkeys": [
      "text"
    ],
    "xpTotal": 1,
    "xpStreakDays": 1,
    "xpRemovedDueToAbuse": true,
    "influenceFactor": 1,
    "influenceFactorPercentile": 1,
    "mommyPawnshopBingo": "REQUESTED",
    "links": {
      "profile": "https://example.com",
      "scoreBreakdown": "https://example.com"
    },
    "stats": {
      "review": {
        "received": {
          "negative": 1,
          "neutral": 1,
          "positive": 1
        }
      },
      "vouch": {
        "given": {
          "amountWeiTotal": 1,
          "count": 1
        },
        "received": {
          "amountWeiTotal": 1,
          "count": 1
        }
      }
    }
  },
  "profile": {
    "id": 1,
    "archived": true,
    "createdAt": 1,
    "updatedAt": 1,
    "invitesAvailable": 1,
    "invitedBy": 1
  },
  "inviterUser": {
    "id": 1,
    "profileId": 1,
    "displayName": "text",
    "username": "text",
    "avatarUrl": "https://example.com",
    "description": "text",
    "score": 1,
    "status": "ACTIVE",
    "userkeys": [
      "text"
    ],
    "xpTotal": 1,
    "xpStreakDays": 1,
    "xpRemovedDueToAbuse": true,
    "influenceFactor": 1,
    "influenceFactorPercentile": 1,
    "mommyPawnshopBingo": "REQUESTED",
    "links": {
      "profile": "https://example.com",
      "scoreBreakdown": "https://example.com"
    },
    "stats": {
      "review": {
        "received": {
          "negative": 1,
          "neutral": 1,
          "positive": 1
        }
      },
      "vouch": {
        "given": {
          "amountWeiTotal": 1,
          "count": 1
        },
        "received": {
          "amountWeiTotal": 1,
          "count": 1
        }
      }
    }
  },
  "allAddresses": {
    "addresses": [
      "text"
    ],
    "primaryAddress": "text",
    "embeddedWallet": "text",
    "smartWallet": "text"
  },
  "attestations": [
    {
      "id": 1,
      "hash": "text",
      "archived": true,
      "profileId": 1,
      "service": "discord",
      "account": "text",
      "createdAt": 1,
      "extra": {
        "username": "text",
        "url": "https://example.com"
      }
    }
  ],
  "isValidator": true
}

Get internal listings

get

⚠️ Warning: This is an internal endpoint. It is not guaranteed to be stable and may change or break without notice.

Query parameters

userkeystringOptional

yearnumberOptional

periodnumberOptional

topMoversDaysnumber · min: 1 · max: 90OptionalDefault: 1

limitinteger · max: 100OptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/internal/listings

HTTPcURLJavaScriptPython

GET /api/v2/internal/listings HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "projects": [
    {
      "id": 1,
      "userkey": "text",
      "status": "ACTIVE",
      "bannerImageUrl": "https://example.com",
      "isPromoted": true,
      "description": "text",
      "createdAt": "text",
      "updatedAt": "text",
      "user": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "mommyPawnshopBingo": "REQUESTED",
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          }
        }
      },
      "votes": {
        "bullish": {
          "topVoters": [
            {
              "id": 1,
              "profileId": 1,
              "displayName": "text",
              "username": "text",
              "avatarUrl": "https://example.com",
              "description": "text",
              "score": 1,
              "status": "ACTIVE",
              "userkeys": [
                "text"
              ],
              "xpTotal": 1,
              "xpStreakDays": 1,
              "xpRemovedDueToAbuse": true,
              "influenceFactor": 1,
              "influenceFactorPercentile": 1,
              "mommyPawnshopBingo": "REQUESTED",
              "links": {
                "profile": "https://example.com",
                "scoreBreakdown": "https://example.com"
              },
              "stats": {
                "review": {
                  "received": {
                    "negative": 1,
                    "neutral": 1,
                    "positive": 1
                  }
                },
                "vouch": {
                  "given": {
                    "amountWeiTotal": 1,
                    "count": 1
                  },
                  "received": {
                    "amountWeiTotal": 1,
                    "count": 1
                  }
                }
              }
            }
          ],
          "total": 1,
          "uniqueVoters": 1
        },
        "bearish": {
          "topVoters": [
            {
              "id": 1,
              "profileId": 1,
              "displayName": "text",
              "username": "text",
              "avatarUrl": "https://example.com",
              "description": "text",
              "score": 1,
              "status": "ACTIVE",
              "userkeys": [
                "text"
              ],
              "xpTotal": 1,
              "xpStreakDays": 1,
              "xpRemovedDueToAbuse": true,
              "influenceFactor": 1,
              "influenceFactorPercentile": 1,
              "mommyPawnshopBingo": "REQUESTED",
              "links": {
                "profile": "https://example.com",
                "scoreBreakdown": "https://example.com"
              },
              "stats": {
                "review": {
                  "received": {
                    "negative": 1,
                    "neutral": 1,
                    "positive": 1
                  }
                },
                "vouch": {
                  "given": {
                    "amountWeiTotal": 1,
                    "count": 1
                  },
                  "received": {
                    "amountWeiTotal": 1,
                    "count": 1
                  }
                }
              }
            }
          ],
          "total": 1,
          "uniqueVoters": 1
        },
        "all": {
          "total": 1,
          "uniqueVoters": 1
        }
      },
      "categories": [
        {
          "id": 1,
          "name": "text",
          "slug": "text",
          "description": "text"
        }
      ],
      "chains": [
        {
          "id": 1,
          "name": "text",
          "url": "https://example.com",
          "iconUrl": "https://example.com"
        }
      ],
      "commentCount": 1,
      "currentUserVoteHistory": {
        "bullishVotesSpent": 1,
        "bearishVotesSpent": 1
      }
    }
  ],
  "total": 1,
  "topMovers": [
    {
      "id": 1,
      "userkey": "text",
      "status": "ACTIVE",
      "bannerImageUrl": "https://example.com",
      "isPromoted": true,
      "description": "text",
      "createdAt": "text",
      "updatedAt": "text",
      "user": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "mommyPawnshopBingo": "REQUESTED",
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          }
        }
      },
      "categories": [
        {
          "id": 1,
          "name": "text",
          "slug": "text",
          "description": "text"
        }
      ],
      "chains": [
        {
          "id": 1,
          "name": "text",
          "url": "https://example.com",
          "iconUrl": "https://example.com"
        }
      ],
      "commentCount": 1,
      "links": [
        {
          "type": "WEBSITE",
          "url": "https://example.com"
        }
      ],
      "percentagePointChange": 1
    }
  ]
}

Get project details by username for listings page

get

⚠️ Warning: This is an internal endpoint. It is not guaranteed to be stable and may change or break without notice.

Path parameters

usernamestringRequired

Query parameters

topVotersLimitnumber · max: 100OptionalDefault: 3

yearnumberOptional

periodnumberOptional

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/internal/listings/{username}

HTTPcURLJavaScriptPython

GET /api/v2/internal/listings/{username} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "project": {
    "id": 1,
    "userkey": "text",
    "status": "ACTIVE",
    "bannerImageUrl": "https://example.com",
    "isPromoted": true,
    "description": "text",
    "createdAt": "text",
    "updatedAt": "text",
    "user": {
      "id": 1,
      "profileId": 1,
      "displayName": "text",
      "username": "text",
      "avatarUrl": "https://example.com",
      "description": "text",
      "score": 1,
      "status": "ACTIVE",
      "userkeys": [
        "text"
      ],
      "xpTotal": 1,
      "xpStreakDays": 1,
      "xpRemovedDueToAbuse": true,
      "influenceFactor": 1,
      "influenceFactorPercentile": 1,
      "mommyPawnshopBingo": "REQUESTED",
      "links": {
        "profile": "https://example.com",
        "scoreBreakdown": "https://example.com"
      },
      "stats": {
        "review": {
          "received": {
            "negative": 1,
            "neutral": 1,
            "positive": 1
          }
        },
        "vouch": {
          "given": {
            "amountWeiTotal": 1,
            "count": 1
          },
          "received": {
            "amountWeiTotal": 1,
            "count": 1
          }
        }
      }
    },
    "categories": [
      {
        "id": 1,
        "name": "text",
        "slug": "text",
        "description": "text"
      }
    ],
    "chains": [
      {
        "id": 1,
        "name": "text",
        "url": "https://example.com",
        "iconUrl": "https://example.com"
      }
    ],
    "commentCount": 1,
    "links": [
      {
        "type": "WEBSITE",
        "url": "https://example.com"
      }
    ]
  },
  "topVoters": {
    "bullish": {
      "topVoters": [
        {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "mommyPawnshopBingo": "REQUESTED",
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            }
          }
        }
      ],
      "total": 1,
      "uniqueVoters": 1
    },
    "bearish": {
      "topVoters": [
        {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "mommyPawnshopBingo": "REQUESTED",
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            }
          }
        }
      ],
      "total": 1,
      "uniqueVoters": 1
    },
    "all": {
      "total": 1,
      "uniqueVoters": 1
    }
  },
  "currentUsersVotes": {
    "balance": {
      "bullishVotesRemaining": 1,
      "bearishVotesRemaining": 1,
      "bullishVotesSpent": 1,
      "bearishVotesSpent": 1,
      "allocationResetDate": "text"
    },
    "projectHistory": {
      "bullishVotesSpent": 1,
      "bearishVotesSpent": 1
    }
  },
  "team": [
    {
      "id": 1,
      "profileId": 1,
      "displayName": "text",
      "username": "text",
      "avatarUrl": "https://example.com",
      "description": "text",
      "score": 1,
      "status": "ACTIVE",
      "userkeys": [
        "text"
      ],
      "xpTotal": 1,
      "xpStreakDays": 1,
      "xpRemovedDueToAbuse": true,
      "influenceFactor": 1,
      "influenceFactorPercentile": 1,
      "mommyPawnshopBingo": "REQUESTED",
      "links": {
        "profile": "https://example.com",
        "scoreBreakdown": "https://example.com"
      },
      "stats": {
        "review": {
          "received": {
            "negative": 1,
            "neutral": 1,
            "positive": 1
          }
        },
        "vouch": {
          "given": {
            "amountWeiTotal": 1,
            "count": 1
          },
          "received": {
            "amountWeiTotal": 1,
            "count": 1
          }
        }
      }
    }
  ]
}

Get trending users for homepage

get

⚠️ Warning: This is an internal endpoint. It is not guaranteed to be stable and may change or break without notice.

Query parameters

limitinteger · max: 100OptionalDefault: 10

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/internal/trending-users

HTTPcURLJavaScriptPython

GET /api/v2/internal/trending-users HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "user": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "mommyPawnshopBingo": "REQUESTED",
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          }
        }
      },
      "stats": {
        "reviews": {
          "received": 1,
          "positiveReviewPercentage": 1,
          "positiveReviewCount": 1,
          "negativeReviewCount": 1,
          "neutralReviewCount": 1
        },
        "vouches": {
          "given": {
            "amountWeiTotal": 1,
            "count": 1
          },
          "received": {
            "amountWeiTotal": 1,
            "count": 1
          }
        }
      },
      "source": "review"
    }
  ]
}

Get trending news like top vouchers

get

⚠️ Warning: This is an internal endpoint. It is not guaranteed to be stable and may change or break without notice.

Responses

200

Successful response

application/json

500

Internal server error

application/json

get

/internal/trending-news

HTTPcURLJavaScriptPython

GET /api/v2/internal/trending-news HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "topVouches": []
}