# Max Maicoin — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Get real-time cryptocurrency market data including live price tickers, order books, and trade history for USDT/TWD and other stablecoin pairs on the MAX Exchange. Monitor market summaries, access historical candles for technical analysis, and check VIP trading levels all from one platform.

**Category:** Web3 & Onchain | **Website:** [max.maicoin.com/](https://max.maicoin.com/) | **Docs:** [parse.bot/marketplace/c893e522-6fee-4be7-a0a0-03e3453aa10d/max-maicoin-com-api](https://parse.bot/marketplace/c893e522-6fee-4be7-a0a0-03e3453aa10d/max-maicoin-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_tickers

Retrieve real-time ticker data for every active trading pair on the exchange. Returns an object keyed by market ID (e.g. usdttwd, btctwd, ethusdt) where each value contains the same ticker fields as get_usdt_twd_ticker.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/get_all_tickers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_candles

Retrieve OHLCV candlestick (K-line) data for a market. Each candle is an array of [timestamp, open, high, low, close, volume]. Returns the most recent candles up to the specified limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of candles to return. |
| `market_id` | string | No | Market identifier (e.g. usdttwd, btctwd, ethusdt, solusdt). Obtain valid IDs from get_markets. |
| `period` | integer | No | Candle period in minutes. Accepted values: 1, 5, 15, 30, 60, 120, 240, 360, 720, 1440, 4320, 10080. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/get_candles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","market_id":"<string>","period":"<integer>"}'
```

### get_currencies

Retrieve all supported currencies with their decimal precision and feature flags (Sygna bridge support, M wallet support, minimum borrow amount).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/get_currencies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_market_summary

Retrieve a comprehensive market summary combining tickers for all trading pairs and coin status information (withdraw/deposit/trade availability). The tickers use slightly different field names (volume instead of vol) compared to get_all_tickers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/get_market_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_markets

Retrieve all available trading markets with details including market status, base/quote currency units, decimal precision, and minimum order amounts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/get_markets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_order_book

Retrieve the order book (bids and asks) for a specific market. Returns arrays of [price, volume] string pairs — asks sorted ascending by price, bids sorted descending. Also includes a timestamp and update metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of bid and ask entries to return. |
| `market_id` | string | No | Market identifier (e.g. usdttwd, btctwd, ethusdt, solusdt). Obtain valid IDs from get_markets. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/get_order_book \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","market_id":"<string>"}'
```

### get_server_timestamp

Retrieve the current server Unix timestamp in seconds. Useful for verifying connectivity and synchronizing clocks.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/get_server_timestamp \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_trades

Retrieve recent public trades for a specific market. Returns trades sorted by most recent first. Each trade includes price, volume, side (bid or ask), and timestamps.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of trades to return. |
| `market_id` | string | No | Market identifier (e.g. usdttwd, btctwd, ethusdt, solusdt). Obtain valid IDs from get_markets. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/get_trades \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","market_id":"<string>"}'
```

### get_usdt_twd_ticker

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.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/get_usdt_twd_ticker \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_vip_levels

Retrieve all VIP level fee tiers. Each level specifies maker/taker fee rates and minimum 30-day trading volume (in TWD) and MAX token staking volume requirements.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-max-maicoin-com-api-c893e522/get_vip_levels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```