For the complete documentation index, see llms.txt. This page is also available as Markdown.

RUJI Product Integration Guides

Technical documentation for integrating Rujira Network products into your application.

Available Guides

RUJI Trade and CCL

Integrate RUJI Trade orderbook DEX with native assets (BTC, ETH, SOL, XRP, DOGE, BCH, LTC and more) secured by THORChain - fully decentralized and permissionless.

Money Market

Integrate lending and borrowing functionality with native assets (BTC, ETH, SOL, XRP, DOGE, BCH, LTC and more) secured by THORChain.

  • Lending (Ghost Vault)

    • Deposit assets to earn yield

    • Receive transferable receipt tokens

    • Dynamic interest rates based on utilization

  • Borrowing (Ghost Credit)

    • Create isolated Credit Accounts

    • Deposit multi-asset collateral

    • Borrow against collateral with overcollateralized loans

Liquidations

Staking

Integrate staking markets powered by the Rujira staking contract, including RUJI, bRUNE and TCY. Allow users to stake and earn rewards from real economic activity. The staking contract supports both Account staking (claimable yield) and Liquid staking (auto-compounding).

Liquidy Swap API

Liquidy provide an easy way to integrate any SecuredAsset-to-SecuredAsset swap on Rujira, finding the best route between any two tokens through any of the RUJI Trade orderbooks. Liquidy API can also be used to find arbitrage opportunities across the orderbooks.

Liquidy charges 0.10% fee per swap and the optimize routing still often result for a net positive outcome for end users. Liquidy router support both a referral fee model (typically 10% of the 0.10% protocol fee shared with the integrating partner) and an affiliate fee model (additional fee the partner can add on top of the protocol fee - 100% retained by the partner).


Quick Reference

Main Supported Assets

Asset
Denom
Decimals

BTC

btc-btc

8

ETH

eth-eth

8

USDC

eth-usdc-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

8

USDT

eth-usdt-0xdac17f958d2ee523a2206206994597c13d831ec7

8

BCH

bch-bch

8

DOGE

doge-doge

8

LTC

ltc-ltc

8

XRP

xrp-xrp

8

BNB

bsc-bnb

8

AVAX

avax-avax

8

TRX

tron-trx

8

ATOM

gaia-atom

8

Note: For the full list of supported assets and chains, check THORChain active pools on https://thorchain.net/pools/main.

Network Endpoints

THORChain Mainnet

Type
URL

RPC

https://gateway.liquify.com/chain/thorchain_rpc

gRPC

https://grpc-thorchain.rorcual.xyz

REST

https://gateway.liquify.com/chain/thorchain_api

Rujira APIs

Environment
URL

Mainnet GraphQL

https://api.rujira.network/api/graphiql


Development Tools

Libraries

RUJI contracts are standard CosmWasm. Use any Cosmos SDK compatible library:

Language
Library

TypeScript/JavaScript

Python

Contract Schemas

JSON schemas for all message types are available in each contract's /schema directory:


Common Patterns

Querying Contract State

Executing Transactions

Handling Decimals

All amounts use 8 decimal places:


Support

Last updated