Rujira Product Integration Guides
Technical documentation for integrating Rujira Network products into your application.
Available Guides
Rujira Trade and CCL
Integrate Rujira Trade orderbook DEX with native assets (BTC, ETH, SOL, XRP, DOGE, BCH, LTC and more) secured by THORChain - fully decentralized and permissionless.
Funding Requirement: Secured Assets
Deposit native assets into THORChain to get Secured Assets
Withdraw Secured Asset back to the source L1
Market orders (swap)
Limit orders
Tracking orders
Custom Concentrated Liquidity (CCL) Positions
Create and manage ranges (fixed-range AMM strategies built directly into FIN)
Money Market
Integrate lending and borrowing functionality with native assets (BTC, ETH, SOL, XRP, DOGE, BCH, LTC and more) secured by THORChain.
Deposit assets to earn yield
Receive transferable receipt tokens
Dynamic interest rates based on utilization
Create isolated Credit Accounts
Deposit multi-asset collateral
Borrow against collateral with overcollateralized loans
Liquidations
Bidding on Liquidations (for end users)
Integrate liquidation bidding into your application, allowing users to acquire collateral at discounted prices when CDP positions are liquidated.
Build a Liquidation Solver (for developers)
Build liquidation bots that monitor at-risk positions, calculates optimal liquidation routes, and executes liquidations to earn the 0.5% executor fee.
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 Rujira 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
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
RPC
https://gateway.liquify.com/chain/thorchain_rpc
gRPC
https://grpc-thorchain.rorcual.xyz
REST
https://gateway.liquify.com/chain/thorchain_api
Rujira APIs
Mainnet GraphQL
https://api.rujira.network/api/graphiql
Development Tools
Libraries
Rujira contracts are standard CosmWasm. Use any Cosmos SDK compatible library:
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
Documentation: docs.rujira.network
Telegram: @Rujira_Community
E-Mail: [email protected]
Discord: Join
Last updated
