API

Public API for accessing Orchid protocol data including markets, rates, user positions, and transactions. our API is not currently live until test-net launch.

Base URL

https://api.orchid.credit

Supported chains

• megaeth

Note Addresses must be checksummed. The API is case-sensitive.

---

Endpoints

Interest Rate History

Query supply and borrow rate history for an asset.

GET

/data/interestRateHistory

Params

• chain

• token contract address

Example

/data/interestRateHistory?chain=megaeth&token=0x...

Response

[
  {
    "timestamp": 1725501082135,
    "0x...": {
      "currentLiquidityRate": "7901245102880645706451431",
      "currentVariableBorrowRate": "29629649382709465022770918"
    }
  }
]

Rates are returned in high-precision fixed units.

---

User Value Change

Returns a user’s 24h balance change.

GET

/data/user/valueChange

Params

• chain

• address

Example

/data/user/valueChange?chain=megaeth&address=0x...

Response

{
  "totalBalanceChange": 0.59,
  "totalBalanceChangePercentage": 1.06
}

Includes token-level and USD-level breakdowns.

---

User Net Worth History

Query hourly historical net worth.

GET

/data/user/historicalNetWorth

Params

• chain

• address

Example

/data/user/historicalNetWorth?chain=megaeth&address=0x...

Response

[
  { "timestamp": 1725886951424, "usdValue": 605.93 }
]

---

Markets

Returns the current state of all lending markets.

GET

/data/markets

Params

• chain

Example

/data/markets?chain=megaeth

Includes collateral parameters, liquidity, caps, and rate configuration.

---

Market Rates

Returns current supply and borrow APR / APY for all markets.

GET

/data/markets/rates

Params

• chain

Example

/data/markets/rates?chain=megaeth

Response

{
  "0xMarketAddress": {
    "supplyAPR": 0.46,
    "supplyAPY": 0.47,
    "borrowAPR": 2.27,
    "borrowAPY": 2.30
  }
}

Isolated markets include underlying and collateral asset addresses.

---

User Transaction History

Returns protocol events involving a specific user.

GET

/data/user/transactionHistory

Params

• chain

• address

Optional

• limit

• skip

Example

/data/user/transactionHistory?chain=megaeth&address=0x...

---

Protocol Transactions

Query indexed protocol events.

GET

/data/transactions

Optional params

• chain

• event

• txHash

• blockNumber

• contractId

Example

/data/transactions?chain=megaeth&event=Borrow

---

Indexed Events

Core events indexed by the API include:

• Supply

• Withdraw

• Borrow

• Repay

• Liquidation

• FlashLoan

• Rate updates

• Collateral configuration changes

Each event returns full on-chain parameters.