Plinth
Devnet

How Plinth works

Understand borrowing, deposits, and the rules behind the pool. Jump to what you need.

01 / How it works

One pool, two sides

Lenders put USDC into a single shared pool. Borrowers lock a listed stock token and take USDC out of that pool. To unlock the stock, a borrower pays back the USDC plus a fixed fee, and most of that fee goes to the lenders.

  1. 01Fund

    A lender deposits USDC and gets a position in the pool.

  2. 02Borrow

    A borrower locks listed stock tokens and receives USDC for a fixed term.

  3. 03Settle

    Repaying returns the stock and pays out the fee. If the loan becomes eligible for liquidation, the stock is taken instead.

If you borrow

You can use the USDC for the length of the loan. Your stock token stays locked until you repay, and it can be liquidated if the loan becomes unsafe or stays unpaid past its grace period.

Go to Loans

If you deposit

Your USDC joins the pool and can be lent out. You hold shares whose value goes up as borrower fees come in, and can go down if a loss is bigger than the safety fund.

Go to Deposit
02 / Borrowing

From stock token to USDC

You need a listed stock token in your wallet to use as collateral. The Borrow page shows every term before you connect a wallet or sign anything.

  1. 01

    Choose a stock token

    Each listed token has its own price, loan limit, and liquidation threshold. It must be open for new loans and have a valid price.

  2. 02

    Set the collateral and the amount

    Your stock must be worth more than the USDC you take. Depending on the stock, a new loan can be 10–50% of its value. The pool also checks free USDC, a cap per stock, a minimum loan, and a limit of 20% of pool funds per address. The program starts with a 3 USDC minimum; the form shows the current value.

  3. 03

    Pick 1, 3, 7, 14, or 30 days

    The fee depends on the term and is fixed when the loan opens. The form shows the total to repay and an estimated liquidation price before you confirm.

  4. 04

    Repay to unlock your stock

    Repay the full amount and the fee by the due date. Repaying early is allowed; the fee stays the same. You can add collateral while the loan is open.

Reading the limit

With a 50% limit, stock worth 100 USDC supports at most 50 USDC of new borrowing. That example only explains the rule; your amount depends on the stock you pick, its current price, and how much the pool has free.

When the borrowing ladder is switched on, a new address starts with a small limit. Loans held for at least seven protocol days and repaid in full raise it; a liquidation sends it back to the start. The Borrow page shows the limit that applies to your wallet now.

03 / Keeping a loan healthy

What leads to liquidation

Your collateral is worth whatever the stock is worth. Each stock has a liquidation threshold: if the collateral gets too close to what you owe, the loan can be liquidated. The threshold in force when you open the loan stays with that loan.

Price

A falling stock can put a loan at risk long before it is due. The Borrow page shows loan health and lets you add collateral, but a sudden price gap can leave no time to react.

Time

After the due date there is a one-day grace period. A loan still open after that can be liquidated even if the stock has not moved.

Reading the threshold

With a 130% threshold, 100 USDC owed needs collateral worth at least 130 USDC. Below that, the loan can be liquidated. That example only explains the rule; your loan uses the threshold shown when you borrow.

1The stock is sold

The liquidator pays the oracle price minus a small discount (2% at launch) and receives the locked stock token.

2The loan is settled

That payment covers lender principal and fees first, then the protocol's share where there is enough.

3Nothing comes back

All of the collateral is taken. Anything above what lenders and the safety fund are owed goes to the treasury; the borrower receives no remainder.

A liquidated borrower does not get the stock token back. If the sale brings in less than lenders are owed, the safety fund covers the gap first. Whatever it cannot cover is a lender loss.

04 / Funding

Deposit, earn, and withdraw

On the Fund page, choose an amount and a lock of 1 week, 1 month, 3 months, 6 months, or 1 year. Each deposit becomes its own position with its own unlock date.

How you earn

Lenders get 80% of borrower fees, split by pool share. Each fee raises the value of every share when it is paid, so there is nothing to claim. A longer lock does not earn a bigger share.

How you withdraw

Before or after the unlock date, you can withdraw as long as the pool has enough idle USDC. Before the unlock date it costs 3% of the amount: 1% stays in the pool for the lenders who remain and 2% goes to the treasury. After it, withdrawing is free.

Unlocked is not the same as available.

USDC that is out on loan must be repaid before it can pay a withdrawal. Check idle USDC on the Pool page before you count on a date.

05 / Money flows

Fees, the safety fund, and losses

The loan fee is 1% for 30 days and scales with the term you choose. It is set when the loan opens and paid in full at repayment, early or not.

80%of each loan fee goes to lenders
15%of each loan fee builds the safety fund
5%of each loan fee goes to the treasury

When a loan is repaid its fee is split: 80% to lenders, 15% to the safety fund, 5% to the treasury. The safety fund has no cap and cannot be withdrawn; it is only used to cover liquidation shortfalls. The treasury also receives the 2% share of early exits and anything a liquidation brings in above what lenders and the safety fund are owed.

The safety fund softens liquidation shortfalls. It can reduce lender losses but cannot promise to cover them all. The Pool page shows its balance and any lender loss so far.

06 / Tokenomics

$CREDIT Tokenomics

$CREDIT is the participation and risk-sharing token of Plinth. The lending pool operates in USDC, while eligible Stock Tokens secure every loan.

Protocol revenue and buyback

Plinth allocates 85% of protocol revenue to buy back and permanently burn $CREDIT. The remaining 15% funds project development, including security, infrastructure, integrations, and ongoing operations.

Protocol revenue means funds actually received by the protocol, such as its share of repaid loan fees and applicable early-exit charges. Borrower principal, lender deposits, collateral, and the safety fund that covers losses are excluded. Buybacks occur only after revenue has been collected; their timing and transaction history will be publicly verifiable.

A buyback reduces circulating token supply. It does not guarantee a token price, a return, or a distribution to holders.

Agent Credit Bonds

$CREDIT holders can commit tokens to a specific agent through an Agent Credit Bond. The agent's owner must approve the bond. Once active, it places the holder's tokens at risk alongside the agent's borrowing activity.

The bond holder may earn a specified portion of fees from loans the agent repays. If the agent defaults or a liquidation leaves a shortfall, part of the bonded $CREDIT may be burned according to the terms shown when the bond is created. Tokens committed to an open loan remain locked until that obligation is settled.

Agent Credit Bonds add a layer of accountability to Plinth's stock-backed lending model. They do not remove the stock collateral requirement or eliminate lender risk. Plinth will publish bond requirements, fee allocation, loss rules, and agent eligibility before this feature goes live.

$CREDIT has not launched yet

Its mint address will be published on this site once it exists. Until then there is nothing to buy back, and any token presented as $CREDIT is not confirmed by this site.

What this page does not say.

Token supply, allocation, and vesting are not published here. $CREDIT gives no on-chain claim on lender deposits, borrower collateral, the safety fund, or the treasury, and the pool program does not run buybacks itself; the 85% and 15% split is a commitment by the project. Borrowing and deposits do not require $CREDIT.

07 / When actions are available

Prices can pause

Stock-token prices come from Chainlink's xStocks feeds as published on chain by Kamino Scope (market-hours prices only, checked against the listed Chainlink feed), or from Pyth price feeds (fully verified, narrow confidence); either way never older than a price already used. A price stays usable for up to 26 hours; the week's last price stays usable until Tuesday 06:00 UTC. New loans also wait after a sharp price move, or while a corporate action changes a token's share multiplier. Repaying and adding collateral never wait for a price.

The pool can also be paused. While it is paused, deposits and new loans stop; repaying, adding collateral, liquidating, and withdrawing continue under their usual rules.

Check the status first

The Borrow and Pool pages show whether a stock can back a new loan and when its price last updated. A price on screen can still expire before your transaction lands.

08 / Reading the site

Numbers in the Pool, stories in the City

The Pool page shows the pool's funds, USDC on loan, idle USDC, and utilization. In its stock table, Borrowed / limit means the amount of active loan principal backed by that stock compared with the maximum allowed for that stock. These are USDC amounts, not counts of stock tokens.

The City turns recorded activity into a visual map. The full City is based on actual pool and loan data; the growing building on the home page is labeled as an illustration.

City Hall and land

City Hall grows with protocol income; the land grows with the funds deposited.

Districts

Stocks used as collateral. Their towers grow with USDC borrowed against them. Less-used stocks may be grouped together.

Buildings

Borrower addresses. Repaid loans add floors; a charred building marks a past liquidation.

Roof lights

Amber marks an open loan; red signals a loan at risk.

Sea wall

The safety fund measured against 5% of pool funds (a reference level).

Roads, trees, cars, lit windows, and the harbour buildings along the waterfront are scenery. They do not represent a wallet balance or loan outcome. The 3D buildings are made from the City Kit models by Kenney (CC0).

09 / For agents

Plinth for agents

Plinth lets autonomous agents borrow USDC against eligible Stock Tokens, manage open loans, and build a verifiable repayment history. Agents follow the same collateral and liquidation rules as other borrowers.

Borrowing workflow

  1. 01

    Check the market

    Read the stock's oracle price, borrowing limit, liquidation threshold, available pool liquidity, and the agent wallet's current limit.

  2. 02

    Open a loan

    Lock eligible Stock Tokens, choose a term of 1, 3, 7, 14, or 30 days, and receive USDC. The fee and repayment amount are fixed when the loan opens.

  3. 03

    Monitor the position

    Track collateral value and the due date. The agent can add collateral if its loan approaches liquidation.

  4. 04

    Repay and recover collateral

    Pay the full principal and fee to unlock the Stock Tokens. Each completed repayment adds to the wallet's public record.

When the repayment ladder is enabled, qualifying loans held for at least seven protocol days and repaid in full can increase the wallet's borrowing limit. A liquidation resets that progress. Credit history never removes the collateral requirement.

x402 access for agents

Plinth offers agent-readable data through x402 pay-per-request endpoints. An agent can request loan terms, collateral status, pool conditions, or a wallet's repayment record; the server answers with a payment request in USDC that the agent settles before receiving the response.

GET /api/x402/pool

0.01 USDC. Pool conditions: funds, idle USDC, utilization, safety fund, limits, and every listed stock with its price and loan limits.

GET /api/x402/quote

0.01 USDC. Loan quote: fee, total to repay, liquidation price, and the largest loan allowed for a stock, collateral, amount, and term.

GET /api/x402/borrower/{address}

0.03 USDC. Borrower report: repayment record, debt now, open loans with health, and full loan history.

GET /api/x402/risk

0.05 USDC. Open loans near or past their liquidation threshold or due date, with health and collateral.

x402 pays for access to data or services. It does not open a loan, approve a transaction, repay debt, or give Plinth control of the agent's wallet. Borrowing and repayment remain separate on-chain actions that the agent's wallet must authorize; the Plinth payer borrows to cover a payment only when the agent allows it and signs that loan itself.

The free catalog at /api/x402 lists every endpoint, its price, the network, the USDC mint, and the fee payer. Agents should verify the returned data and simulate transactions before signing. Setup for agents and merchants is on the x402 hub; code examples are on the Developers page.

Risk controls

An agent operator should set limits on loan size, eligible collateral, and minimum collateral buffer, and keep enough USDC available for repayment. If prices or pool data cannot be verified, the agent should pause new borrowing and request operator review. A loan can be liquidated after a price decline or after its due date and one-day grace period; liquidation transfers the entire pledged collateral to the liquidator, who pays its oracle value minus a small discount, and nothing is returned to the borrower.

10 / Read before using

Know the limits

Program risk

The Solana program has not been audited. Unexpected behavior could lose funds, so only use an amount you can afford to lose.

Price oracle

Loans and liquidations need a fresh, verified price. When the stock market is closed or the feed is not updated, new loans and liquidations wait; repaying always works. Stock prices are read from Kamino's Scope oracle, which publishes Chainlink's xStocks prices: the pool depends on Kamino keeping those entries updated, and on Kamino's control of its Scope program.

Issuer controls

Stock tokens are Token-2022 mints. Their issuer may keep controls such as freezing accounts or a permanent delegate; the pool lists a stock with such controls only deliberately and shows it on the stock's listing.

Fast price moves

A stock can reopen far from where it closed. The safety fund may be small or empty, so a shortfall can land directly on lenders.

Losing all the collateral

A liquidation takes all of the collateral, even when it is worth much more than the debt. Nothing is returned to the borrower.

Liquidations rely on others

Anyone may liquidate an eligible loan, but nothing guarantees someone does so quickly. A late liquidation can make a shortfall bigger, especially after a price jump.

Waiting to withdraw

Even after a lock ends, a lender may need to wait for lent USDC to be repaid.

No deposit cap

The pool currently accepts deposits of any size. A larger pool does not make any single loan safer: check the safety fund and idle USDC on the Pool page before you deposit.

Limits are per address

The 20% borrower limit applies to each wallet address, not to a person using several wallets.

Who can hold Stock Tokens

Stock Tokens are not offered to U.S. persons and may be restricted elsewhere. The pool does not check your eligibility.

Owner controls

The pool has an authority (today a single wallet, not a multisig). Within limits written into the program, it can pause deposits and new loans, list or disable stock tokens, change risk settings, the liquidation discount (up to 5%), the deposit cap, and the treasury account. The program has no instruction that lets it take lenders' deposits or borrowers' collateral. The program itself can still be upgraded by its upgrade authority; whether that authority is removed or moved to a multisig before mainnet is still open.

This site reads balances and prices from the network and builds history from recorded events. If that data cannot be read, it says so instead of showing stand-in numbers.

11 / Terms in plain English

A short glossary

Collateral

The stock token locked while a loan is open. Repaying returns it; a liquidation hands it to the liquidator.

Loan limit

The most new USDC you can borrow against the value of the stock you picked, before the pool's other limits apply.

Liquidation threshold

How much collateral value, relative to what you owe, a loan needs to stay safe from liquidation.

Idle USDC

USDC in the pool that is not lent out. Withdrawals are paid from it.

Funding share

Your part of the pool. Its value moves as fees come in or losses happen.

Utilization

The part of the pool's funds that is out on loan right now.

Safety fund

A cushion that covers lender shortfalls after a liquidation, up to what it holds.

Treasury

The protocol's own income: 5% of each loan fee, 2% of early exits, and liquidation proceeds above what lenders and the safety fund are owed. It is not paid to lenders.

12 / Quick answers

Common questions

Can I repay early?

Yes. The fee fixed when the loan opened still applies in full.

Can I repay part of a loan?

No. A repayment covers the whole principal and fee. You can add collateral while the loan is open.

Can I leave before my lock ends?

Yes, if there is enough idle USDC. Before the unlock date it costs 3%: 1% stays with the remaining lenders and 2% goes to the treasury.

Does a longer lock earn more?

No. Every lock term earns the same share of borrower fees.

What happens in a liquidation?

The stock token goes to the liquidator. All of the collateral is taken: after lenders and the safety fund are paid, the rest goes to the treasury and the borrower gets nothing back.

Can a bot or AI agent borrow?

Yes. Loans belong to wallet addresses, whether a person or software controls them, and the same rules apply. See For agents.

Check the live terms, then sign.

Open the form for your side of the pool. You can read every figure without connecting a wallet.