Markets V2

List markets v2 with pagination and sorting

get

Query parameters

orderBystring · enumOptionalDefault: volumeTotalCreditsPossible values:

orderDirectionstring · enumOptionalDefault: descPossible values:

filterQuerystring · min: 2 · max: 100Optional

limitinteger · min: 1 · max: 100OptionalDefault: 50

cursorinteger · max: 9007199254740991Optional

Responses

200

Successful response

application/json

nextCursornumber · nullableRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2 HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "id": 1,
      "marketOnchainId": 1,
      "userkey": "text",
      "subject": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 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
            }
          }
        }
      },
      "creatorAddress": "text",
      "trustPrice": 1,
      "distrustPrice": 1,
      "trustSupply": 1,
      "distrustSupply": 1,
      "poolBacking": 1,
      "volumeTotalCredits": 1,
      "volume24hCredits": 1,
      "priceChange24hPercent": 1,
      "createdAt": "text"
    }
  ],
  "nextCursor": 1
}

List markets v2 a user currently holds, ranked by position value desc

get

Query parameters

holderUserkeystringRequired

limitinteger · min: 1 · max: 100OptionalDefault: 50

cursorinteger · max: 9007199254740991Optional

Responses

200

Successful response

application/json

nextCursornumber · nullableRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/holdings

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/holdings?holderUserkey=text HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "id": 1,
      "marketOnchainId": 1,
      "userkey": "text",
      "subject": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 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
            }
          }
        }
      },
      "creatorAddress": "text",
      "trustPrice": 1,
      "distrustPrice": 1,
      "trustSupply": 1,
      "distrustSupply": 1,
      "poolBacking": 1,
      "volumeTotalCredits": 1,
      "volume24hCredits": 1,
      "priceChange24hPercent": 1,
      "createdAt": "text"
    }
  ],
  "nextCursor": 1
}

Get the markets v2 market whose subject is the given user, or null

get

Query parameters

userkeystringRequired

Responses

200

Successful response

application/json

idnumberRequired

marketOnchainIdnumberRequired

userkeystring · nullableRequired

creatorAddressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

trustPriceinteger · int64Required

distrustPriceinteger · int64Required

trustSupplyinteger · int64Required

distrustSupplyinteger · int64Required

poolBackinginteger · int64Required

volumeTotalCreditsinteger · int64Required

volume24hCreditsinteger · int64Required

priceChange24hPercentnumberRequired

createdAtstringRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/for-subject

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/for-subject?userkey=text HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "id": 1,
  "marketOnchainId": 1,
  "userkey": "text",
  "subject": {
    "id": 1,
    "profileId": 1,
    "displayName": "text",
    "username": "text",
    "avatarUrl": "https://example.com",
    "description": "text",
    "score": 1,
    "status": "ACTIVE",
    "userkeys": [
      "text"
    ],
    "xpTotal": 1,
    "xpStreakDays": 1,
    "xpRemovedDueToAbuse": true,
    "influenceFactor": 1,
    "influenceFactorPercentile": 1,
    "humanVerificationStatus": "REQUESTED",
    "validatorNftCount": 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
        }
      }
    }
  },
  "creatorAddress": "text",
  "trustPrice": 1,
  "distrustPrice": 1,
  "trustSupply": 1,
  "distrustSupply": 1,
  "poolBacking": 1,
  "volumeTotalCredits": 1,
  "volume24hCredits": 1,
  "priceChange24hPercent": 1,
  "createdAt": "text",
  "topTrustHolders": [
    {
      "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,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 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
            }
          }
        }
      },
      "balance": 1
    }
  ]
}

Get globally-recent trades across all markets v2

get

Query parameters

limitinteger · min: 1 · max: 50OptionalDefault: 20

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/recent-trades

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/recent-trades HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "id": 1,
      "type": "BUY",
      "traderAddress": "text",
      "trader": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 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
            }
          }
        }
      },
      "isPositive": true,
      "paymentAmount": 1,
      "tokenAmount": 1,
      "createdAt": "text",
      "market": {
        "marketOnchainId": 1,
        "userkey": "text",
        "subject": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 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
              }
            }
          }
        },
        "priceChange24hPercent": 1
      }
    }
  ]
}

Cursor-paginated trades across all markets v2, with optional score/size filters

get

Query parameters

minScoreinteger · max: 2800Optional

minPaymentAmountstringOptional

limitinteger · min: 1 · max: 100OptionalDefault: 50

cursorinteger · max: 9007199254740991Optional

Responses

200

Successful response

application/json

nextCursornumber · nullableRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/all-trade-history

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/all-trade-history HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "id": 1,
      "type": "BUY",
      "traderAddress": "text",
      "trader": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 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
            }
          }
        }
      },
      "isPositive": true,
      "paymentAmount": 1,
      "tokenAmount": 1,
      "createdAt": "text",
      "market": {
        "marketOnchainId": 1,
        "userkey": "text",
        "subject": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 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
              }
            }
          }
        }
      }
    }
  ],
  "nextCursor": 1
}

Rank traders by realized or unrealized PNL over a rolling window or all-time

get

Query parameters

directionstring · enumRequiredPossible values:

limitinteger · min: 1 · max: 20OptionalDefault: 10

metricstring · enumOptionalDefault: realizedPossible values:

windowstring · enumOptionalDefault: 1dPossible values:

Responses

200

Successful response

application/json

metricstring · enumRequiredPossible values:

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/pnl-leaderboard

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/pnl-leaderboard?direction=winners HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "metric": "realized",
  "values": [
    {
      "pnl": 1,
      "pnlPercent": 1,
      "rank": 1,
      "tradesCount": 1,
      "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,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 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
            }
          }
        }
      }
    }
  ]
}

Aggregate markets v2 portfolio value and unrealized PNL for a user

get

Query parameters

holderUserkeystringRequired

Responses

200

Successful response

application/json

portfolioValueinteger · int64Required

unrealizedPnlinteger · int64Required

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/portfolio-stats

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/portfolio-stats?holderUserkey=text HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "portfolioValue": 1,
  "unrealizedPnl": 1
}

Get a single market v2 by on-chain ID

get

Path parameters

marketOnchainIdinteger · max: 9007199254740991Required

Responses

200

Successful response

application/json

idnumberRequired

marketOnchainIdnumberRequired

userkeystring · nullableRequired

creatorAddressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

trustPriceinteger · int64Required

distrustPriceinteger · int64Required

trustSupplyinteger · int64Required

distrustSupplyinteger · int64Required

poolBackinginteger · int64Required

volumeTotalCreditsinteger · int64Required

volume24hCreditsinteger · int64Required

priceChange24hPercentnumberRequired

createdAtstringRequired

pricingContractstringRequired

Ethereum address (0x-prefixed, 20 bytes)

trustTokenstringRequired

Ethereum address (0x-prefixed, 20 bytes)

distrustTokenstringRequired

Ethereum address (0x-prefixed, 20 bytes)

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/{marketOnchainId}

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/{marketOnchainId} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "id": 1,
  "marketOnchainId": 1,
  "userkey": "text",
  "subject": {
    "id": 1,
    "profileId": 1,
    "displayName": "text",
    "username": "text",
    "avatarUrl": "https://example.com",
    "description": "text",
    "score": 1,
    "status": "ACTIVE",
    "userkeys": [
      "text"
    ],
    "xpTotal": 1,
    "xpStreakDays": 1,
    "xpRemovedDueToAbuse": true,
    "influenceFactor": 1,
    "influenceFactorPercentile": 1,
    "humanVerificationStatus": "REQUESTED",
    "validatorNftCount": 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
        }
      }
    }
  },
  "creatorAddress": "text",
  "trustPrice": 1,
  "distrustPrice": 1,
  "trustSupply": 1,
  "distrustSupply": 1,
  "poolBacking": 1,
  "volumeTotalCredits": 1,
  "volume24hCredits": 1,
  "priceChange24hPercent": 1,
  "createdAt": "text",
  "pricingContract": "text",
  "trustToken": "text",
  "distrustToken": "text"
}

Get trade history for a market v2

get

Path parameters

marketOnchainIdinteger · max: 9007199254740991Required

Query parameters

traderAddressstringOptional

Ethereum address (0x-prefixed, 20 bytes)

limitinteger · min: 1 · max: 100OptionalDefault: 50

cursorinteger · max: 9007199254740991Optional

Responses

200

Successful response

application/json

nextCursornumber · nullableRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/{marketOnchainId}/trade-history

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/{marketOnchainId}/trade-history HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "id": 1,
      "type": "BUY",
      "traderAddress": "text",
      "trader": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 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
            }
          }
        }
      },
      "isPositive": true,
      "paymentAmount": 1,
      "tokenAmount": 1,
      "createdAt": "text"
    }
  ],
  "nextCursor": 1
}

Get continuous per-side price candlestick history for a market v2

get

Path parameters

marketOnchainIdinteger · max: 9007199254740991Required

Query parameters

durationstring · enumOptionalDefault: 1dPossible values:

sidestring · enumOptionalDefault: trustPossible values:

Responses

200

Successful response

application/json

durationstring · enumRequiredPossible values:

metricconst: priceRequired

sidestring · enumRequiredPossible values:

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/{marketOnchainId}/price-history

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/{marketOnchainId}/price-history HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "duration": "1m",
  "metric": "text",
  "side": "trust",
  "values": [
    {
      "timeBucket": "text",
      "open": 1,
      "high": 1,
      "low": 1,
      "close": 1
    }
  ]
}

Get recent news posted by a market’s subject

get

Path parameters

marketOnchainIdinteger · max: 9007199254740991Required

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/{marketOnchainId}/recent-news

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/{marketOnchainId}/recent-news HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "items": [
    {
      "createdAt": "text",
      "id": "text",
      "text": "text",
      "url": "text"
    }
  ]
}

List holders of a market v2, sorted by balance desc

get

Path parameters

marketOnchainIdinteger · max: 9007199254740991Required

Query parameters

sidestring · enumOptionalPossible values:

limitinteger · min: 1 · max: 100OptionalDefault: 50

cursorinteger · max: 9007199254740991Optional

Responses

200

Successful response

application/json

nextCursornumber · nullableRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/{marketOnchainId}/holders

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/{marketOnchainId}/holders HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "traderAddress": "text",
      "trader": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 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
            }
          }
        }
      },
      "isPositive": true,
      "balance": 1,
      "firstTradeAt": "text"
    }
  ],
  "nextCursor": 1
}

Count open holder positions in a market v2

get

Path parameters

marketOnchainIdinteger · max: 9007199254740991Required

Responses

200

Successful response

application/json

countinteger · max: 9007199254740991Required

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/{marketOnchainId}/holder-count

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/{marketOnchainId}/holder-count HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "count": 1
}

Get a user’s position in a market

get

Path parameters

marketOnchainIdinteger · max: 9007199254740991Required

Query parameters

isPositivebooleanRequired

userAddressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

Responses

200

Successful response

application/json

balanceinteger · int64Required

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/{marketOnchainId}/position

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/{marketOnchainId}/position?isPositive=true&userAddress=text HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "balance": 1
}

Get a user’s open positions in a market, valued at the sell quote

get

Path parameters

marketOnchainIdinteger · max: 9007199254740991Required

Query parameters

holderUserkeystringRequired

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/{marketOnchainId}/position-values

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/{marketOnchainId}/position-values?holderUserkey=text HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "isPositive": true,
      "tokenBalance": 1,
      "value": 1
    }
  ]
}

Simulate opening a position on a market v2

get

Path parameters

marketOnchainIdinteger · max: 9007199254740991Required

Query parameters

isPositivebooleanRequired

paymentAmountinteger · int64Required

slippagePercentagenumber · max: 0.5OptionalDefault: 0.01

Responses

200

Successful response

application/json

tokensMintedinteger · int64Required

minTokensOutinteger · int64Required

protocolFeeinteger · int64Required

effectivePriceinteger · int64Required

priceImpactPctnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/{marketOnchainId}/simulate-open-position

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/{marketOnchainId}/simulate-open-position?isPositive=true&paymentAmount=1 HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "tokensMinted": 1,
  "minTokensOut": 1,
  "protocolFee": 1,
  "effectivePrice": 1,
  "priceImpactPct": 1
}

Simulate closing a position on a market v2

get

Path parameters

marketOnchainIdinteger · max: 9007199254740991Required

Query parameters

isPositivebooleanRequired

positionTokenAmountinteger · int64Required

sellerAddressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

slippagePercentagenumber · max: 0.5OptionalDefault: 0.01

Responses

200

Successful response

application/json

netCreditsOutinteger · int64Required

minCreditsOutinteger · int64Required

curveRevenueinteger · int64Required

exitFeeinteger · int64Required

effectivePriceinteger · int64Required

priceImpactPctnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get/markets-v2/{marketOnchainId}/simulate-close-position

HTTPcURLJavaScriptPython

GET /api/v2/markets-v2/{marketOnchainId}/simulate-close-position?isPositive=true&positionTokenAmount=1&sellerAddress=text HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "netCreditsOut": 1,
  "minCreditsOut": 1,
  "curveRevenue": 1,
  "exitFee": 1,
  "effectivePrice": 1,
  "priceImpactPct": 1
}