Curate Opportunities

Curation is choosing which opportunities your users see. Turtle has a large catalog of vaults and campaigns across many chains, and most distributors do not want to show all of it. You pick a set that fits your audience, a few stablecoin vaults for a conservative newsletter, a single chain for a chain-native wallet, or whatever matches what your users want, and that set is what they deposit into. There are two ways to curate, matched to your integration path. The no-code path runs through the Client Portal and share links; the API path lets you fetch and serve your curated set programmatically. This page covers both at altitude and links DOWN to the API reference for the exact request and response. Before you start, make sure your organization is approved and you have a distributor ID. See Before you start.

​

Browse the catalog

Turtle’s opportunities are vaults and campaigns a user can deposit into. Each carries the data you curate against: the underlying asset, the chain, the protocol, current TVL, an estimated APR, the incentives attached, and whether it is a Turtle featured deal. The featured deals are listed at app.turtle.xyz/earn/opportunities, where you can see each deal’s asset, chain, and live numbers. For the full catalog and the exact fields you can filter and sort on, use the API. See Get opportunities for the catalog endpoint, its filters, and the full opportunity shape.

​

Curate for share links

If you use share links, the opportunities you can put in front of users are the Turtle featured deals. To curate for share links, pick the featured deals that fit your audience and build a link for each one. Each link is the deal’s page with your distributor ID attached. See Share links for the link format, examples, and how to verify a deposit was attributed to you.

​

Curate through the API

If you integrate through the Earn API, you curate by selecting which opportunities your product shows and serving them from the catalog endpoint. You can:

• Pull the full catalog and filter it to the chains, assets, or opportunity types your audience wants.
• Pull only your distributor’s curated set, so your product shows exactly the opportunities you have selected for your distributor ID.

Both come from the same opportunities endpoint, scoped differently. The distributor-scoped query returns the set tied to your distributor ID. See Get opportunities for the filters, the distributor-scoped variant, and the full response fields.

​

Keep your selections current

Opportunities change. TVL moves, an APR shifts, incentives start and end, and an opportunity can be paused or wound down. Review your curated set on a cadence that fits your audience so you are not pointing users at a deal that no longer earns what it used to or is no longer active. When you query opportunities, each one carries a status. Drop or replace anything that is no longer active before it reaches your users. The status field and the rest of the opportunity shape are documented on Get opportunities.

​

Next steps