For the complete documentation index, see llms.txt. This page is also available as Markdown.

Markets

List markets with pagination, sorting, and filtering

get
Query parameters
orderBystring · enumOptionalDefault: createdAtPossible values:
orderDirectionstring · enumOptionalDefault: descPossible values:
dayRangeinteger · min: 1 · max: 90 · nullableOptionalDefault: null
filterQuerystringOptional
limitinteger · max: 100OptionalDefault: 50
offsetinteger · max: 2147483647OptionalDefault: 0
Responses
200

Successful response

application/json
totalnumberRequired
limitnumberRequired
offsetnumberRequired
get/markets
get
Query parameters
changeTypestring · enumOptionalDefault: priceChange24hPercentPossible values:
excludeUnverifiedbooleanOptional
Responses
200

Successful response

application/json
typestring · enumRequiredPossible values:
get/markets/featured

Get market holders with user data

get
Path parameters
profileIdinteger · max: 2147483647Required
Query parameters
dedupeByUserbooleanOptionalDefault: false
voteTypestring · enumOptionalPossible values:
orderBystring · enumOptionalDefault: holdingsPossible values:
orderDirectionstring · enumOptionalDefault: descPossible values:
limitinteger · max: 500OptionalDefault: 50
offsetinteger · max: 2147483647OptionalDefault: 0
Responses
200

Successful response

application/json
totalnumberRequired
limitnumberRequired
offsetnumberRequired
get/markets/{profileId}/holders

Get market price history for chart with advanced features

get
Path parameters
profileIdinteger · max: 2147483647Required
Query parameters
timeWindowstring · enumOptionalDefault: 7DPossible values:
customBucketstring · enumOptionalPossible values:
Responses
200

Successful response

application/json
timeWindowstring · enumRequiredPossible values:
bucketstring · enumRequiredPossible values:
get/markets/{profileId}/price/history

Simulate trust market purchase

get
Query parameters
profileIdinteger · max: 2147483647Required
voteTypestring · enumRequiredPossible values:
buyAmountWeiinteger · int64Required
slippagePercentagenumber · max: 1OptionalDefault: 0.01
Responses
200

Successful response

application/json
impactPctnumberRequired
maxVotesToBuyinteger · max: 9007199254740991Required
minVotesToBuyinteger · max: 9007199254740991Required
newPriceinteger · int64Required
trendstring · enum · nullableRequiredPossible values:
get/markets/simulate-buy

Simulate market vote sell

get
Query parameters
profileIdinteger · max: 2147483647Required
voteTypestring · enumRequiredPossible values:
votesinteger · max: 9007199254740991Required
sellerAddressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

slippagePercentagenumber · max: 1OptionalDefault: 0.01
Responses
200

Successful response

application/json
fundsReceivedinteger · int64Required
minimumVotePriceinteger · int64Required
newVotePriceinteger · int64Required
get/markets/simulate-sell

Get market change (market cap or price) data over specified days

get

Supports market cap and price change calculations. Volume change coming soon.

Path parameters
profileIdinteger · max: 2147483647Required
Query parameters
daysinteger · min: 1 · max: 90OptionalDefault: 7
typestring · enumOptionalDefault: marketCapPossible values:
Responses
200

Successful response

application/json
profileIdnumberRequired
daysnumberRequired
get/markets/{profileId}/change

Get enhanced market info with optional includes

post

Enhanced market info with optional top holders and market change data

Path parameters
profileIdinteger · max: 2147483647Required
Body
marketTopHoldersLimitinteger · max: 10OptionalDefault: 0
Responses
200

Successful response

application/json
idinteger · max: 9007199254740991Required
creatorAddressstringRequired
positivePricestringRequired
negativePricestringRequired
trustVotesnumberRequired
distrustVotesnumberRequired
createdAtstringRequired
updatedAtstringRequired
basePricestringRequired
creationCoststringRequired
liquiditystringRequired
configTypestring · enumRequiredPossible values:
post/markets/{profileId}/info

Get market info for multiple markets by profile IDs

get
Query parameters
profileIdsinteger[] · max: 500Required
Responses
200

Successful response

application/json
idinteger · max: 9007199254740991Required
creatorAddressstringRequired
positivePricestringRequired
negativePricestringRequired
trustVotesnumberRequired
distrustVotesnumberRequired
createdAtstringRequired
updatedAtstringRequired
basePricestringRequired
creationCoststringRequired
liquiditystringRequired
configTypestring · enumRequiredPossible values:
get/markets/info/bulk

Get markets user by the embedded wallet address used on ethos.markets

get
Path parameters
addressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

Responses
200

Successful response

application/json
profileIdinteger · max: 2147483647 · nullableRequired
twitterUsernamestringRequired
twitterNamestringRequired
twitterUserIdstringRequired
walletAddressstring · nullableRequired

Ethereum address (0x-prefixed, 20 bytes)

avatarUrlstringRequired
createdAtstringRequired
updatedAtstringRequired
get/markets/users/by/address/{address}

Get markets user by Twitter username

get
Path parameters
usernamestringRequired
Responses
200

Successful response

application/json
profileIdinteger · max: 2147483647 · nullableRequired
twitterUsernamestringRequired
twitterNamestringRequired
twitterUserIdstringRequired
walletAddressstring · nullableRequired

Ethereum address (0x-prefixed, 20 bytes)

avatarUrlstringRequired
createdAtstringRequired
updatedAtstringRequired
get/markets/users/by/x/{username}

Resolve market trading addresses to users with emporos and echo data

post
Body
addressesstring[] · min: 1 · max: 500Required

Ethereum address (0x-prefixed, 20 bytes)

Responses
200

Successful response

application/json
addressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

post/markets/users/by/addresses

Get market configurations for market creation and display

get
Responses
200

Successful response

application/json
basePriceinteger · int64Required
configIndexnumberRequired
creationCostinteger · int64Required
liquidityinteger · int64Required
get/markets/configs

Get market buy and sell fee percentages

get
Responses
200

Successful response

application/json
donationFeePercentagenumberRequired
entryProtocolFeePercentagenumberRequired
exitProtocolFeePercentagenumberRequired
get/markets/fees

Get current vote price for a market

get
Path parameters
profileIdinteger · max: 2147483647Required
Query parameters
voteTypestring · enumRequiredPossible values:
Responses
200

Successful response

application/json
priceinteger · int64Required
get/markets/{profileId}/vote-price

Get vote counts owned by a user in a market

get
Path parameters
profileIdinteger · max: 2147483647Required
Query parameters
userAddressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

Responses
200

Successful response

application/json
distrustVotesinteger · max: 9007199254740991Required
trustVotesinteger · max: 9007199254740991Required
get/markets/{profileId}/user-votes

Get paginated open market positions for a user by userkey

get

Open market positions across all of the user’s trading wallets (profile-linked addresses, EEW, and the linked ethos.markets embedded wallet). Each row represents one (market, voteType) position summed across wallets.

Query parameters
holderUserkeystringRequired
marketProfileIdinteger · max: 2147483647Optional
limitinteger · min: 1 · max: 500OptionalDefault: 50
cursorinteger · max: 9007199254740991Optional
Responses
200

Successful response

application/json
nextCursornumber · nullableRequired
totalinteger · max: 9007199254740991Required
get/markets/holdings

Get aggregate market stats for a user by userkey

get

Portfolio value and total PNL summed across all of the user’s trading wallets (profile-linked addresses, EEW, and the linked ethos.markets embedded wallet). Portfolio value only includes open positions; total PNL includes realized and unrealized PNL.

Query parameters
holderUserkeystringRequired
Responses
200

Successful response

application/json
marketsPortfolioValueinteger · int64Required
totalPnlinteger · int64Required
get/markets/stats

Last updated