ShitcoinBTC Public APIs v1

Read-only public APIs for the ShitcoinBTC chain, the ShityDEX exchange, Shity Swap, and the mining pool. Every number served by these APIs comes from the system it describes: chain data from the node's own RPC, exchange data from the exchange's own executed trades and open orders, pool data from the pool's own records. Where there is no data, the APIs return zero, empty, or null, never an estimate presented as a measurement.

Base URL https://shitcoinbtc.xyzVersion /api/v1/Public reads need no key

Common rules

TopicRule
Base URLhttps://shitcoinbtc.xyz (HTTPS only; plain HTTP redirects to HTTPS)
VersioningAll public APIs live under /api/v1/. Breaking changes will ship as /api/v2/; v1 paths are not silently repurposed. The CoinGecko-schema aliases under /api/coingecko/ follow CoinGecko's own unversioned convention.
MethodsPublic read APIs are read only and other methods return 405. On the chain, exchange, and CoinGecko subtrees both GET and HEAD work. On the pool and swap subtrees HEAD returns 501, so use GET there. The signed trading API in section 7 also uses POST and DELETE on its own endpoints.
TimestampsAlmost every success response from the /api/v1/ public APIs carries a top-level timestamp field: UTC, ISO-8601, e.g. "2026-11-17T08:25:17Z", generated when the response is produced. One exception: GET /api/v1/markets returns {"ok": true, "count": 63, "markets": [...]} with no top-level timestamp field. CoinGecko-schema responses keep CoinGecko's shape (their trade records carry their own timestamp fields). The signed trading API (section 7) uses Unix milliseconds in its CCXT-shaped payloads.
Rate limitsPublic read APIs: 60 requests / minute per IP, with short bursts up to 20 requests. On the chain, exchange, CoinGecko, and pool subtrees, responses are cached at the edge for 15 seconds (Cache-Control: public, max-age=15), so polling faster than that can return the same body. The swap subtree and the signed trading subtree send no Cache-Control header, so do not assume a 15 second cache there. Over the limit: HTTP 429 in the error shape below. The signed trading API has its own limits, listed in section 7.
CORSThe chain, exchange, CoinGecko, and pool read endpoints send Access-Control-Allow-Origin: *. The swap subtree sends no CORS headers on its responses, and the signed trading subtree sends an Access-Control-Allow-Methods header but no Access-Control-Allow-Origin: *. No credentials are used or accepted on public reads.

Errors from the public read APIs always use this shape, no HTML error pages:

{"error": "human-readable message", "code": 404, "timestamp": "2026-11-17T08:25:17Z"}
StatusMeaning
400Bad parameter. Behaviour differs by endpoint: a block id that is neither a height nor a 64-character hash returns 400 on the chain endpoints, and /api/v1/exchange/trades without a ticker_id (or market) returns 400 because that parameter is required there. By contrast, /api/v1/exchange/orderbook without a market parameter does not return 400: it returns 200 and defaults to BTC/USDT.
404Unknown route, or the requested block / transaction does not exist
405Method other than GET (or HEAD, where HEAD is supported) on a read-only API
501HEAD on the pool and swap subtrees, which support GET only
429Rate limit exceeded
502 / 503The data source behind the endpoint is temporarily unavailable; the body still uses the error shape above

Chain API Status LIVE

ShitcoinBTC chain data, served from the node's own RPC. Read-only. No wallet data, no addresses' balances: for address and rich-list views use the block explorer.

GET/api/v1/chain/status

Current tip, network, and NEVM reporting state. The nevm object reports both sources (the node's NEVM info and the execution client's chain id and head) exactly as they answer; it does not merge them into a single claim.

curl https://shitcoinbtc.xyz/api/v1/chain/status
{
  "chain": "main", "height": 169061, "headers": 169061,
  "tip_hash": "9496fa18419482d90ffa400dfd22d99f69b0630894e63d476a000b607887f7b3",
  "difficulty": 29965.75495196299, "mediantime": 1794903712,
  "peers": 33, "network_active": true,
  "node_version": "/Satoshi:5.0.9/", "protocol_version": 70017,
  "nevm": {"chain_id": 20026, "geth_block_number": 0,
           "syscoind_height": 138746, "syscoind_status": "online"},
  "timestamp": "2026-11-17T08:25:17Z"
}

Values sampled from production on 2026-11-17; peer count and NEVM fields vary and can be null when a source does not answer.

GET/api/v1/chain/block/{hashOrHeight}

One block, by height (decimal) or by 64-character hex hash. The response is the node's block object (verbose), wrapped as {"block": {…}, "timestamp": …}. The raw AuxPoW field is omitted.

curl https://shitcoinbtc.xyz/api/v1/chain/block/169061

GET/api/v1/chain/tx/{txid}

One transaction by txid (64-character hex), decoded by the node, wrapped as {"tx": {…}, "timestamp": …}. Unknown txids return 404 in the common error shape.

curl https://shitcoinbtc.xyz/api/v1/chain/tx/<txid>

GET/api/v1/chain/supply

Supply figures, each with the method that produced it stated in the response itself:

The 17% vault yield reserve is tracked by the protocol, is not issued into the UTXO set, and is excluded from both figures; the response says so in its excluded field. Burned or unspendable outputs are issued but not in the UTXO set, so issued and circulating differ slightly; the response reports the difference.

Two heights, read carefully: the response headline height is the live tip height, while circulating_supply is measured from the UTXO set, which is cached for up to 120 seconds, so utxo_set.height, the height of that UTXO set, can lag the tip height by a few blocks. Use the headline height for the tip and utxo_set.height for the height the circulating figure actually measures; the gap between issued and circulating therefore includes that cache lag, not only burned or unspendable outputs.

curl https://shitcoinbtc.xyz/api/v1/chain/supply
{
  "height": 169061, "max_supply": 21000000000, "max_supply_unit": "SHIT",
  "circulating_supply": "8430137423.934916",
  "total_issued_supply": "8430137424.87520660",
  "issued_minus_circulating": "0.94029060",
  "utxo_set": {"txouts": 147309, "transactions": 122385, "height": 169061},
  "timestamp": "2026-11-17T08:25:17Z"
}

Figures sampled from production on 2026-11-17. The live difference between issued and circulating at sampling time was 0.94029060 SHIT, as returned in the response field issued_minus_circulating.

GET/api/v1/chain/stats

Aggregate chain statistics: height, difficulty, chainwork, total transaction count and rate, UTXO counts and total, network hash rate as reported by the node, mempool size / bytes / total fee, and the 30-second target block time.

curl https://shitcoinbtc.xyz/api/v1/chain/stats

Exchange market data Status LIVE

Public market data for ShityDEX, built only from the exchange's own records: its markets list, its executed trades, and its currently open orders. Prices from other exchanges are never used as a last price, a volume, a bid, or an ask here.

Read this before using the numbers. The exchange's recorded trade history is 1,261 executed trades, sampled from production on 2026-11-17, and every recorded trade is on NMC/USDT. In the trailing 24 hours at sampling time there were 261 trades, all on NMC/USDT, so trailing 24h volume is nonzero only on NMC/USDT and is 0 on every other market. last_price is the price of the most recent executed trade whenever one exists, for NMC/USDT that was 1.00544094 at 2026-11-17T08:24:28Z, with last_trade_at always next to it so the age of the price is visible. BTC/USDT has no recorded trades at all: it reports last_price "0", last_trade_at null, and an empty order book. Markets with no recorded trade report last_price "0" and last_trade_at null. liquidity_in_usd is "0": no live pool backs any pair.

Responses from this subtree wrap data in an envelope: {"timestamp", "timestamp_unix", "source": "shitydex_own_records_read_only", … , "data": …}. Price and volume values are decimal strings.

GET/api/v1/exchange/status

Service health and record counts: markets count, total recorded trades, trades in the last 24h, the time of the most recent trade, and open-order count.

curl https://shitcoinbtc.xyz/api/v1/exchange/status

GET/api/v1/exchange/markets

The markets list, from the same markets configuration the exchange itself loads. Each entry: market (e.g. BTC/USDT), ticker_id (e.g. BTC_USDT), base_currency, target_currency, base_name.

curl https://shitcoinbtc.xyz/api/v1/exchange/markets

GET/api/v1/exchange/tickers

One entry per market: last_price and last_trade_at / last_trade_timestamp from the most recent executed trade; base_volume, target_volume, trades_24h, high_24h, low_24h over the trailing 24 hours only; best bid / ask from the exchange's own open orders (null when that side is empty); change_24h_pct is null when there were no trades in the window, a change cannot be computed from no trades; liquidity_in_usd as described above.

curl https://shitcoinbtc.xyz/api/v1/exchange/tickers
{
  "timestamp": "2026-11-17T08:25:17Z", "timestamp_unix": 1794903917,
  "source": "shitydex_own_records_read_only",
  "data": [{
    "market": "NMC/USDT", "ticker_id": "NMC_USDT",
    "base_currency": "NMC", "target_currency": "USDT",
    "last_price": "1.00544094", "last_trade_at": "2026-11-17T08:24:28Z",
    "base_volume": "325.09663216", "target_volume": "326.24999863293857", "trades_24h": 261,
    "high_24h": "1.01980775", "low_24h": "0.98575276", "change_24h_pct": null,
    "bid": "0.99580052", "ask": "1.00580857", "liquidity_in_usd": "0"
  }]
}

Example sampled from production on 2026-11-17. In the same response, BTC/USDT reported last_price "0", last_trade_at null, and bid and ask null, because it has no recorded trades and no open orders.

GET/api/v1/exchange/orderbook?market=BTC/USDT

The exchange's own open orders for one market, aggregated by price level: bids / asks as {"price", "size"} string pairs, with depth_source: "shitydex_own_book_only". No external exchange depth is merged in.

curl 'https://shitcoinbtc.xyz/api/v1/exchange/orderbook?market=BTC/USDT'

If the market parameter is omitted, this endpoint returns 200 and defaults to BTC/USDT. Sampled from production on 2026-11-17, the BTC/USDT book was empty, with no bids and no asks, while the NMC/USDT book had bids starting at 0.99580052 and asks starting at 1.00580857.

GET/api/v1/exchange/trades?ticker_id=NMC_USDT&limit=100

Executed trades for one market, newest first. The ticker_id parameter (or market) is required: calling this endpoint without it returns 400. limit 1 to 1000, default 100. Each record: trade_id, ticker_id, market, price, base_volume, target_volume, timestamp (Unix seconds) and timestamp_iso. The trades table does not record which side took the trade, so no side is reported, it is omitted rather than guessed.

curl 'https://shitcoinbtc.xyz/api/v1/exchange/trades?ticker_id=NMC_USDT&limit=2'
{
  "timestamp": "2026-11-17T08:25:17Z", "ticker_id": "NMC_USDT",
  "market": "NMC/USDT", "count": 2, "total_recorded": 1261,
  "data": [
    {"trade_id": 2411, "ticker_id": "NMC_USDT", "market": "NMC/USDT",
     "price": "1.00544094", "base_volume": "1.24323562", "target_volume": "1.2499999904142828",
     "timestamp": 1794903868, "timestamp_iso": "2026-11-17T08:24:28Z"},
    {"trade_id": 2410, "ticker_id": "NMC_USDT", "market": "NMC/USDT",
     "price": "0.99647109", "base_volume": "1.25442675", "target_volume": "1.2499999908976575",
     "timestamp": 1794903554, "timestamp_iso": "2026-11-17T08:19:14Z"}
  ]
}

GET/api/v1/exchange/assets

Assets appearing in the markets list, with how many markets each is base or quote in. Deposit and withdrawal availability per asset is not exposed by this endpoint: it is not verifiable from the markets configuration or the read-only records this service uses, so it is not claimed.

curl https://shitcoinbtc.xyz/api/v1/exchange/assets

CoinGecko-schema aliases Status LIVE

The same exchange records, in the response shapes CoinGecko's DEX / exchange integration expects. The pairs and tickers routes return bare JSON arrays without the envelope above, per that schema. The historical_trades route is the exception: it returns the full exchange envelope (timestamp, timestamp_unix, source, ticker_id, market, count, total_recorded, and data), the same shape as /api/v1/exchange/trades. The data rules of the exchange section apply unchanged: last prices are executed-trade prices, 24h volumes are trailing-24h sums, and nothing is sourced from reference prices.

GET/api/coingecko/pairs

curl https://shitcoinbtc.xyz/api/coingecko/pairs
[{"ticker_id": "BTC_USDT", "base": "BTC", "target": "USDT"}, …]

GET/api/coingecko/tickers

Fields per ticker: ticker_id, base_currency, target_currency, last_price, last_trade_at, base_volume, target_volume, bid, ask, high, low, liquidity_in_usd.

curl https://shitcoinbtc.xyz/api/coingecko/tickers

GET/api/coingecko/historical_trades?ticker_id=BTC_USDT&limit=100

Same records and parameters as /api/v1/exchange/trades, and the same envelope shape, as described above. This route does not return a bare array.

curl 'https://shitcoinbtc.xyz/api/coingecko/historical_trades?ticker_id=BTC_USDT&limit=100'

Mining pool API Status LIVE

Aggregate statistics for the ShitcoinBTC mining pool: a Bitcoin stratum pool (stratum host and port are in the /status response) with SHIT, SYS and NMC merge-mining. This API serves aggregates from the pool's own records only. It never returns miner or payout addresses, per-miner balances or earnings, worker names, block finders, or connection IPs, those exist in the pool's records and are deliberately not published.

Read the state live, not from this page. This section used to carry a written snapshot of the pool's state, and snapshots go stale. The endpoints below report the state as it is right now: /status includes miners online, hashrate, payouts_enabled, the SHIT aux state, and last_ready_at for the Bitcoin feed so a timeout window is not mistaken for a dead feed. Share history is limited by the pool's own 7-day share retention.

GET/api/v1/pool/status

Pool identity, stratum host / port, Bitcoin feed health (state, btc_tip_height, last_ready_at), current job, SHIT aux state, and whether payouts are enabled.

curl https://shitcoinbtc.xyz/api/v1/pool/status

GET/api/v1/pool/hashrate

Hashrate computed the pool's own way: the sum of accepted share difficulty in the window, × 232, ÷ window seconds. Fields: hashrate_hps (600-second window), hashrate_1h_hps, accepted_shares_in_window, window_seconds, method. With no accepted shares the hashrate is 0.

curl https://shitcoinbtc.xyz/api/v1/pool/hashrate

GET/api/v1/pool/hashrate/history?bucket=3600

Bucketed hashrate history. bucket is 600, 3600, or 86400 seconds (default 3600). Coverage can never exceed the pool's 7-day share retention.

curl 'https://shitcoinbtc.xyz/api/v1/pool/hashrate/history?bucket=3600'

GET/api/v1/pool/workers

Aggregate counts only: distinct miners online and workers online (the pool's own 600-second last-seen window), plus the total worker-row count with a note that rows include test-era registrations and are not a miner count.

curl https://shitcoinbtc.xyz/api/v1/pool/workers

GET/api/v1/pool/shares

Recorded accepted / rejected share totals, all-time and trailing 24h, plus the running pool process's in-memory counters. The two can differ (for example, duplicate shares are counted in memory but written as no database row); the response explains this. Rejected shares are recorded without a reason, so no reject reasons are reported.

curl https://shitcoinbtc.xyz/api/v1/pool/shares

GET/api/v1/pool/blocks?limit=50

Blocks the pool has recorded: chain, height, hash, time; totals overall and by chain. limit 1 to 200, default 50. Finder information is not returned.

curl 'https://shitcoinbtc.xyz/api/v1/pool/blocks?limit=50'

GET/api/v1/pool/fees

The pool's configured fee and payout parameters, as data fields: the pool fee percentage for each coin, payout method, payout thresholds, and payout schedule, exactly as configured in the pool software.

curl https://shitcoinbtc.xyz/api/v1/pool/fees

GET/api/v1/pool/payouts

Payout configuration and the live payouts_enabled flag. No per-miner balances or payout rows are exposed.

curl https://shitcoinbtc.xyz/api/v1/pool/payouts

Swap API Status LIVE

Shity Swap is non-custodial: swaps execute in the user's own wallet against external aggregator venues. This read-only API reports quote availability and live quotes from the same venues the swap page uses. It never builds transactions, signs, or places orders.

Quotes are not swaps. Every quote response is labeled "type": "quote" and "is_completed_swap": false. The platform keeps no swap ledger, so there is no completed-swaps feed to publish: the /swaps endpoint below says exactly that instead of inventing one. A chain is listed as available only when a live probe quote for it returned a non-zero output amount at probe time (probes are cached for 60 seconds); every other chain is listed as unavailable, with the probe failure as the reason.

GET/api/v1/swap/chains

Per-chain availability, probed live: for each chain, its status (available / unavailable), the venue that answered, and the probe result or failure reason. Response includes available_count and unavailable_count. Do not cache the list as permanent truth, availability is a probe result, and it changes.

curl https://shitcoinbtc.xyz/api/v1/swap/chains

Probe record, 2026-11-17 at 08:27 UTC: one live probe of this endpoint returned 12 available chains and 29 unavailable chains. Available in that probe: Monad, Hyperevm, Polygon, and Optimism via Kyber; Zksync, Scroll, Mantle, Metis, Rootstock, and Mode via LiFi; Fantom via SpookySwap direct; and Solana via Jupiter. Most other chains were unavailable in that probe because their venues answered HTTP 429 (rate limited), including Velora on Ethereum, Base, BNB Chain, and Arbitrum, and Kyber on Unichain, Linea, and Plasma. Probe results change from one probe to the next as venue rate limits come and go, so read the live endpoint for the current state.

GET/api/v1/swap/pairs?chain=ethereum

Only pairs verified quotable by a live probe are listed, each marked with that basis. This is not an enumeration of every pair the venues can price, any token pair can be quoted via /quote.

curl 'https://shitcoinbtc.xyz/api/v1/swap/pairs?chain=ethereum'

GET/api/v1/swap/quote?chain=ethereum&tokenIn=native&tokenOut=0x…&amountIn=10000000000000000

A live quote from the chain's venue. Required params: chain, tokenIn (native or a token address; a mint address on Solana), tokenOut, amountIn (integer, smallest units). The response is labeled as a quote with is_completed_swap: false. A quote is a price offer at that moment, it is not a completed swap, not a trade record, and not a volume figure.

curl 'https://shitcoinbtc.xyz/api/v1/swap/quote?chain=solana&tokenIn=So11111111111111111111111111111111111111112&tokenOut=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amountIn=10000000'

GET/api/v1/swap/liquidity?chain=avalanche

For chains where Shity Swap has its own AMM factory, this reports the factory's pair count read on-chain (0 means no own-pool liquidity). For other chains it explains that liquidity lives in the aggregators' underlying markets and is not exposed as a single verifiable number, no TVL figure is published, because none can be verified. A live quote is the liquidity evidence.

curl 'https://shitcoinbtc.xyz/api/v1/swap/liquidity?chain=avalanche'

GET/api/v1/swap/fees

Per-venue fee configuration, returned as data fields only, each with the source it was read from. This API charges nothing and executes nothing.

curl https://shitcoinbtc.xyz/api/v1/swap/fees

GET/api/v1/swap/swaps

Completed swaps: the response is an empty list with an explanation. Shity Swap is non-custodial and keeps no swap ledger or transaction record (the swap page's "recent swaps" list is stored per-browser), so no reliable record source exists and none is invented. The response also reports the verifiable on-chain state of Shity Swap's own-router factories: on Monad, HyperEVM, and Avalanche the factories report zero created pairs, so no own-router swap can have occurred on those chains.

curl https://shitcoinbtc.xyz/api/v1/swap/swaps

Exchange trading API v1: signed Status LIVE

The existing authenticated trading API for the exchange, at the same base as before. Response shapes follow the CCXT structure, and a ready-made CCXT exchange class is provided at /assets/shitcoinbtc_ccxt.py. This section replaces the previous version of this page; the corrections are listed at the bottom of the section.

Base URL https://shitcoinbtc.xyz/api/v1Spot onlySHIT is not listed on the exchange

Authentication & API keys

Private endpoints use API keys, not your password. Create keys while logged in:

  1. Log in: POST /api/user/login with {username, password} → returns a session token.
  2. Create a key: POST /api/v1/keys with the session token (Authorization: Bearer <token> or X-User-Token header) and {name, permissions}.
  3. You can also create and revoke keys from the API Keys tab in your account area at the bottom of the exchange page. The secret is shown once there too, and it is never shown again.
  4. The response contains key_id (public id, starts with scb_live_) and secret (starts with scbsk_).
The secret is shown exactly once. Save it immediately. List and revoke keys anytime with GET /api/v1/keys and DELETE /api/v1/keys.

Permissions: trade (default) or read (balances, orders, fills only; order placement returns 403). Key creation itself always requires a web session, an API key cannot mint new keys.

Request signing (HMAC-SHA256)

HeaderValue
X-API-KEYYour key_id
X-API-TIMESTAMPCurrent Unix time in milliseconds
X-API-SIGNHex HMAC-SHA256 signature (see below)
TIMESTAMP + "\n" + METHOD + "\n" + PATH + "\n" + QUERY + "\n" + BODY
signature = hex( HMAC_SHA256( secret, payload ) )

Rate limits & errors (trading API)

Limits as configured for this API: public endpoints 300 requests/minute per IP; private endpoints 600/minute per API key; order placement 120/minute per user; order cancellation 240/minute per user; key management 30/hour per user. An edge rate limit also applies to the whole /api/v1/ path. Over the limit → 429 with {"ok": false, "error": "rate_limited"}. Success: {"ok": true, …}. Failure: {"ok": false, "error": "code", "message": "human readable"} with the matching HTTP status (400 validation, 401 auth, 403 forbidden, 404 not found, 429 rate limited).

Public endpoints (no authentication)

GET/api/v1/markets

All spot markets in CCXT market format. Live count at the time of writing: 63 markets, sampled from production on 2026-11-17 and the same count returned by /api/v1/exchange/markets. Fee and limit values are returned per market as data fields (maker, taker, limits.cost.min, and so on): read them from the response rather than assuming them.

curl https://shitcoinbtc.xyz/api/v1/markets
{
  "ok": true, "count": 63,
  "markets": [{
    "id": "BTC/USDT", "symbol": "BTC/USDT",
    "base": "BTC", "quote": "USDT", "baseId": "BTC", "quoteId": "USDT",
    "active": true, "spot": true, "type": "spot",
    "precision": {"price": 8, "amount": 8},
    "limits": {"amount": {"min": 1e-08, "max": 21000000000.0},
               "price": {"min": 1e-08, "max": 10000000.0},
               "cost": {"min": 1.0, "max": null}},
    "taker": 0.00035, "maker": 0.00035, "info": {}
  }]
}

GET/api/v1/ticker?symbol=NMC/USDT

24h ticker in CCXT format. Know what each field is: high / low / open and the volumes come from this exchange's own trades and are null / 0 when there were none in the window. last / close on this legacy endpoint can reflect a reference price rather than the most recent executed trade, for an executed-trade last price with its trade time, use /api/v1/exchange/tickers above.

curl 'https://shitcoinbtc.xyz/api/v1/ticker?symbol=NMC/USDT'
{
  "ok": true,
  "ticker": {
    "symbol": "NMC/USDT", "timestamp": 1794903917000,
    "datetime": "2026-11-17T08:25:17.000Z",
    "high": 1.01980775, "low": 0.98575276, "open": 1.0067533,
    "bid": 0.99580052, "bidVolume": 1.47867734, "ask": 1.00580857, "askVolume": 1.35703532,
    "vwap": 1.0035477650607312, "close": 1.00544094, "last": 1.00544094,
    "previousClose": null, "change": -0.0013123600000000124, "percentage": -0.13035566906013743,
    "average": 1.002780255, "baseVolume": 325.09663215999996, "quoteVolume": 326.24999863293857, "info": {}
  }
}

Real response sampled from production on 2026-11-17. For comparison, BTC/USDT has no recorded trades at all, and its entry on /api/v1/exchange/tickers reports last_price "0" with last_trade_at null.

GET/api/v1/orderbook?symbol=NMC/USDT&limit=50

Order book in CCXT format. limit is depth per side, 1 to 200, default 50. Note: external reference depth may be reflected on this legacy endpoint, for this exchange's own open orders only, use /api/v1/exchange/orderbook.

curl 'https://shitcoinbtc.xyz/api/v1/orderbook?symbol=NMC/USDT&limit=5'
{
  "ok": true,
  "orderbook": {
    "symbol": "NMC/USDT", "timestamp": 1794903917000,
    "datetime": "2026-11-17T08:25:17.000Z",
    "bids": [[0.99580052, 1.47867734], [0.99279811, 1.47867734], [0.98979569, 1.47867734]],
    "asks": [[1.00580857, 1.35703532], [1.00881098, 1.35703532], [1.01181339, 1.35703532]], "nonce": null
  }
}

GET/api/v1/trades?symbol=NMC/USDT&limit=50

Recent public trades, newest first. limit 1 to 500, default 50. side is null on the public tape (taker side is not published); your own fills via /api/v1/trades/mine carry your side and fee.

curl 'https://shitcoinbtc.xyz/api/v1/trades?symbol=NMC/USDT&limit=2'
{
  "ok": true,
  "trades": [{
    "id": "2411", "timestamp": 1794903868000,
    "datetime": "2026-11-17T08:24:28.000Z",
    "symbol": "NMC/USDT", "order": null, "type": null,
    "side": null, "takerOrMaker": null,
    "price": 1.00544094, "amount": 1.24323562, "cost": 1.249999990414283,
    "fee": null, "info": {}
  }]
}

Private endpoints (signed)

GET/api/v1/account

Balances in CCXT format (free / used / total per coin).

POST/api/v1/order

Place a limit order (market orders are not offered on API v1). Funds are locked at placement; fills settle through the same matching engine as the web exchange.

FieldRequiredNotes
symbolyese.g. BTC/USDT
sideyesbuy or sell
typenolimit (only supported value)
amountyesBase currency amount, > 0
priceyesLimit price, > 0
timeInForcenoGTC (default), IOC, FOK

The response is a CCXT order object (id, status open | closed | canceled, filled, remaining, cost, average) plus any immediate fills in trades. Minimum order value is set per market in the markets response (limits.cost.min).

DELETE/api/v1/order?id=…

Cancel one open order (id as query param or JSON body {"id": …}). Locked funds are released. Response: {"ok": true, "cancelled": "…"}.

DELETE/api/v1/orders?symbol=BTC/USDT

Cancel all open orders (omit symbol to cancel across all markets).

GET/api/v1/order?id=…

Fetch one order by id (CCXT order format).

GET/api/v1/orders?symbol=BTC/USDT&limit=50

Open orders. Params: symbol (optional), limit 1 to 500 default 50, since (optional, Unix ms).

GET/api/v1/orders/history?symbol=BTC/USDT&limit=100

Order history (open, filled, cancelled). Same params as above; default limit 100.

GET/api/v1/trades/mine?symbol=BTC/USDT&limit=50

Your own fills, newest first, with per-fill fees. fee.currency is the base coin for buys and the quote coin for sells.

Key management

Authenticated with your web session token (see above), not an API key, except list / revoke, which also accept a valid API key of the same user.

POST/api/v1/keys

Fields: name (required, max 64 chars), permissions (trade default, or read). The response contains the new key_id and the one-time secret.

GET/api/v1/keys

List your keys. Secrets are never returned.

DELETE/api/v1/keys

Revoke a key: JSON body {"key_id": "scb_live_…"} (or ?key_id=). Takes effect immediately. A compromised key can revoke itself.

CCXT client

The provided class implements fetch_markets, fetch_ticker, fetch_order_book, fetch_trades, fetch_balance, create_order, cancel_order, cancel_all_orders, fetch_order, fetch_open_orders, fetch_orders, fetch_my_trades, plus API-key helpers (these need a session token from /api/user/login).

from shitcoinbtc_ccxt import shitcoinbtc

ex = shitcoinbtc({'apiKey': 'scb_live_…', 'secret': 'scbsk_…'})
print(ex.fetch_ticker('BTC/USDT')['last'])
order = ex.create_order('BTC/USDT', 'limit', 'buy', 0.001, 80000)
ex.cancel_order(order['id'], 'BTC/USDT')
Corrections in this revision (2026-11-17). The markets count is 63, verified live on both /api/v1/markets and /api/v1/exchange/markets. The trade, ticker, and order book examples in this revision are real responses sampled from production on 2026-11-17, and the active market in those examples is NMC/USDT, where all recorded trades have taken place. Earlier text that described recorded trades on BTC/USDT was wrong and has been removed. The ticker and order-book examples are real sampled responses, replacing earlier illustrative numbers that did not match the live tape. The behaviour of last on the legacy ticker is now described as it actually is, and readers who need an executed-trade price are pointed at /api/v1/exchange/tickers. Fee values appear only as data fields in API responses, not as prose on this page.