Changelog

API updates, new features, and breaking changes

All notable changes to the Hypermid API are documented here. Follow this page to stay updated on new features, improvements, and deprecations.

---

April 2026

2026-04-17 — Direct USDCh → USDC outbound bridge (0% fee)

When the outbound source is USDCh and the destination is canonical USDC, /v1/quote now returns a fee-free direct Warp Route bridge instead of routing through the Hypermid OutboundSender + Piteas. The user signs a single transferRemote() call directly on the USDCh Warp Route and receives USDC 1:1 on the destination chain.

• Hypermid fee: 0 (no contract in the path)
• DEX slippage: none (1:1 bridge)
• Only cost: Hyperlane gas, paid in PLS from the user’s native balance

Quote response shape is unchanged — check feeBreakdown.totalFeeBps === 0 and estimatedOutput === fromAmount to confirm this path was used. See the SuperSwap guide for the full flow.

2026-04-16 — SDK 1.2.0: InboundReceiverParams shape fix (breaking)

TypeScript SDK bumped to 1.2.0. The registerInboundReceiver() params interface has been corrected to match the API — the previous shape was never actually accepted by the backend and all calls were silently failing.

If you used hm.registerInboundReceiver() in your integration, update the call — the old shape no longer compiles.

// Before (1.1.0) — wrong shape, API rejected these calls
await hm.registerInboundReceiver({
  txHash,
  fromChain: 8453,
  toChain: 369,
  receiverAddress: "0x…",
  outputToken: "0x…",
});

// After (1.2.0) — matches what POST /v1/inbound-receiver/register actually accepts
await hm.registerInboundReceiver({
  txHash,
  fromAddress: "0x…",        // tx sender
  toAddress: "0x…",          // destination on PulseChain
  outputToken: "0x…",        // desired PulseChain token
  destinationDomain: 369,
  signature: "0x…",          // required EIP-712 signature
});

2026-04-16 — Multi-step SuperSwap (ETH/any token → PulseChain)

/v1/quote now returns a multi-step response shape when the source token is NOT USDC on a supported Sender chain. The frontend widget and SDK handle this automatically; direct API consumers should check response.data.quote.type:

• type: "multi-step" → Use steps[0].transactionRequest to send, then register the deposit with the afterStep1 payload (see register-inbound-receiver).
• No type field → Direct single-tx SuperSwap (e.g. USDC on Base → PLS).

2026-04-16 — PulseChain bridge status detection fix

The backend was polling the wrong contract for Hyperlane message delivery on PulseChain, so inbound SuperSwaps appeared stuck even after the bridge landed. Delivery is now detected correctly using the Hyperlane registry Mailbox (0x56176C7F…). Existing in-flight swaps resolve on the next poll after deploy — no action required from integrators.

2026-04-16 — /v1/balances reliability

Multi-chain bulk calls to Alchemy could silently drop entire 5-chain chunks when one flaky network was in the batch (users most-often saw Base missing). The endpoint now retries each network individually when a chunk returns empty, and groups high-traffic chains into the first request. No API shape change — just more complete results.

---

March 2026

2026-03-15 — Near Intents ADI Chain Support

• Added ADI chain (chain ID 900000015) to Near Intents
• ADI uses manual deposit mode

2026-03-01 — Widget v1.2 Release

• Added allowedTokens configuration option to the widget
• Improved wallet connection flow with automatic reconnection
• Fixed a bug where the widget would not update quotes on amount change

---

February 2026

2026-02-20 — On-Ramp Assets Endpoint

• New endpoint: GET /v1/onramp/assets returns all purchasable crypto assets with min/max amounts
• Added externalId parameter to POST /v1/onramp/checkout for partner order tracking

2026-02-10 — Rate Limit Increase

• Partner rate limit increased from 1,000 to 2,000 requests per minute
• Rate limit headers now included in all responses, including error responses

---

January 2026

2026-01-25 — Near Intents Expansion

• Added Aleo (chain ID 900000014) to Near Intents
• Improved deposit detection time for XRP and Stellar chains
• Added depositMode override parameter to POST /v1/execute

2026-01-10 — Webhook Events

• Added deposit.received, deposit.completed, and deposit.failed webhook events
• Webhook signature now uses HMAC-SHA256 (previously HMAC-SHA1)

If you have existing webhooks, update your signature verification to use SHA-256.

---

December 2025

2025-12-15 — Routes Endpoint

• New endpoint: GET /v1/routes returns multiple swap routes for comparison
• Added sortBy parameter (output, speed, gas)
• Added route tags (BEST_OUTPUT, FASTEST, CHEAPEST)

2025-12-01 — Gas Prices

• New endpoint: GET /v1/gas-prices returns current gas prices by chain
• Added slow, standard, and fast speed tiers with estimated confirmation times

---

November 2025

2025-11-20 — Fiat On-Ramp

• Launched fiat on-ramp integration with RampNow
• New endpoints: POST /v1/onramp/quote, POST /v1/onramp/checkout, GET /v1/onramp/status, GET /v1/onramp/config
• Supports USD, EUR, GBP, CAD, AUD, CHF
• Payment methods: credit card, debit card, bank transfer

2025-11-01 — Partner Dashboard

• Launched Partner Dashboard at app.hypermid.io
• New endpoints: GET /v1/partner/me, GET /v1/partner/stats, GET /v1/partner/transactions
• Webhook management: create, list, and delete webhook endpoints

---

October 2025

2025-10-15 — Near Intents Integration

• Added Near Intents as a swap provider
• Supported chains: NEAR, TON, Tron, XRP, DOGE, LTC, BCH, Stellar, Cardano, Aptos, StarkNet, Dash, Zcash
• New endpoints: POST /v1/execute/deposit/submit, GET /v1/execute/deposit/status

2025-10-01 — Initial Public Release

• Launched Hypermid Partner API v1
• Core endpoints: chains, tokens, connections, tools, quote, execute, status
• LI.FI integration for EVM and Solana cross-chain swaps
• TypeScript SDK published as @hypermid/sdk