// enterprise api

Yield data for your dApp, from one GET request.

Yecho reads the chains, computes each user's daily income and borrow cost, and stores the history. You call one endpoint per address and render the number.

# a user's full income history, filtered however you like
ADDRESS=0x9a3f7c2b5e8d1f4a6b0c3d7e2f5a8b1c4d6e9f02

curl -G "https://api-XXX.yecho.app/api/users/$ADDRESS/income" \
  -d chain=ethereum \
  -d token=USDC \
  -d start_date=2025-01-01 \
  -d end_date=2025-12-31

Two endpoints. That's the whole integration.

Both take a user address and return JSON. Filter by chain, token or date range.

GET/api/users/{USER_ADDRESS}/income

The user's full income history. Borrow costs come back as negative amounts, so a single sum gives net earnings.

chaintokenstart_dateend_date
GET/api/users/{USER_ADDRESS}/deposits

Every position Yecho currently tracks for that address, with the balance and when it was last updated.

chaintoken
[
  {
    "daily_income": 0.04185007,
    "snapshot_date": "2025-12-28",
    "contract_id": 5,
    "blockchain": "Base",
    "asset": "GHO",
    "contract_type": "Lending"
  },
  {
    "daily_income": 0.324324,
    "snapshot_date": "2025-12-28",
    "contract_id": 618,
    "blockchain": "Base",
    "asset": "USDC",
    "contract_type": "Yield Aggregator"
  },
  {
    "daily_income": -0.124458,
    "snapshot_date": "2025-12-28",
    "contract_id": 915,
    "blockchain": "Base",
    "asset": "GHO",
    "contract_type": "Borrowing"
  }
]

Your dedicated host : api-XXX.yecho.app and your API key are issued during onboarding.

From your users to your interface.

Three stages, all of them on our side until the last one.

01

Address discovery

Push your users through a secure write endpoint or a CSV of holders, best for privacy, consent and RPC cost. If your contracts are fully public, we can scan them periodically instead, which suits smaller or static user bases.

02

Reading & calculation

We query your contracts on chain for user balances. With no prior balance we record the initial snapshot; with one, we compute the gain on the position or the cost of the borrow since the last snapshot. Stored encrypted, once a day by default, at the UTC hour you choose.

03

Retrieval

Call one endpoint with a user address and render the result. No indexing, no database, no extra logic on your side.

Everything you stop maintaining.

Built for lending protocols, yield aggregators, and any dApp whose users want to see what they actually earn.

01

Complete delegation

On-chain reads, daily income and borrow calculations, and secure storage. No RPC calls, indexing or databases to run.

02

Seamless integration

One endpoint, one address, the full history back enough to show “you earned $X today from your Aave position”.

03

Scalability & reliability

High user and contract volumes without performance drops, on battle-tested RPC providers, at the refresh rate you pick.

04

Cost efficiency

Pay for what you use instead of building your own yield tracker. Privacy-compliant by design, with no unnecessary data exposure.

05

Actionable insights

Granular per-position data for your users, and optional aggregated stats, total yield generated across your whole user base for you.

Scoped to your dApp, quoted per integration.

There is no public price list. We scope the integration with you on a call and come back with a fixed monthly figure, so you pay for the volume and refresh rate you actually need.

every integration
  • Setup and basic support
  • Both core endpoints, income & deposits
  • The refresh rate and snapshot hour you choose
  • User and smart-contract volume agreed up front
  • Sandbox access before you go live
admin dashboard · optional
  • Timer to the next snapshot
  • Active users tracked
  • Aggregated, anonymised yields generated by your users
  • Usage stats (RPC calls and more)
What shapes the quote
  • How many users you track
  • How many smart contracts, and on which chains
  • Refresh rate, once a day, twice, every 6 hours or hourly
  • Whether you add the admin dashboard
  • A “Powered by Yecho” badge in your app, which earns a discount
  • Annual prepay, which earns a further discount

Tell us your numbers

Your dApp name, your estimated users and contracts, your chains and the refresh rate you want. We come back with a figure and an endpoint.

Get a quote->

How to get started.

Tell us your dApp name, your estimated users and contracts, your blockchains, and the refresh rate and snapshot hour you want.

01

Request access

Through the contact page or hello@yecho.app, with the details above.

02

Onboarding call

We agree how addresses reach us, set up your API key and price the quote.

03

Integration

You get your endpoint and docs, and test against the sandbox.

04

Go live

Ship it, and monitor from the optional admin dashboard.

Tell us what you're building.

We'll scope the integration, issue your endpoint and API key, and come back with a quote.