Onggi Open app

Onggi docs

Pools, vaults and lending on GIWA in one account, an agent that prepares actions for your signature, and an MCP gateway for AI clients.

Preview. The app runs on a demo account funded with sample USDC and sample prices. Contracts are tested and not yet deployed. Nothing in the demo moves real funds or asks your wallet to sign.

Your account

Everything runs from one account. Cash is USDC. Liquidity positions, vault deposits and supplied capital count as positions. Borrowed USDC counts as debt. Your net value is cash plus positions and supplied capital, less debt.

StartUSDC cashDemo balance, up to $10,000 per action.
→
Put it to workPools and vaultsEarn trading fees or strategy yield.
→
Or borrowLendingBorrow USDC against what you hold.
→
See it allPortfolioValue, health and activity in one place.

Demo and onchain are separate. The Onchain page uses your real wallet and real transactions. It never mixes with the demo balance, and it only accepts deposits into vaults whose chain, token and deployed bytecode are verified in the registry.

Liquidity pools

A position holds two tokens inside a price range you choose. While the price is inside the range, your liquidity is used for trades and earns that share of the pool fee.

Lower priceYour range: earns feesHigher price
Liquidity across prices for SOL / USDC. Blue bars are the range of one position.
  • Both tokens are needed for a range that contains the current price. Onggi does not swap for you to balance them.
  • Out of range the deposit is single sided and earns nothing until the price comes back inside.
  • A range is fixed. To move it, remove the liquidity and open a new position.
  • Returns come from trading fees and depend on price movement and impermanent loss.

How new pools are listed

Pools are read from the creation events of the supported DEX factories, not from token lists. A pool appears once the block that created it is final and both tokens have contract code and metadata. Pools from unknown factories never appear.

Vaults

A vault runs a strategy for you: a managed liquidity range or a lending reserve. Each vault page shows where the yield comes from and the withdrawal terms before you deposit.

1Deposit USDCUp to the vault's deposit cap.
→
2Strategy worksFees or borrower interest accrue to the vault.
→
3Withdraw any timeDeposits can be capped. Exits are never paused.

The custody vault is the exception: it runs no strategy and promises no yield. Tokens stay in the contract until you withdraw them.

Lending

Onggi runs its own credit module. Suppliers earn the interest borrowers pay. Borrowers take USDC against what the account already holds, without selling it. Rates move with demand and available liquidity.

Collateral weights

Not every asset counts in full. The weight is the share of its value that can back a loan.

Supplied USDC90%
Cash85%
Spot tokens70%
Managed LP shares65%
Direct range positions are not accepted as collateral.

Health

Health is weighted collateral divided by debt. Above 1.50 is comfortable. At 1.10 the position can be liquidated.

1.10 liquidation 1.50 target
1.002.00+
4.20 ETH × $3,780× 70% weight= $11,113÷ $6,100 debt= 1.82

To raise health, repay USDC or add collateral. The position agent can prepare a repayment when health drops below a level you set.

Position agent

You write a scenario before the market moves: what to watch, when it counts as triggered, and the largest action allowed. The agent watches health, ranges, liquidity and rates, and prepares that action when the scenario is confirmed.

WatchYour conditionsHealth below 1.50, price out of range, rate change.
→
ConfirmComplete data onlyMissing or stale data blocks the action.
→
PrepareBounded actionWithin the maximum per action you set.
→
YouSign or skipThe agent never signs.
  • One signal per episode. A trigger fires once and waits until the condition recovers.
  • Cooldown. A repeating rule runs again only after its cooldown and a confirmed result.
  • Partial actions are labelled. If your limits allow only part of the target, you see that before signing.
  • Imported rules start paused. Scenarios loaded from JSON do nothing until you review and enable them.

Rewards and Season 0

Rewards are paid from ONGGI creator fees, so the budget comes from fees the token actually earned rather than new emissions.

FeesSource of the rewards budget
VolumePoints for real trading volume, with a bonus for using more than one market
0Points for self-dealing, circular volume or clustered accounts
Not final. Allocation, eligibility, the reward pool, anti-sybil rules and dates will be published before Season 0 starts. Until then the Rewards page only shows the structure.

Signing and checks

Onggi never holds a key. Anything that changes the chain ends in your wallet. The signing page simulates every step again, explains it in plain words and refuses to continue if a step would fail or grants an unlimited approval. The transaction travels in the link fragment, so it never reaches a server.

The full list of checks is on What gets checked.

Risks

Impermanent lossWhen prices move, a range position can be worth less than holding the two tokens.
LiquidationAt health 1.10 part of the collateral can be sold to repay debt.
Variable ratesSupply and borrow rates change with demand. Displayed rates are not promises.
Contract riskTested contracts can still have bugs. Deposit only what you can afford to lose.

MCP gateway

Onggi is also a remote MCP server. An AI client connects to one endpoint and gets tools to read the chain, check transactions before they are signed and prepare transactions for your wallet.

Endpointhttps://mcp.onggi.xyz/giwa
Network nowGIWA Sepolia (chain 91342). On the day GIWA mainnet opens, the same endpoint switches network.
TransportMCP over streamable HTTP, JSON responses

Connect a client

claude mcp add --transport http onggi https://mcp.onggi.xyz/giwa

Then check it with claude mcp list.

First requests to try

  • “Give me a portfolio report for 0x…, including WETH and its allowance for this spender.”
  • “Simulate these three transactions and stop if any would revert.”
  • “Prepare a transfer of 0.001 WETH to 0x… for my signature.”

More in the prompt library.

Keys and limits

60calls a minute per address, no key needed
1,000calls a minute with an access key
5active keys per wallet

Make keys on the keys page by signing a message, and send one as Authorization: Bearer onggi_…. Revoked keys stop working at once.

Agent guardrails

An access key can carry a transaction policy. Every prepare tool checks it again before returning a signing link.

FieldEffect
transactions_enabledFalse turns preparation off for this key.
max_value_weiLargest native value a prepared transaction may send.
allowed_contractsOnly these contracts. An empty list allows any contract.
allow_deployWhether prepare_deploy may be used.

Set it with set_agent_policy, read it with get_agent_policy, remove it with delete_agent_policy. get_agent_usage returns call counts by tool. Anyone holding the same key can change the policy, so your wallet stays the final check.

Tool reference

Every tool with its inputs. Open one to see the details, or download the whole list.

JSON

Loading tools…

Errors

Tool errors come back as a normal result with isError: true and a message the AI can pass on, such as “Rate limit reached” or “The simulation reverted, so nothing was prepared”.

CodeMeaning
-32601Unknown method
-32602Unknown tool or invalid arguments
-32700The request could not be read

Run your own

The gateway is a Cloudflare Worker in gateway/. Install and start it there, then point a client at http://localhost:8799/zero.

npm.cmd install npm.cmd run dev

The network is four settings in wrangler.toml: CHAIN_ID, CHAIN_NAME, RPC_URL and EXPLORER.

FAQ

Is Onggi live?

Not yet. The app is a preview with a demo account and sample prices. Contracts are tested and not deployed. The MCP gateway is live on Sepolia.

Does Onggi ever hold my keys?

No. Every transaction is signed in your own wallet, and the position agent only prepares actions.

Can I always leave a vault?

Yes. Deposits can be capped, withdrawals are never paused. Your share is limited only by what the strategy holds at that moment.

Why can't I deposit into an onchain vault?

Deposits open only after the chain, the vault, its token and the deployed bytecode are verified in the registry.

What happens at health 1.10?

The loan can be liquidated: part of the collateral is sold to repay debt. Repay or add collateral before that, or let the agent prepare a repayment at a level you choose.

Which network does Onggi use?

GIWA. Until GIWA mainnet opens, the gateway runs on GIWA Sepolia so every tool can be tried with test ETH.