Maicoin APImax.maicoin.com ↗
Access real-time tickers, order books, OHLCV candles, and trade history for all MAX Exchange (MaiCoin) trading pairs via a structured REST API.
What is the Maicoin API?
This API exposes 10 endpoints covering real-time market data from MAX Exchange (MaiCoin), Taiwan's largest TWD-denominated cryptocurrency exchange. Fetch live tickers for every active trading pair via get_all_tickers, retrieve depth data with get_order_book, pull OHLCV candlesticks across 12 time periods with get_candles, and inspect fee tiers with get_vip_levels — all returning structured JSON with no authentication required.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/1ace5ad6-2d1a-419f-9d98-87f8f071115d/get_usdt_twd_ticker' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace max-maicoin-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""MAX Exchange API — bounded, re-runnable walkthrough."""
from parse_apis.max_exchange_api import MaxExchange, CandlePeriod, MarketNotFound
client = MaxExchange()
# List all markets and inspect the first few
for market in client.markets.list(limit=3):
print(market.id, market.name, market.base_unit, market.quote_unit)
# Construct a market by ID and fetch its order book
btc = client.market(id="btctwd")
order_book = btc.order_book.get(limit=5)
print("BTC/TWD spread:", order_book.bids[0], order_book.asks[0], "at", order_book.timestamp)
# Get recent trades for a market
for trade in btc.trades.list(limit=3):
print(trade.id, trade.side, trade.price, trade.volume)
# Fetch OHLCV candles with a specific period
for candle in btc.candles.list(period=CandlePeriod.ONE_HOUR, limit=3):
print(candle.timestamp, candle.open, candle.close, candle.volume)
# Typed error handling for an invalid market
try:
bad = client.market(id="invalidxyz")
bad.order_book.get()
except MarketNotFound as exc:
print(f"Market not found: {exc.market_id}")
# Exchange metadata: currencies and VIP fee tiers
currency = client.currencies.list(limit=1).first()
if currency:
print(currency.id, currency.precision, currency.m_wallet_supported)
vip = client.viplevels.list(limit=1).first()
if vip:
print("Level", vip.level, "maker:", vip.maker_fee, "taker:", vip.taker_fee)
print("exercised: markets.list / market.order_book.get / market.trades.list / market.candles.list / currencies.list / viplevels.list")
Retrieve real-time ticker data for the USDT/TWD trading pair. Returns bid/ask prices, 24h high/low/open, last trade price, and volume metrics. A convenience shortcut equivalent to fetching the usdttwd entry from get_all_tickers.
No input parameters required.
{
"type": "object",
"fields": {
"at": "integer, Unix timestamp of the ticker snapshot",
"buy": "string, best bid price",
"low": "string, 24h lowest price",
"vol": "string, 24h base currency volume",
"high": "string, 24h highest price",
"last": "string, last trade price",
"open": "string, 24h opening price",
"sell": "string, best ask price",
"buy_vol": "string, volume at best bid",
"sell_vol": "string, volume at best ask",
"vol_in_btc": "string, 24h volume denominated in BTC",
"vol_in_quote": "string, 24h volume denominated in quote currency"
},
"sample": {
"data": {
"at": 1781168317,
"buy": "31.682",
"low": "31.682",
"vol": "7064032.73",
"high": "31.797",
"last": "31.683",
"open": "31.741",
"sell": "31.683",
"buy_vol": "40166.55",
"sell_vol": "51868.22",
"vol_in_btc": "112.262949807713166351",
"vol_in_quote": "223171708.1002555569"
},
"status": "success"
}
}About the Maicoin API
Market Data Coverage
The API covers all active trading pairs listed on MAX Exchange. get_all_tickers returns a single response keyed by market ID (e.g. usdttwd, btctwd, ethusdt) where each entry includes buy, sell, last, open, high, low, vol, buy_vol, sell_vol, vol_in_btc, and vol_in_quote. For TWD/USDT specifically, get_usdt_twd_ticker provides the same fields as a dedicated shortcut. get_market_summary combines tickers with per-coin status flags (withdraw, deposit, trade as strings), useful for detecting coins that are temporarily suspended.
Order Books and Trade History
get_order_book accepts a market_id (obtain valid IDs from get_markets) and an optional limit parameter. It returns asks sorted by price ascending and bids sorted descending, each as arrays of [price, volume] string pairs, plus a Unix timestamp. get_trades returns recent public trades for a market, each trade including id, price, volume, funds, side (bid or ask), market, market_name, created_at, and created_at_in_ms — sorted most recent first.
Candles and Exchange Metadata
get_candles accepts market_id, a period in minutes (1, 5, 15, 30, 60, 120, 240, 360, 720, 1440, 4320, or 10080), and a limit. Each returned item is an array of [timestamp, open, high, low, close, volume]. get_markets lists every trading pair with base_unit, quote_unit, precision, market_status, and minimum order amounts. get_currencies lists all supported currencies with precision, sygna_supported, m_wallet_supported, and min_borrow_amount. get_vip_levels exposes the full fee schedule: level, maker_fee, taker_fee, minimum_trading_volume (30-day, in TWD), and minimum_staking_volume in MAX tokens.
The Maicoin API is a managed, monitored endpoint for max.maicoin.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when max.maicoin.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official max.maicoin.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track real-time TWD-denominated BTC and ETH prices using get_all_tickers for a Taiwan-focused crypto dashboard
- Build an order book visualizer for any MAX Exchange pair using get_order_book with a configurable depth limit
- Run technical analysis strategies by fetching OHLCV data from get_candles with periods from 1 minute to 1 week
- Monitor coin deposit/withdrawal availability via the coins status flags in get_market_summary
- Calculate trading fee estimates for different volume tiers using maker_fee and taker_fee from get_vip_levels
- Synchronize client-side clocks against exchange time using get_server_timestamp before order placement logic
- Filter tradeable pairs programmatically by market_status and minimum order amounts from get_markets
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.