Introduction

Ethos API Documentation

Welcome to the official API documentation for Ethos Network. This documentation provides detailed information about the Ethos API endpoints, request/response formats, and data models.

⚠️ Generated by LLM

This documentation was generated by AI and is guaranteed to be incorrect and out of date. It is here only as an example reference so people can explore. The Ethos APIs are still evolving rapidly.

🚨 Ethos is not responsible if you mess up your account or lose money because you used this API documentation.

Getting Started

Ethos offers a comprehensive RESTful API that allows developers to interact with the Ethos Network. The API is organized around standard HTTP methods and uses standard HTTP response codes.

Whitepaper

For a complete overview of the Ethos Network, including its mechanisms and governance model, please refer to the Ethos Whitepaper.

Base URL

All API requests should be made to the following base URL:

https://api.ethos.network

Authentication

Most API endpoints require authentication using Privy authentication tokens. Include the token in the Authorization header:

Authorization: Bearer <your_privy_token>

API Overview

The Ethos API is organized into the following sections:

• Activities: Retrieve activities such as vouches, reviews, attestations, and invitations
• Addresses: Manage user addresses
• Attestations: Query service verifications and attestations
• Categories: Manage user categories
• Claim: Handle XP claims and Twitter integration
• Contracts: Get contract addresses
• Contributions: Manage user contributions
• Curated Lists: Manage curated user lists
• ENS: Resolve ENS names and addresses
• Events: Process blockchain events
• Exchange Rates: Get ETH price information
• Fees: Get information about Ethos fees
• Invitations: Query and manage invitations
• Markets: Access reputation market data
• Notifications: Manage user notifications
• Profiles: Access and manage user profiles
• Replies: Query comment replies
• Reviews: Query and manage user reviews
• Scores: Access user credibility scores and history
• Search: Search for profiles, users, etc.
• Signatures: Handle creation of signed messages (attestations, addresses, slashes)
• Slashes: Query and manage slashes
• Twitter: Access Twitter-related user information
• Users: Access user data and statistics
• Vouches: Query and manage vouches between users
• XP: Manage and query user experience points (XP)