Get enhanced market info with optional includes

POST

/markets/{profileId}/info

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://api.ethos.network/api/v2/markets/1/info"),
    Content = new StringContent("{ \"marketTopHoldersLimit\": 0, \"marketChangeParams\": { \"type\": \"marketCap\", \"days\": 7 } }")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://api.ethos.network/api/v2/markets/1/info"

  payload := strings.NewReader("{ \"marketTopHoldersLimit\": 0, \"marketChangeParams\": { \"type\": \"marketCap\", \"days\": 7 } }")

  req, _ := http.NewRequest("POST", url, payload)

  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{ \"marketTopHoldersLimit\": 0, \"marketChangeParams\": { \"type\": \"marketCap\", \"days\": 7 } }");
Request request = new Request.Builder()
  .url("https://api.ethos.network/api/v2/markets/1/info")
  .post(body)
  .addHeader("Content-Type", "application/json")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://api.ethos.network/api/v2/markets/1/info',
  headers: {'Content-Type': 'application/json'},
  data: {marketTopHoldersLimit: 0, marketChangeParams: {type: 'marketCap', days: 7}}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://api.ethos.network/api/v2/markets/1/info';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"marketTopHoldersLimit":0,"marketChangeParams":{"type":"marketCap","days":7}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

use serde_json::json;
use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://api.ethos.network/api/v2/markets/1/info";

    let payload = json!({
        "marketTopHoldersLimit": 0,
        "marketChangeParams": json!({
            "type": "marketCap",
            "days": 7
        })
    });

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.post(url)
        .headers(headers)
        .json(&payload)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

curl --request POST \
  --url https://api.ethos.network/api/v2/markets/1/info \
  --header 'Content-Type: application/json' \
  --data '{ "marketTopHoldersLimit": 0, "marketChangeParams": { "type": "marketCap", "days": 7 } }'

wget --quiet \
  --method POST \
  --header 'Content-Type: application/json' \
  --body-data '{ "marketTopHoldersLimit": 0, "marketChangeParams": { "type": "marketCap", "days": 7 } }' \
  --output-document \
  - https://api.ethos.network/api/v2/markets/1/info

Enhanced market info with optional top holders and market change data

Parameters

Path Parameters

profileId

required

integer

> 0 <= 2147483647

Request Body^required

application/json

object

marketTopHoldersLimit

integer

0 <= 10

marketChangeParams

object

type

string

default: marketCap

Allowed values: marketCap price

days

integer

default: 7 >= 1 <= 90

Responses

200

Successful response

application/json

object

required

integer

<= 9007199254740991

creatorAddress

required

string

positivePrice

required

string

negativePrice

required

string

trustVotes

required

number

distrustVotes

required

number

createdAt

required

string

updatedAt

required

string

basePrice

required

string

creationCost

required

string

liquidity

required

string

configType

required

string

Allowed values: VOLATILE NORMAL INSULATED

user

Any of:

object
null

object

required

number

profileId

required

number | null

displayName

required

string

username

required

string | null

avatarUrl

required

string format: uri

description

required

string | null

score

required

number

status

required

string

Allowed values: ACTIVE INACTIVE MERGED

userkeys

required

Array<string>

xpTotal

required

number

xpStreakDays

required

number

xpRemovedDueToAbuse

required

boolean

influenceFactor

required

number

influenceFactorPercentile

required

number

humanVerificationStatus

Any of:

string
null

string

Allowed values: REQUESTED VERIFIED REVOKED PENDING

validatorNftCount

required

number

meowMeowsNftCount

required

number

links

required

object

profile

required

string format: uri

scoreBreakdown

required

string format: uri

stats

required

object

holdingsWei

required

Any of:

integer
null

integer format: int64

review

required

object

received

required

object

negative

required

number

neutral

required

number

positive

required

number

vouch

required

@deprecated Native-currency lifetime totals only. Use stats.vouchTotals (per-token). Removed after 2026-10-20.

object

given

required

object

amountWeiTotal

required

integer format: int64

count

required

number

received

required

object

amountWeiTotal

required

integer format: int64

count

required

number

vouchTotals

required

Array<object>

>= 1 items

object

balance

required

object

given

required

integer format: int64

received

required

integer format: int64

count

required

object

given

required

integer

<= 9007199254740991

received

required

integer

<= 9007199254740991

token

required

object

address

required

Any of:

string
null

Ethereum address (0x-prefixed, 20 bytes)

string

decimals

required

integer

<= 9007199254740991

required

Lowercase token identifier

string

Allowed values: eth whuf

whufGuarantee

required

Any of:

object
null

object

asOf

required

string

expiresAt

required

string | null

guaranteedWei

required

integer format: int64

status

required

string

Allowed values: active expired

stats

required

object

marketCapWei

required

string

marketCapChange24hWei

required

string

marketCapChange24hPercent

required

number

volumeTotalWei

required

string

volume24hWei

required

string

priceChange24hPercent

required

number

marketTopHolders

object

trust

required

Array<object>

object

actorAddress

required

string

marketId

required

integer

> 0 <= 9007199254740991

voteType

required

string

Allowed values: trust distrust

total

required

integer format: int64

user

required

object

required

number

profileId

required

number | null

displayName

required

string

username

required

string | null

avatarUrl

required

string format: uri

description

required

string | null

score

required

number

status

required

string

Allowed values: ACTIVE INACTIVE MERGED

userkeys

required

Array<string>

xpTotal

required

number

xpStreakDays

required

number

xpRemovedDueToAbuse

required

boolean

influenceFactor

required

number

influenceFactorPercentile

required

number

humanVerificationStatus

Any of:

string
null

string

Allowed values: REQUESTED VERIFIED REVOKED PENDING

validatorNftCount

required

number

meowMeowsNftCount

required

number

links

required

object

profile

required

string format: uri

scoreBreakdown

required

string format: uri

stats

required

object

holdingsWei

required

Any of:

integer
null

integer format: int64

review

required

object

received

required

object

negative

required

number

neutral

required

number

positive

required

number

vouch

required

@deprecated Native-currency lifetime totals only. Use stats.vouchTotals (per-token). Removed after 2026-10-20.

object

given

required

object

amountWeiTotal

required

integer format: int64

count

required

number

received

required

object

amountWeiTotal

required

integer format: int64

count

required

number

vouchTotals

required

Array<object>

>= 1 items

object

balance

required

object

given

required

integer format: int64

received

required

integer format: int64

count

required

object

given

required

integer

<= 9007199254740991

received

required

integer

<= 9007199254740991

token

required

object

address

required

Any of:

string
null

Ethereum address (0x-prefixed, 20 bytes)

string

decimals

required

integer

<= 9007199254740991

required

Lowercase token identifier

string

Allowed values: eth whuf

whufGuarantee

required

Any of:

object
null

object

asOf

required

string

expiresAt

required

string | null

guaranteedWei

required

integer format: int64

status

required

string

Allowed values: active expired

distrust

required

Array<object>

object

actorAddress

required

string

marketId

required

integer

> 0 <= 9007199254740991

voteType

required

string

Allowed values: trust distrust

total

required

integer format: int64

user

required

object

required

number

profileId

required

number | null

displayName

required

string

username

required

string | null

avatarUrl

required

string format: uri

description

required

string | null

score

required

number

status

required

string

Allowed values: ACTIVE INACTIVE MERGED

userkeys

required

Array<string>

xpTotal

required

number

xpStreakDays

required

number

xpRemovedDueToAbuse

required

boolean

influenceFactor

required

number

influenceFactorPercentile

required

number

humanVerificationStatus

Any of:

string
null

string

Allowed values: REQUESTED VERIFIED REVOKED PENDING

validatorNftCount

required

number

meowMeowsNftCount

required

number

links

required

object

profile

required

string format: uri

scoreBreakdown

required

string format: uri

stats

required

object

holdingsWei

required

Any of:

integer
null

integer format: int64

review

required

object

received

required

object

negative

required

number

neutral

required

number

positive

required

number

vouch

required

@deprecated Native-currency lifetime totals only. Use stats.vouchTotals (per-token). Removed after 2026-10-20.

object

given

required

object

amountWeiTotal

required

integer format: int64

count

required

number

received

required

object

amountWeiTotal

required

integer format: int64

count

required

number

vouchTotals

required

Array<object>

>= 1 items

object

balance

required

object

given

required

integer format: int64

received

required

integer format: int64

count

required

object

given

required

integer

<= 9007199254740991

received

required

integer

<= 9007199254740991

token

required

object

address

required

Any of:

string
null

Ethereum address (0x-prefixed, 20 bytes)

string

decimals

required

integer

<= 9007199254740991

required

Lowercase token identifier

string

Allowed values: eth whuf

whufGuarantee

required

Any of:

object
null

object

asOf

required

string

expiresAt

required

string | null

guaranteedWei

required

integer format: int64

status

required

string

Allowed values: active expired

marketChange

object

profileId

required

number

change

required

object

trust

required

object

latestWei

required

integer format: int64

latestUsd

required

number

changeWei

required

Any of:

integer
null

integer format: int64

changeUsd

required

number | null

changePercent

required

number | null

distrust

required

object

latestWei

required

integer format: int64

latestUsd

required

number

changeWei

required

Any of:

integer
null

integer format: int64

changeUsd

required

number | null

changePercent

required

number | null

total

required

object

latestWei

required

integer format: int64

latestUsd

required

number

changeWei

required

Any of:

integer
null

integer format: int64

changeUsd

required

number | null

changePercent

required

number | null

days

required

number

Example

{
  "configType": "VOLATILE",
  "user": {
    "status": "ACTIVE",
    "humanVerificationStatus": "REQUESTED",
    "stats": {
      "vouchTotals": [
        {
          "token": {
            "id": "eth"
          }
        }
      ],
      "whufGuarantee": {
        "status": "active"
      }
    }
  },
  "marketTopHolders": {
    "trust": [
      {
        "voteType": "trust",
        "user": {
          "status": "ACTIVE",
          "humanVerificationStatus": "REQUESTED",
          "stats": {
            "vouchTotals": [
              {
                "token": {
                  "id": "eth"
                }
              }
            ],
            "whufGuarantee": {
              "status": "active"
            }
          }
        }
      }
    ],
    "distrust": [
      {
        "voteType": "trust",
        "user": {
          "status": "ACTIVE",
          "humanVerificationStatus": "REQUESTED",
          "stats": {
            "vouchTotals": [
              {
                "token": {
                  "id": "eth"
                }
              }
            ],
            "whufGuarantee": {
              "status": "active"
            }
          }
        }
      }
    ]
  }
}

400

Invalid input data

application/json

Invalid input data error (400)

The error information

object

message

required

The error message

string

code

required

The error code

string

issues

An array of issues that were responsible for the error

Array<object>

object

message

required

string

Example

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

500

Internal server error

application/json

Internal server error error (500)

The error information

object

message

required

The error message

string

code

required

The error code

string

issues

An array of issues that were responsible for the error

Array<object>

object

message

required

string

Example

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Get enhanced market info with optional includes

Parameters

Path Parameters

Request Bodyrequired

Responses

200

Example

400

Example

500

Example

Request Body^required