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.
| Topic | Rule |
|---|---|
| Base URL | https://shitcoinbtc.xyz (HTTPS only; plain HTTP redirects to HTTPS) |
| Versioning | All 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. |
| Methods | Public 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. |
| Timestamps | Almost 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 limits | Public 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. |
| CORS | The 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"}
| Status | Meaning |
|---|---|
| 400 | Bad 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. |
| 404 | Unknown route, or the requested block / transaction does not exist |
| 405 | Method other than GET (or HEAD, where HEAD is supported) on a read-only API |
| 501 | HEAD on the pool and swap subtrees, which support GET only |
| 429 | Rate limit exceeded |
| 502 / 503 | The data source behind the endpoint is temporarily unavailable; the body still uses the error shape above |
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.
/api/v1/chain/statusCurrent 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.
/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
/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>
/api/v1/chain/supplySupply figures, each with the method that produced it stated in the response itself:
circulating_supply The sum of every unspent output at the tip (the node's UTXO-set total). This is the only supply figure that is measured on-chain.total_issued_supply The block-1 allocation of 8,400,000,000 SHIT plus per-block coinbase issuance from block 2 to the tip, decaying 2% every 1,051,200 blocks.max_supply 21,000,000,000 SHIT, the hard cap.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.
/api/v1/chain/statsAggregate 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
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.
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.
/api/v1/exchange/statusService 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
/api/v1/exchange/marketsThe 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
/api/v1/exchange/tickersOne 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.
/api/v1/exchange/orderbook?market=BTC/USDTThe 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.
/api/v1/exchange/trades?ticker_id=NMC_USDT&limit=100Executed 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"}
]
}
/api/v1/exchange/assetsAssets 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
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.
/api/coingecko/pairscurl https://shitcoinbtc.xyz/api/coingecko/pairs
[{"ticker_id": "BTC_USDT", "base": "BTC", "target": "USDT"}, …]
/api/coingecko/tickersFields 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
/api/coingecko/historical_trades?ticker_id=BTC_USDT&limit=100Same 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'
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.
/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./api/v1/pool/statusPool 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
/api/v1/pool/hashrateHashrate 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
/api/v1/pool/hashrate/history?bucket=3600Bucketed 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'
/api/v1/pool/workersAggregate 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
/api/v1/pool/sharesRecorded 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
/api/v1/pool/blocks?limit=50Blocks 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'
/api/v1/pool/feesThe 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
/api/v1/pool/payoutsPayout configuration and the live payouts_enabled flag. No per-miner balances or payout rows are exposed.
curl https://shitcoinbtc.xyz/api/v1/pool/payouts
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.
"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./api/v1/swap/chainsPer-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.
/api/v1/swap/pairs?chain=ethereumOnly 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'
/api/v1/swap/quote?chain=ethereum&tokenIn=native&tokenOut=0x…&amountIn=10000000000000000A 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'
/api/v1/swap/liquidity?chain=avalancheFor 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'
/api/v1/swap/feesPer-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
/api/v1/swap/swapsCompleted 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
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.
Private endpoints use API keys, not your password. Create keys while logged in:
POST /api/user/login with {username, password} → returns a session token.POST /api/v1/keys with the session token (Authorization: Bearer <token> or X-User-Token header) and {name, permissions}.key_id (public id, starts with scb_live_) and secret (starts with scbsk_).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.
| Header | Value |
|---|---|
X-API-KEY | Your key_id |
X-API-TIMESTAMP | Current Unix time in milliseconds |
X-API-SIGN | Hex HMAC-SHA256 signature (see below) |
TIMESTAMP + "\n" + METHOD + "\n" + PATH + "\n" + QUERY + "\n" + BODY signature = hex( HMAC_SHA256( secret, payload ) )
PATH The full request path, e.g. /api/v1/order. QUERY The raw query string exactly as sent, or empty. BODY The raw request body, or empty.401.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).
/api/v1/marketsAll 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": {}
}]
}
/api/v1/ticker?symbol=NMC/USDT24h 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.
/api/v1/orderbook?symbol=NMC/USDT&limit=50Order 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
}
}
/api/v1/trades?symbol=NMC/USDT&limit=50Recent 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": {}
}]
}
/api/v1/accountBalances in CCXT format (free / used / total per coin).
/api/v1/orderPlace 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.
| Field | Required | Notes |
|---|---|---|
symbol | yes | e.g. BTC/USDT |
side | yes | buy or sell |
type | no | limit (only supported value) |
amount | yes | Base currency amount, > 0 |
price | yes | Limit price, > 0 |
timeInForce | no | GTC (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).
/api/v1/order?id=…Cancel one open order (id as query param or JSON body {"id": …}). Locked funds are released. Response: {"ok": true, "cancelled": "…"}.
/api/v1/orders?symbol=BTC/USDTCancel all open orders (omit symbol to cancel across all markets).
/api/v1/order?id=…Fetch one order by id (CCXT order format).
/api/v1/orders?symbol=BTC/USDT&limit=50Open orders. Params: symbol (optional), limit 1 to 500 default 50, since (optional, Unix ms).
/api/v1/orders/history?symbol=BTC/USDT&limit=100Order history (open, filled, cancelled). Same params as above; default limit 100.
/api/v1/trades/mine?symbol=BTC/USDT&limit=50Your own fills, newest first, with per-fill fees. fee.currency is the base coin for buys and the quote coin for sells.
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.
/api/v1/keysFields: name (required, max 64 chars), permissions (trade default, or read). The response contains the new key_id and the one-time secret.
/api/v1/keysList your keys. Secrets are never returned.
/api/v1/keysRevoke a key: JSON body {"key_id": "scb_live_…"} (or ?key_id=). Takes effect immediately. A compromised key can revoke itself.
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')
/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.