Counterparty DEX API reference

Base URL: https://api.counterwallet.io/api/v1. All endpoints are public, read-only GET requests returning JSON with CORS enabled.

CoinMarketCap

Current and historical Counterparty DEX data is limited to assets CoinMarketCap already lists. Other protocol markets are intentionally excluded from this adapter.

GET /coinmarketcap/summary

One summary object per published market.

[
  {
    "trading_pairs": "XCP_BTC",
    "base_currency": "XCP",
    "quote_currency": "BTC",
    "last_price": "0.000059",
    "lowest_ask": "0.000060",
    "highest_bid": null,
    "base_volume": "1191.00000000",
    "quote_volume": "0.07107040",
    "price_change_percent_24h": "3.51",
    "highest_price_24h": "0.000060",
    "lowest_price_24h": "0.000057",
    "last_trade_timestamp": 1788369632000,
    "is_stale": false,
    "type": "spot"
  }
]

GET /coinmarketcap/assets

Asset metadata keyed by symbol. Every published asset has a verified CoinMarketCap UCID.

{
  "XCP": {
    "name": "Counterparty",
    "unified_cryptoasset_id": 132,
    "can_withdraw": true,
    "can_deposit": true,
    "maker_fee": "0",
    "taker_fee": "0",
    "network": "counterparty",
    "self_custodial": true,
    "asset_url": "https://xcp.io/asset/XCP"
  }
}

GET /coinmarketcap/ticker

Rolling ticker objects keyed by market pair. isFrozen: 1 identifies a historical market whose last settlement is more than 90 days old.

{
  "XCP_BTC": {
    "base_id": 132,
    "quote_id": 1,
    "base_currency": "XCP",
    "quote_currency": "BTC",
    "last_price": "0.000059",
    "base_volume": "1191.00000000",
    "quote_volume": "0.07107040",
    "isFrozen": 0,
    "last_trade_timestamp": 1788369632000
  }
}

GET /coinmarketcap/orderbook/{market_pair}

Price-level arrays are [price, base quantity]. Optional ?depth=100; zero or omitted returns all available levels, capped at 500 per side.

{
  "timestamp": 1788372679760,
  "bids": [],
  "asks": [["0.000060", "1196.00000000"]]
}

GET /coinmarketcap/trades/{market_pair}

Completed settlements, newest first. Optional parameters: start_time, end_time, and limit (maximum 1000).

[
  {
    "trade_id": 2176994,
    "price": "0.000059",
    "base_volume": "15.00000000",
    "quote_volume": "0.00088500",
    "timestamp": 1788369632000,
    "type": "buy"
  }
]

CoinGecko

The initial submission profile contains only XCP_BTC. This avoids mapping older Counterparty assets to unrelated projects that reuse their symbols.

GET /coingecko/pairs

[
  {
    "ticker_id": "XCP_BTC",
    "base": "XCP",
    "target": "BTC",
    "pool_id": "XCP_BTC"
  }
]

GET /coingecko/tickers

AMM-backed rows additionally include liquidity_in_usd.

[
  {
    "ticker_id": "XCP_BTC",
    "base_currency": "XCP",
    "target_currency": "BTC",
    "pool_id": "XCP_BTC",
    "last_price": "0.000059",
    "base_volume": "1191.00000000",
    "target_volume": "0.07107040",
    "bid": null,
    "ask": "0.000060",
    "high": "0.000060",
    "low": "0.000057",
    "last_trade_timestamp": 1788369632000,
    "is_stale": false
  }
]

GET /coingecko/orderbook?ticker_id=XCP_BTC&depth=100

{
  "ticker_id": "XCP_BTC",
  "timestamp": 1788372679760,
  "bids": [],
  "asks": [["0.000060", "1196.00000000"]]
}

GET /coingecko/historical_trades?ticker_id=XCP_BTC&limit=100

Optional type, start_time, and end_time filters. Trade timestamps are Unix seconds.

{
  "buy": [
    {
      "trade_id": 2176994,
      "price": "0.000059",
      "base_volume": "15.00000000",
      "target_volume": "0.00088500",
      "trade_timestamp": 1788369632,
      "type": "buy",
      "source": "dispenser",
      "settlement_txid": "79611adc...def37"
    }
  ],
  "sell": []
}

Reference

OpenAPI document · Methodology · Supported-market catalog · Status · Gateway home