Get market by address

curl --request GET \
  --url https://api-testnet.gte.xyz/v1/markets/{market_address}

{
  "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,
  "priceChange5Min": 123,
  "priceChange4Hr": 123,
  "buys5Min": 123,
  "buys1Hr": 123,
  "buys4Hr": 123,
  "buys24Hr": 123,
  "sells5Min": 123,
  "sells1Hr": 123,
  "sells4Hr": 123,
  "sells24Hr": 123,
  "buyers5Min": 123,
  "buyers1Hr": 123,
  "buyers4Hr": 123,
  "buyers24Hr": 123,
  "sellers5Min": 123,
  "sellers1Hr": 123,
  "sellers4Hr": 123,
  "sellers24Hr": 123,
  "buyVolume5MinUsd": 123,
  "buyVolume1HrUsd": 123,
  "buyVolume4HrUsd": 123,
  "buyVolume24HrUsd": 123,
  "sellVolume5MinUsd": 123,
  "sellVolume1HrUsd": 123,
  "sellVolume4HrUsd": 123,
  "sellVolume24HrUsd": 123
}

GET

markets

{market_address}

Get market by address

curl --request GET \
  --url https://api-testnet.gte.xyz/v1/markets/{market_address}

{
  "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,
  "priceChange5Min": 123,
  "priceChange4Hr": 123,
  "buys5Min": 123,
  "buys1Hr": 123,
  "buys4Hr": 123,
  "buys24Hr": 123,
  "sells5Min": 123,
  "sells1Hr": 123,
  "sells4Hr": 123,
  "sells24Hr": 123,
  "buyers5Min": 123,
  "buyers1Hr": 123,
  "buyers4Hr": 123,
  "buyers24Hr": 123,
  "sellers5Min": 123,
  "sellers1Hr": 123,
  "sellers4Hr": 123,
  "sellers24Hr": 123,
  "buyVolume5MinUsd": 123,
  "buyVolume1HrUsd": 123,
  "buyVolume4HrUsd": 123,
  "buyVolume24HrUsd": 123,
  "sellVolume5MinUsd": 123,
  "sellVolume1HrUsd": 123,
  "sellVolume4HrUsd": 123,
  "sellVolume24HrUsd": 123
}

Path Parameters

market_address

string

required

EVM address

Response

Market

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

Show child attributes

quoteToken

object

required

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

Show child attributes

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 Percentage price change of the market in the last 24 hours

priceChange1Hr

number

required

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

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.

priceChange5Min

number

required

Percentage price change of the market in the last 5 minutes

priceChange4Hr

number

required

Percentage price change of the market in the last 4 hours

buys5Min

integer

required

Number of buys in the last 5 minutes

buys1Hr

integer

required

Number of buys in the last 1 hour

buys4Hr

integer

required

Number of buys in the last 4 hours

buys24Hr

integer

required

Number of buys in the last 24 hours

sells5Min

integer

required

Number of sells in the last 5 minutes

sells1Hr

integer

required

Number of sells in the last 1 hour

sells4Hr

integer

required

Number of sells in the last 4 hours

sells24Hr

integer

required

Number of sells in the last 24 hours

buyers5Min

integer

required

Number of unique buyers in the last 5 minutes

buyers1Hr

integer

required

Number of unique buyers in the last 1 hour

buyers4Hr

integer

required

Number of unique buyers in the last 4 hours

buyers24Hr

integer

required

Number of unique buyers in the last 24 hours

sellers5Min

integer

required

Number of unique sellers in the last 5 minutes

sellers1Hr

integer

required

Number of unique sellers in the last 1 hour

sellers4Hr

integer

required

Number of unique sellers in the last 4 hours

sellers24Hr

integer

required

Number of unique sellers in the last 24 hours

buyVolume5MinUsd

number

required

Buy volume of the market in the last 5 minutes in USD

buyVolume1HrUsd

number

required

Buy volume of the market in the last 1 hour in USD

buyVolume4HrUsd

number

required

Buy volume of the market in the last 4 hours in USD

buyVolume24HrUsd

number

required

Buy volume of the market in the last 24 hours in USD

sellVolume5MinUsd

number

required

Sell volume of the market in the last 5 minutes in USD

sellVolume1HrUsd

number

required

Sell volume of the market in the last 1 hour in USD

sellVolume4HrUsd

number

required

Sell volume of the market in the last 4 hours in USD

sellVolume24HrUsd

number

required

Sell volume of the market in the last 24 hours in USD

liquidityUsd

number | null

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

Get dash markets Get candles for a market

⌘I

Overview

WebSocket

API Reference

Tokens

Markets

Users

Exchange

Get market by address

Path Parameters

Response