Skip to main content

​
July 2026

Deposit and withdraw: on-chain balance preflight
  • Deposit and withdraw endpoints now read the user’s on-chain balance of tokenIn (or vault shares, for withdraw) before building the transactions.
  • Requests where the wallet holds less than amount are rejected up front with 400 INVALID_ARGUMENT and error insufficient token balance, instead of failing later on-chain.
  • Documented on the Deposit and Withdraw pages under Error Handling.
Streams: 1.5% creation fee, with Turtle Pro exempt
  • Token streams now include a 1.5% creation fee, charged in the reward token and pulled at stream creation on top of the net reward budget. Point streams remain free.
  • Turtle Pro organizations are exempt (0%).
  • The exact fee is surfaced as FeeAmount in the create-stream response and shown on the Client Portal review screen before you confirm.
  • See Streams: before you start for prerequisites and funding requirements.
Genesis Airdrop: in-app claiming
  • Eligible wallets can now check allocations and claim $TURTLE directly in the Turtle app under Your Earnings on the Liquidity Campaigns page.
  • Allocations are bound to the wallet used to contribute to the Turtle DAO — connecting a different wallet will show nothing to claim.
  • Claiming once forfeits any unvested portion. Review Vesting & Mechanics before you claim.
  • Full walkthrough: Genesis Airdrop.

​
April 2026

Documentation revamp
  • Added new pages: Authentication Overview, Opportunities Overview, Historical Data (stub), Earn API Overview, Swap Mode, Async Deposits, Portfolio Overview, Streams Overview, Distributor Model, Error Codes, OpenAPI Spec, and Changelog
  • Removed Route API page
  • Removed the POST /v1/actions/attribute endpoint; attribution is now fully automatic and documented in the Distributor Model concept
  • Retitled the distributor deposits page to “Distributor Activity” and grouped it with the wallet-scoped activity and positions endpoints under “Portfolio & Activity”
  • Added three previously undocumented response fields to Opportunities: minDepositAmountUsd, swapDirectEnabled, swapRouteEnabled
  • Added three previously undocumented query filters to Opportunities: chainIds, depositToken, tvlGreaterThan