Markets

List markets with pagination, sorting, and filtering

get
Query parameters
orderBystring · enumOptionalDefault: createdAtPossible values:
orderDirectionstring · enumOptionalDefault: descPossible values:
dayRangeinteger | nullableOptionalDefault: null
filterQuerystring · min: 2 · max: 100Optional
limitinteger · max: 100OptionalDefault: 50
offsetnumberOptionalDefault: 0
Responses
200

Successful response

application/json
get
GET /api/v2/markets HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "id": 1,
      "creatorAddress": "text",
      "positivePrice": "text",
      "negativePrice": "text",
      "trustVotes": 1,
      "distrustVotes": 1,
      "createdAt": "text",
      "updatedAt": "text",
      "basePrice": "text",
      "creationCost": "text",
      "liquidity": "text",
      "configType": "VOLATILE",
      "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,
        "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": {
        "marketCapWei": "text",
        "volumeTotalWei": "text",
        "volume24hWei": "text",
        "priceChange24hPercent": 1
      }
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Get featured markets

get
Responses
200

Successful response

application/json
get
GET /api/v2/markets/featured HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "type": "top-volume",
    "market": {
      "id": 1,
      "creatorAddress": "text",
      "positivePrice": "text",
      "negativePrice": "text",
      "trustVotes": 1,
      "distrustVotes": 1,
      "createdAt": "text",
      "updatedAt": "text",
      "basePrice": "text",
      "creationCost": "text",
      "liquidity": "text",
      "configType": "VOLATILE",
      "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,
        "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": {
        "marketCapWei": "text",
        "volumeTotalWei": "text",
        "volume24hWei": "text",
        "priceChange24hPercent": 1
      }
    }
  }
]

Simulate trust market purchase

post
Body
profileIdinteger · max: 2147483647Required
voteTypestring · enumRequiredPossible values:
buyAmountWeiinteger · int64Required
slippagePercentagenumber · max: 1OptionalDefault: 0.01
Responses
200

Successful response

application/json
post
POST /api/v2/markets/simulate-buy HTTP/1.1
Host: api.ethos.network
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "profileId": 1,
  "voteType": "trust",
  "buyAmountWei": 1,
  "slippagePercentage": 0.01
}
{
  "votes": 1,
  "newPrice": 1,
  "impactPct": 1,
  "trend": "up"
}

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

get
Path parameters
addressstringRequired
Responses
200

Successful response

application/json
get
GET /api/v2/markets/users/by/address/{address} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "profileId": 1,
  "twitterUsername": "text",
  "twitterName": "text",
  "twitterUserId": "text",
  "walletAddress": "text",
  "avatarUrl": "text",
  "createdAt": "text",
  "updatedAt": "text"
}

Get markets user by Twitter username

get
Path parameters
usernamestringRequired
Responses
200

Successful response

application/json
get
GET /api/v2/markets/users/by/x/{username} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "profileId": 1,
  "twitterUsername": "text",
  "twitterName": "text",
  "twitterUserId": "text",
  "walletAddress": "text",
  "avatarUrl": "text",
  "createdAt": "text",
  "updatedAt": "text"
}
PreviousLlmNextNotifications