TIME Coin API Reference

Public REST API for TIME Coin — supply data, live exchange rates, and aggregator-compatible market endpoints for CoinGecko and CoinMarketCap listings.

Base URL

Production https://timecoin.io/api/v1

All endpoints below are relative to this base. Responses are application/json unless noted. No authentication required for public endpoints.

Rate Limits

100 requests / minute per IP address. Exceeding this limit returns 429 Too Many Requests.

Total Supply

Returns the total number of TIME coins ever emitted — block height × 100 coins per block.

GET /api/v1/supply text/plain

Returns a plain-text integer. No parameters required.

Response

143580000

Try it

Circulating Supply

Total supply minus TIME locked in active masternodes (Bronze 1K, Silver 10K, Gold 100K collateral).

GET /api/v1/circulating text/plain

Response

141230000

Try it

Exchange Rates

Active exchange rates for all supported payment coins. Auto-updated every 10 minutes from CoinGecko. 1 TIMC = $1 USD is the current peg.

GET /api/v1/rates JSON array

Returns all active rates. Supported payment coins: BTC, ETH, USDT, USDC, SOL, BNB.

Response Fields

Field	Type	Description
payment_coin	string	Payment currency symbol
time_per_coin	string	TIMC you receive per 1 unit of payment coin
min_pay_amount	string	Minimum order in payment coin
max_pay_amount	string	Maximum order in payment coin
created_at	string	ISO-8601 timestamp rate was set

Response · JSON

[
  {
    "payment_coin":   "BTC",
    "time_per_coin":  "84321.00000000",
    "min_pay_amount": "0.00011860",
    "max_pay_amount": "0.11860000",
    "created_at":     "2026-03-25T10:00:00.000Z"
  },
  {
    "payment_coin":   "USDT",
    "time_per_coin":  "1.00000000",
    "min_pay_amount": "10.00",
    "max_pay_amount": "10000.00",
    "created_at":     "2026-03-25T10:00:00.000Z"
  }
]

Try it

Health Check

Returns service status and network identifier. Useful for uptime monitoring.

GET /api/health JSON

Response · JSON

{
  "ok":      true,
  "service": "time-exchange-api",
  "network": "mainnet",
  "ts":      1742898000000
}

Try it

Aggregator — Tickers

CoinGecko-compatible ticker data for all TIMC trading pairs. Returns 24-hour price and volume for each pair.

CoinGecko integration: Submit /api/v1/aggregator/tickers as your exchange's tickers endpoint in the CoinGecko listing form.

GET /api/v1/aggregator/tickers CoinGecko format

Response Fields

Field	Type	Description
ticker_id	string	Pair identifier e.g. `TIMC_USDT`
base_currency	string	Always `TIMC`
target_currency	string	Quote currency (BTC, ETH, USDT, USDC, SOL, BNB)
last_price	string	Price of 1 TIMC in quote currency (last trade)
base_volume	string	TIMC volume traded in last 24h
target_volume	string	Quote currency volume in last 24h
bid / ask	string	Current price (fixed exchange — bid equals ask)
high / low	string	24h price range in quote currency

Response · JSON

[
  {
    "ticker_id":       "TIMC_USDT",
    "base_currency":   "TIMC",
    "target_currency": "USDT",
    "last_price":      "1.00",
    "base_volume":     "15842.00000000",
    "target_volume":   "15842.00",
    "bid":             "1.00",
    "ask":             "1.00",
    "high":            "1.00",
    "low":             "1.00"
  }
]

Try it

Aggregator — Summary

CoinMarketCap-compatible 24h market summary, keyed by ticker ID.

CoinMarketCap integration: Submit /api/v1/aggregator/summary as your exchange's summary endpoint in the CMC listing form.

GET /api/v1/aggregator/summary CMC format

Response · JSON

{
  "TIMC_USDT": {
    "trading_pairs":             "TIMC_USDT",
    "base_currency":             "TIMC",
    "quote_currency":            "USDT",
    "last_price":               1.0,
    "lowest_ask":               1.0,
    "highest_bid":              1.0,
    "base_volume":              15842.0,
    "quote_volume":             15842.0,
    "price_change_percent_24h": 0,
    "highest_price_24h":        1.0,
    "lowest_price_24h":         1.0
  }
}

Try it

Aggregator — Assets

Static asset metadata for TIMC, used by CMC exchange listing validation.

GET /api/v1/aggregator/assets CMC asset format

Response · JSON

{
  "TIMC": {
    "name":                    "TIMC",
    "unified_cryptoasset_id": null,
    "can_withdraw":           false,
    "can_deposit":            true,
    "min_withdraw":           "0",
    "max_withdraw":           "0",
    "maker_fee":              "0",
    "taker_fee":              "0"
  }
}

Try it

Aggregator — Order Book

Single fixed-price level backed by the hot wallet's available balance. Bid equals ask on a fixed-price exchange.

GET /api/v1/aggregator/orderbook bids & asks

Query Parameters

Param	Type	Description
ticker_idoptional	string	Default: `TIMC_USDT`. Supported: TIMC_BTC, TIMC_ETH, TIMC_USDT, TIMC_USDC, TIMC_SOL, TIMC_BNB
depthoptional	integer	Max levels to return (default 10, max 100). Always returns 1 level on a fixed-price exchange.

Response · JSON

{
  "ticker_id":  "TIMC_USDT",
  "timestamp":  1742898000000,
  "bids": [
    ["1.00", "48320.00000000"]
  ],
  "asks": [
    ["1.00", "48320.00000000"]
  ]
}

Try it

Aggregator — Trades

Recent completed trades for a pair. Each entry is a completed exchange order. All trades are "buy" — users purchase TIMC using crypto.

GET /api/v1/aggregator/trades historical trades

Query Parameters

Param	Type	Description
ticker_idoptional	string	Default: `TIMC_USDT`
limitoptional	integer	Number of trades (default 50, max 200)
start_timeoptional	integer	Unix timestamp ms — filter trades after this time
end_timeoptional	integer	Unix timestamp ms — filter trades before this time

Response Fields

Field	Type	Description
trade_id	string	Unique order UUID
price	string	Price of 1 TIMC in quote currency at time of trade
base_volume	string	TIMC amount purchased
target_volume	string	Quote currency amount paid
trade_timestamp	integer	Unix timestamp in milliseconds
type	string	Always `"buy"`

Response · JSON

[
  {
    "trade_id":        "550e8400-e29b-41d4-a716-446655440000",
    "price":           "1.00",
    "base_volume":     "500.00000000",
    "target_volume":   "500.00",
    "trade_timestamp": 1742898000000,
    "type":            "buy"
  }
]

Try it