Gate.io API

Free Gate.io public API with no key: spot tickers with 24-hour high, low, volume and change for thousands of pairs, in one request or per pair. Tested example included.

No API key requiredCORS enabledHTTPSFree tier

Endpoint tested and returned HTTP 200 on 2026-08-21

What is the Gate.io API?

The Gate.io public API is a free, key-free market data API. Its spot tickers endpoint returns last price, best bid and ask with sizes, 24-hour high, low, base and quote volume and percentage change — for one pair, or for every listed pair in a single request.

Gate.io lists several thousand trading pairs, far more than most exchanges, which makes its API the practical option for long-tail tokens. The v4 API is clean and consistent, and market data needs no credentials at all.

The detail that makes this endpoint efficient is that `currency_pair` is optional. Omit it and you get an array containing every listed pair in one response — a few hundred kilobytes, but far cheaper and far kinder to rate limits than several thousand individual requests. It also returns both `base_volume` and `quote_volume`, so you can rank pairs by dollar liquidity rather than by token count, which is the meaningful comparison across assets with wildly different unit prices.

Quick facts

Base URL: https://api.gateio.ws/api/v4
Authentication: No key for public spot, futures and options market data. Trading and wallet endpoints require an API key with request signing.
Rate limit: Roughly 200 requests per 10 seconds per IP for public endpoints.
Pricing: Free for public market data.
CORS: Enabled — callable directly from browser JavaScript
Official docs: Read the docs

How to use the Gate.io API

Every request below was executed against the live API on 2026-08-21, and the response shown is the real body it returned — not an illustration.

1. Spot ticker for BTC_USDT

GET https://api.gateio.ws/api/v4/spot/tickers?currency_pair=BTC_USDT

curl

curl 'https://api.gateio.ws/api/v4/spot/tickers?currency_pair=BTC_USDT'

JavaScript (fetch)

const res = await fetch("https://api.gateio.ws/api/v4/spot/tickers?currency_pair=BTC_USDT");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

Python (requests)

import requests

res = requests.get("https://api.gateio.ws/api/v4/spot/tickers?currency_pair=BTC_USDT", timeout=20)
res.raise_for_status()
print(res.json())

Response — HTTP 200

[
  {
    "currency_pair": "BTC_USDT",
    "last": "75237.8",
    "lowest_ask": "75237.8",
    "lowest_size": "5.614088",
    "highest_bid": "75237.7",
    "highest_size": "3.500168",
    "change_percentage": "8.21",
    "base_volume": "20538.036896",
    "quote_volume": "1488500932.069462",
    "high_24h": "75783.9",
    "low_24h": "69349.1"
  }
]

Parameters

Parameter	Type	Required	Description
`currency_pair`	query	Optional	Uppercase pair with an underscore separator, for example `BTC_USDT`. Omit it to return every listed pair. `BTC_USDT`
`timezone`	query	Optional	Timezone used for the 24-hour window boundaries: `utc0`, `utc8` or `all`. `utc0`

Response fields

currency_pairstring: The pair the row describes. The response is always an array, even for a single pair.
laststring: Last traded price, as a string for precision.
lowest_ask / highest_bidstring: Best ask and best bid currently on the book.
lowest_size / highest_sizestring: Quantity available at the best ask and best bid.
change_percentagestring: 24-hour price change as a percentage (8.21 means +8.21 percent).
base_volumestring: 24-hour volume in the base currency — BTC, in BTC_USDT.
quote_volumestring: 24-hour volume in the quote currency. Use this to compare liquidity across different tokens.
high_24h / low_24hstring: Highest and lowest prices in the trailing 24 hours.

What you can build with the Gate.io API

Price long-tail altcoins that major exchanges do not list
Rank every listed pair by quote volume to find the most liquid markets
Build a market overview table from one request instead of thousands
Track 24-hour movers for a crypto news or alerts site

Common errors and how to fix them

400 INVALID_CURRENCY_PAIR

Unknown or badly formatted pair.

Fix: Pairs are uppercase with an underscore — `BTC_USDT`, not a hyphenated or lowercase form. Fetch the currency pairs endpoint for the full list.

429 TOO_MANY_REQUESTS

Rate limit exceeded.

Fix: Drop `currency_pair` and fetch all tickers in one call rather than looping — that is the entire reason the parameter is optional.

Empty array

The pair exists but has been delisted or halted.

Fix: Check the currency pairs endpoint for that pair's `trade_status`.

Gate.io API — frequently asked questions

Is the Gate.io API free and does it need a key?

Public market data across spot, futures and options is free and needs no API key. Only trading and wallet operations require credentials with signed requests.

How do I get every Gate.io ticker in one request?

Omit the `currency_pair` parameter. The spot tickers endpoint with no arguments returns an array covering every listed pair, which is dramatically more efficient than requesting them one at a time.

What is the difference between base_volume and quote_volume?

`base_volume` counts units of the base asset traded, `quote_volume` counts the value in the quote currency. Quote volume is the one to sort by when comparing liquidity, because base volume is not comparable between a token worth cents and one worth thousands.

What format do Gate.io trading pairs use?

Uppercase with an underscore separator, such as BTC_USDT. This differs from KuCoin's hyphen and Bitstamp's lowercase concatenation, so normalise pair symbols if you aggregate several exchanges.

Tools that pair with this API

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

Percentage Change Calculator

Work out the percentage increase or decrease between an old and a new value. See the absolute change and whether it went up or down, instantly and privately.

JSON to CSV Converter

Convert a JSON array of objects to CSV online. Automatic column headers from the union of all keys, delimiter choice and proper quoting — all in-browser.

Gate.io is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-21; always check the official documentation before relying on this API in production, as terms and limits can change.