GET
/
markets
/
search
Search markets based on name or symbol
curl --request GET \
  --url https://api-testnet.gte.xyz/v1/markets/search
[
  {
    "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
  }
]

Query Parameters

q
string
marketType
enum<string>

Filter by market type

Available options:
bonding-curve,
amm,
clob-spot,
perps

Response

200
application/json

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.

liquidityUsd
number | null

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