Skip to content
Developers
Search
Ctrl
K
Cancel
Ethos on X
GitHub
Select theme
Dark
Light
Auto
Menu
API Documentation
Introduction
API v2
Overview
activities
Overview
/activities/{activityType}/{id}
GET
/activities/bulk
POST
/activities/{activityType}/tx/{txHash}
GET
/activities/userkey
GET
/activities/feed
POST
/activities/notifications
POST
/activities/profile/given
POST
/activities/profile/saved-posts
POST
/activities/profile/received
POST
/activities/profile/all
POST
/activities/project
POST
/activities/slash/{slashId}/impacted-supporters
GET
ai-images
Overview
/ai-images/selected
GET
announcements
Overview
/announcements/active
GET
/announcements/{id}/viewed
POST
api-keys
Overview
/api-keys
GET
/api-keys
POST
/api-keys/{id}
DELETE
apps
Overview
/apps
GET
/apps/{id}
GET
/apps/by-type/{appType}
GET
benefits
Overview
/benefits/limited-time
GET
/benefits/score-based
GET
/benefits/categories
GET
/benefits/{benefitId}/codes/info
GET
/benefits/{benefitId}/codes/claim
POST
broker
Overview
/broker/posts
GET
/broker/me/posts
GET
/broker/posts/{id}
GET
/broker/posts/tx/{txHash}
GET
/broker/posts/{id}/status
PUT
/broker/posts/{id}/archive
PUT
/broker/author/{profileId}/posts
GET
/broker/author/{profileId}/completed-summary
GET
/broker/posts/{id}/report
POST
/broker/preview-premium-image
POST
/broker/posts/{postId}/watch
GET
/broker/posts/{postId}/watch
POST
/broker/posts/{postId}/watch
DELETE
categories
Overview
/categories
GET
/categories/{id}
GET
/categories/summaries/bulk
GET
/categories/{categoryId}/users
GET
chains
Overview
/chains
GET
/chains/base/gas-price
GET
contributions
Overview
/bounty/today
GET
/contributions/history
GET
/contributions/latest-missed-day
GET
/contributions/forgive-self
POST
/contributions/dailies
GET
curators
Overview
/external/curators/me
GET
/external/curators/standings
GET
endorsements
Overview
/endorsements/{targetUserkey}
GET
ens
Overview
/external/ens/{address}
GET
/external/ens/by-name/{name}
GET
event-markers
Overview
/event-markers/active
GET
/event-markers
GET
exchange-rates
Overview
/exchange-rates/eth-price-in-usd
GET
/exchange-rates/whuf-price-in-usd
GET
feature-views
Overview
/feature-views/{featureKey}
GET
/feature-views/{featureKey}/viewed
POST
human-verification
Overview
/human-verification/search
GET
/human-verification/my-verifications
GET
/human-verification/verifications
GET
/human-verification/request
POST
/human-verification/verifiers
GET
/human-verification/{subjectUserkey}
GET
/signatures/humanity-bond
POST
/signatures/self-declared-humanity-bond
POST
internal
Overview
/internal/users/embedded-wallet/{address}
GET
/internal/users/{userkey}
GET
/internal/trending-users
GET
/internal/trending-news
GET
invitations
Overview
/invitations
GET
/invitations/check
GET
/invitations/pending/{address}
GET
/invitations/accepted/{senderProfileId}/tree
GET
karma
Overview
/karma/daily-prizes
GET
/karma/leaderboard
GET
/karma/ledger/{userkey}
GET
/karma/me
GET
/karma/tip
POST
/karma/tips
GET
/karma/tip-allowance
GET
llm
Overview
/llm/translate
POST
/llm/quality
POST
/llm/activity-summary
GET
markets
Overview
/markets
GET
/markets/{profileId}/holders
GET
/markets/{profileId}/price/history
GET
/markets/simulate-sell
GET
/markets/{profileId}/info
POST
/markets/info/bulk
GET
/markets/users/by/address/{address}
GET
/markets/{profileId}/user-votes
GET
/markets/withdrawable
GET
markets-v2
Overview
/markets-v2
GET
/markets-v2/held-markets
GET
/markets-v2/for-subject
GET
/markets-v2/recent-trades
GET
/markets-v2/all-trade-history
GET
/markets-v2/pnl-leaderboard
GET
/markets-v2/portfolio-stats
GET
/markets-v2/open-positions
GET
/markets-v2/{marketOnchainId}
GET
/markets-v2/{marketOnchainId}/trade-history
GET
/markets-v2/{marketOnchainId}/price-history
GET
/markets-v2/{marketOnchainId}/recent-news
GET
/markets-v2/{marketOnchainId}/holders
GET
/markets-v2/{marketOnchainId}/holder-count
GET
/markets-v2/{marketOnchainId}/position
GET
/markets-v2/{marketOnchainId}/position-values
GET
/markets-v2/{marketOnchainId}/simulate-open-position
GET
/markets-v2/{marketOnchainId}/simulate-close-position
GET
notifications
Overview
/notifications/me
GET
/notifications/stats/me
GET
/notifications/me/mark-as-read
POST
/notifications/me/push-registrations
POST
/notifications/me/settings
GET
/notifications/me/settings
PUT
nfts
Overview
/nfts/user/{ethosUserKey}/owns-validator
GET
/nfts/user/{ethosUserKey}/meow-meows
GET
/nfts/user/{ethosUserKey}
GET
/nfts/validators/listings
GET
profiles
Overview
/profiles/addresses
POST
/profiles
POST
/profiles/recent
GET
/profiles/stats
GET
replies
Overview
/replies/by-id
GET
/replies/{replyId}/deep-link-info
GET
/replies/{replyId}/offset
GET
/replies/{contractType}/{parentId}
GET
/replies/{replyId}/pin
PUT
reviews
Overview
/reviews/count/between
GET
/reviews/latest/between
GET
/reviews/id-by-batch
GET
score
Overview
/score/updates
GET
/score/address
GET
/score/addresses
POST
/score/userId
GET
/score/userIds
POST
/score/userkey
GET
/score/userkeys
POST
/score/status
GET
/score/history
GET
signatures
Overview
/signatures/register-address
POST
/solana/transfer-proofs
POST
/solana/transfer-proofs/current
GET
/solana/transfer-proofs/{id}/check
POST
/solana/linked-apps
GET
/solana/linked-apps/signature
POST
slash
Overview
/slash/supporter-penalties/{profileId}
GET
stats
Overview
/stats/score-distribution
GET
/stats/human-verification
GET
system
Overview
/healthcheck
GET
/healthcheck/authenticated
GET
/healthcheck/always-fail
GET
/transactions/{txHash}/processed
GET
users
Overview
/internal/users/embedded-wallet/{address}
GET
/internal/users/{userkey}
GET
/users/by/ids
POST
/users/by/address
POST
/users/by/profile-id
POST
/users/by/x
POST
/users/by/discord
POST
/users/by/telegram
POST
/users/search
GET
/user/{userId}
GET
/user/by/address/{address}
GET
/user/by/ethos-everywhere-wallet/{address}
GET
/user/by/profile-id/{profileId}
GET
/user/by/username/{username}
GET
/user/by/x/{accountIdOrUsername}
GET
/user/by/discord/{discordUserId}
GET
/user/by/farcaster/{farcasterUserId}
GET
/user/by/farcaster/username/{farcasterUsername}
GET
/user/by/telegram/{telegramUserId}
GET
/users/{userkey}/categories
GET
/users/refresh/twitter
POST
/users/me/review-suggestions
GET
/users/me/discover-suggestions
GET
/users/{userkey}/top-quality-wallet
GET
votes
Overview
/votes
GET
/votes/stats
GET
/votes/stats
POST
vouches
Overview
/vouches
POST
/vouches/authored-subject-userkeys
GET
/vouches/authored-details
GET
/vouches/incoming-author-profile-ids
GET
/vouches/pair-state
GET
/vouches/protected/exists
GET
/vouches/protected
GET
/vouches/mutual-vouchers
GET
/vouches/fees
GET
/vouches/v2/fees
GET
wallets
Overview
/auth/exchange
POST
/auth/logout
POST
/wallets/privy/auth-check
GET
/wallets/privy/check-funds
GET
/wallets/privy/post/review
POST
/wallets/privy/post/review/by-address
POST
/wallets/privy/post/review/by-x
POST
/wallets/privy/edit/review
POST
/wallets/activity/{activityType}/{id}/vote
POST
/wallets/activity/{activityType}/{id}/reply
POST
/wallets/activity/review/{id}/archive
POST
/wallets/privy/invite/address
POST
/wallets/privy/invite/cancel
POST
/wallets/activity/bond/{bondId}/archive
POST
/wallets/privy/bonds
POST
/wallets/privy/vouches
POST
/wallets/privy/vouches/unvouch
POST
/wallets/privy/markets/sell
POST
/wallets/privy/markets-v2/open-position
POST
/wallets/privy/markets-v2/close-position
POST
/wallets/privy/markets-v2/create-market
POST
/wallets/privy/whuf/send
POST
/wallets/privy/vouches-v2
POST
/wallets/privy/review-and-vouch-v2
POST
/wallets/privy/vouches-v2/increase
POST
/wallets/privy/vouches-v2/decrease
POST
/wallets/privy/vouches-v2/unvouch
POST
/wallets/privy/vouches-v2/conversion/convert
POST
/wallets/lifetime-totals
GET
/wallets/transactions
GET
whuffies
Overview
/whuffies/auction-allocation
GET
/whuffies/balance/{address}
GET
/whuffies/circulating-supply
GET
/whuffies/price-guarantee
GET
/whuffies/reward-pool
GET
/whuffies/token-metadata
GET
/whuffies/token-sale-state
GET
/whuffies/total-supply
GET
xp
Overview
/xp/user/{userkey}
GET
/xp/user/{userkey}/season/{seasonId}
GET
/xp/user/{userkey}/season/{seasonId}/weekly
GET
/xp/user/{userkey}/season/{seasonId}/timeline
GET
/xp/seasons
GET
/xp/season/{seasonId}/weeks
GET
/xp/tips/sent
GET
/xp/tips/received
GET
/xp/tips/stats
GET
/xp/history
GET
/xp/send-details
GET
/xp/tips
GET
/xp/decision
GET
/xp/decision
POST
/xp/decision/metadata
GET
/xp/validators
GET
/xp/validators/profile/{userkey}
GET
/xp/dashboard/yield/{profileId}
GET
/xp/dashboard/periodic-rewards/{profileId}
GET
/xp/dashboard/multipliers/{profileId}
GET
/xp/dashboard/daily-earnings/{profileId}/{date}
GET
/xp/dashboard/daily-awards/{date}
GET
/xp/dashboard/weekly-delegator-award/{profileId}
GET
API explorer
API v1 (deprecated)
Overview
Categories
Contracts
Contributions
Events
Markets
Profiles
Replies
Scores
Search
Signatures
Slashes
Users
Vouches
Ethos Everywhere Wallet Integration
API Keys
Log in with Ethos
Vibe Coding Quickstart
Changelog
Whitepaper
Whitepaper
Ethos on X
GitHub
Select theme
Dark
Light
Auto
Overview
ai-images
Section titled “ai-images”
AI-generated images for slashes and broker posts: read the image currently selected for an entity.
Operations
Section titled “Operations”
GET
/ai-images/selected
