Download

Integration Guide

XBO Market Kit > Integration Guide

Integration Guide

Developer documentation for custom integrations and advanced usage

1. Theme Integration

Integrate XBO Market Kit widgets directly into your WordPress theme templates.

Using do_shortcode()

Add widgets to any theme template file:

<?php
// In your theme's template file (header.php, sidebar.php, etc.)
echo do_shortcode('
BTC
BTC
BTC/USDT
--
0.00%
ETH
ETH
ETH/USDT
--
0.00%
');
?>

Conditional Display

<?php
// Show ticker only on homepage
if ( is_front_page() ) {
    echo do_shortcode('
BTC
BTC
BTC/USDT
--
0.00%
ETH
ETH
ETH/USDT
--
0.00%
SOL
SOL
SOL/USDT
--
0.00%
');
}

// Show movers on blog pages
if ( is_home() || is_archive() ) {
    echo do_shortcode('
PairPrice24h Change
IMU/USDT		$0.002143+20.66%
EUL/USDT		$1.34+11.12%
ICP/USDT		$2.95+9.41%
ZAMA/USDT		$0.03572+6.88%
XLM/USDT		$0.15958+6.81%
XLM/USDC		$0.15962+6.62%
XLM/USD		$0.15882+6.26%
XLM/EUR		$0.13651+6.24%
AR/USDT		$2.28+6.20%
SEI/USDT		$0.0693+5.80%
');
}
?>

Template Part Example

<?php
/**
 * Template Part: Crypto Ticker Bar
 * File: template-parts/crypto-ticker.php
 */
?>
<div class="crypto-ticker-bar">
    <?php echo do_shortcode('
BTC
BTC
BTC/USDT
--
0.00%
ETH
ETH
ETH/USDT
--
0.00%
BNB
BNB
BNB/USDT
--
0.00%
XRP
XRP
XRP/USDT
--
0.00%
'); ?>
</div>

2. Custom Styling

Override default styles to match your site’s design.

CSS Class Reference

All widgets use the .xbo-mk- prefix for CSS classes:

/* Ticker Widget */
.xbo-mk-ticker { }
.xbo-mk-ticker-card { }
.xbo-mk-ticker-symbol { }
.xbo-mk-ticker-price { }
.xbo-mk-ticker-change { }
.xbo-mk-ticker-change--positive { color: #49B47A; }
.xbo-mk-ticker-change--negative { color: #FD3B5E; }

/* Top Movers Widget */
.xbo-mk-movers { }
.xbo-mk-movers-list { }
.xbo-mk-movers-item { }

/* Order Book Widget */
.xbo-mk-orderbook { }
.xbo-mk-orderbook-bids { }
.xbo-mk-orderbook-asks { }

/* Recent Trades Widget */
.xbo-mk-trades { }
.xbo-mk-trades-list { }
.xbo-mk-trades-item { }

/* Slippage Calculator */
.xbo-mk-slippage { }
.xbo-mk-slippage-form { }
.xbo-mk-slippage-result { }

Custom Styles Example

Add to your theme’s style.css or Customizer:

/* Dark theme override */
.xbo-mk-ticker {
    background: #1a1a2e;
    border-radius: 12px;
    padding: 20px;
}

.xbo-mk-ticker-card {
    background: #16213e;
    border: 1px solid #0f3460;
}

.xbo-mk-ticker-symbol {
    color: #e94560;
    font-weight: 700;
}

.xbo-mk-ticker-price {
    color: #ffffff;
    font-size: 24px;
}

/* Responsive adjustments */
@media (max-width: 768px) {
    .xbo-mk-ticker {
        padding: 10px;
    }
    .xbo-mk-ticker-card {
        margin-bottom: 10px;
    }
}

3. REST API Usage

Access market data programmatically via WordPress REST API.

API Endpoints

EndpointMethodDescription
/wp-json/xbo/v1/tickerGETGet ticker data for symbols
/wp-json/xbo/v1/moversGETGet top gainers/losers
/wp-json/xbo/v1/orderbookGETGet order book depth
/wp-json/xbo/v1/tradesGETGet recent trades
/wp-json/xbo/v1/slippageGETCalculate slippage

JavaScript Example

// Fetch ticker data
fetch('/wp-json/xbo/v1/ticker?symbols=BTC/USDT,ETH/USDT')
    .then(response => response.json())
    .then(data => {
        console.log(data);
        // Process ticker data
    })
    .catch(error => console.error('Error:', error));

// Fetch top movers
fetch('/wp-json/xbo/v1/movers?count=10')
    .then(response => response.json())
    .then(data => {
        // Display movers data
    });

PHP Example

<?php
// Get ticker data programmatically
$response = wp_remote_get(
    home_url('/wp-json/xbo/v1/ticker?symbols=BTC/USDT,ETH/USDT')
);

if ( ! is_wp_error( $response ) ) {
    $data = json_decode( wp_remote_retrieve_body( $response ), true );

    foreach ( $data as $ticker ) {
        echo '<div>';
        echo '<strong>' . esc_html( $ticker['symbol'] ) . '</strong>: ';
        echo esc_html( $ticker['price'] );
        echo '</div>';
    }
}
?>

4. Shortcode Reference

Complete shortcode documentation with all available attributes.

Ticker Shortcode

BTC
BTC
BTC/USDT
--
0.00%
ETH
ETH
ETH/USDT
--
0.00%
SOL
SOL
SOL/USDT
--
0.00%

Attributes:

  • symbols – Trading pairs (comma-separated)
  • columns – Grid columns (1-6, default: 4)
  • refresh – Auto-refresh seconds (15, 30, 60)
  • showSparkline – Show trend chart (true/false)

Top Movers Shortcode

PairPrice24h Change
IMU/USDT		$0.002143+20.66%
EUL/USDT		$1.34+11.12%
ICP/USDT		$2.95+9.41%
ZAMA/USDT		$0.03572+6.88%
XLM/USDT		$0.15958+6.81%
XLM/USDC		$0.15962+6.62%
XLM/USD		$0.15882+6.26%
XLM/EUR		$0.13651+6.24%
AR/USDT		$2.28+6.20%
SEI/USDT		$0.0693+5.80%

Order Book Shortcode

Order Book — BTC/USDT
PriceAmount
PriceAmount
Spread: --

Recent Trades Shortcode

Recent Trades — BTC/USDT
TimeSidePriceAmount

Slippage Calculator Shortcode

Slippage Calculator
  • 1INCH
  • 2Z
  • A
  • AAPLX
  • AAVE
  • ACH
  • ADA
  • AERO
  • AKT
  • ALGO
  • AMZNON
  • APE
  • APT
  • AR
  • ARB
  • ASTER
  • ATH
  • ATOM
  • AUDIO
  • AVA
  • AVAX
  • AVGOX
  • AVNT
  • AXL
  • AXS
  • AZTEC
  • BASED
  • BAT
  • BCH
  • BERA
  • BLUR
  • BNB
  • BONK
  • BREV
  • BROCCOLI
  • BTC
  • CAKE
  • CC
  • CELO
  • CFG
  • CHIP
  • CHZ
  • COMP
  • CRV
  • DOGE
  • DOT
  • DRIFT
  • DYDX
  • EGLD
  • EIGEN
  • ENA
  • ENJ
  • ENS
  • ESP
  • ETC
  • ETH
  • ETHFI
  • ETHW
  • EUL
  • EURC
  • FARTCOIN
  • FET
  • FF
  • FIL
  • FLOKI
  • FLOW
  • FLR
  • FLUID
  • GALA
  • GAS
  • GEOD
  • GOOGLX
  • GRASS
  • GRT
  • HBAR
  • HNT
  • HONEY
  • HYPE
  • ICP
  • IMU
  • IMX
  • INJ
  • IO
  • IOTA
  • IOTX
  • IP
  • JELLYJELLY
  • JTO
  • JUP
  • KAITO
  • KAT
  • KITE
  • KMNO
  • LAYER
  • LDO
  • LINEA
  • LINK
  • LIT
  • LLYX
  • LPT
  • LTC
  • MANA
  • MASK
  • ME
  • MEGA
  • MET
  • METAX
  • MMT
  • MNT
  • MON
  • MORPHO
  • MOVE
  • MSFTON
  • MUBARAK
  • NEAR
  • NEIRO
  • NEO
  • NIGHT
  • NOT
  • NVDAX
  • ONDO
  • OP
  • OPG
  • OPN
  • PAXG
  • PENDLE
  • PENGU
  • PEPE
  • PGX
  • PI
  • PNUT
  • POL
  • PUMP
  • PYTH
  • PYUSD
  • QNT
  • QQQX
  • QTUM
  • RAY
  • RENDER
  • ROBO
  • RON
  • RSR
  • S
  • SAFE
  • SAND
  • SEI
  • SHIB
  • SKR
  • SKY
  • SNX
  • SOL
  • SPK
  • SPX
  • SPYX
  • STABLE
  • STRK
  • STX
  • SUI
  • SUSHI
  • SYRUP
  • TAO
  • THETA
  • TIA
  • TNSR
  • TON
  • TRUMP
  • TRX
  • TSLAX
  • TWT
  • UMA
  • UNI
  • USD1
  • USDC
  • USDE
  • USDG
  • USDS
  • USDT
  • VET
  • VINE
  • VIRTUAL
  • VVV
  • W
  • WBTC
  • WET
  • WIF
  • WLD
  • WLFI
  • XAUT
  • XBO
  • XEC
  • XLM
  • XPL
  • XRP
  • XTZ
  • YB
  • YFI
  • ZAMA
  • ZEC
  • ZIL
  • ZORA
  • ZRO
  • ZRX
  • No results
/
  • AUD
  • CHF
  • EUR
  • GBP
  • USD
  • USDC
  • USDT
  • No results
Avg Price
—
Slippage
—
Spread
—
Spread %
—
Depth Used
—
Total Cost
—
Calculating...

Need More Help?

Check out the API Documentation for detailed endpoint specifications

View API Docs