GET
/
markets
Get list of markets
curl --request GET \
  --url https://api-testnet.gte.xyz/v1/markets
[
  {
    "marketType": "bonding-curve",
    "address": "<string>",
    "baseToken": {
      "address": "<string>",
      "decimals": 123,
      "name": "<string>",
      "symbol": "<string>",
      "totalSupply": 123,
      "logoUri": "<string>",
      "priceUsd": 123,
      "volume1HrUsd": 123,
      "volume24HrUsd": 123,
      "marketCapUsd": 123,
      "marketType": "bonding-curve"
    },
    "quoteToken": {
      "address": "<string>",
      "decimals": 123,
      "name": "<string>",
      "symbol": "<string>",
      "totalSupply": 123,
      "logoUri": "<string>",
      "priceUsd": 123,
      "volume1HrUsd": 123,
      "volume24HrUsd": 123,
      "marketCapUsd": 123,
      "marketType": "bonding-curve"
    },
    "price": 123,
    "priceUsd": 123,
    "volume24HrUsd": 123,
    "priceChange24Hr": 123,
    "priceChange1Hr": 123,
    "volume1HrUsd": 123,
    "marketCapUsd": 123,
    "createdAt": 123,
    "tvlUsd": 123,
    "liquidityUsd": 123,
    "bondingPercentage": 123
  }
]

Query Parameters

limit
integer
default:100
Required range: 1 <= x <= 1000
offset
integer
default:0
Required range: x >= 0
marketType
enum<string>

Filter by market type. If empty, all market types will be returned

Available options:
bonding-curve,
amm,
clob-spot,
perps
sortBy
enum<string>
default:marketCap

Sort markets in descending order

Available options:
marketCap,
createdAt,
volume
tokenAddress
string

Filter markets by the specified token address

Response

List of markets

marketType
enum<string>
required

Type of the market

Available options:
bonding-curve,
amm,
clob-spot,
perps
address
string
required

EVM address of the market

baseToken
object
required

Base token of the market. On AMMs, this token comes first in the pair

quoteToken
object
required

Quote token of the market. On AMMs, this token comes second in the pair

price
number
required

Price of the base token in quote tokens.

priceUsd
number
required

Price of the base token in USD.

volume24HrUsd
number
required

Volume of the market in the last 24 hours in USD

priceChange24Hr
number
required

Price change of the market in the last 24 hours in percentage

priceChange1Hr
number
required

Price change of the market in the last 1 hour in percentage

volume1HrUsd
number
required

Volume of the market in the last 1 hour in USD

marketCapUsd
number
required

Market cap of the market in USD

createdAt
integer | null
required

Timestamp of when the market was deployed in UTC millis

tvlUsd
number | null
required

TVL of the market in Usd. Null if not applicable.

bondingPercentage
number | null
required

Percentage of the market that is bonded. Null if not applicable.

liquidityUsd
number | null

Liquidity of the market in USD. Null if not applicable.