Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hubra.app/llms.txt

Use this file to discover all available pages before exploring further.

GET https://hubra.app/api/v1/strategies/{key}
Full per-strategy context: intro paragraph, ordered steps, trust labels, on-chain handles, and the action kinds the agent surface accepts. Live APY, exchange rate, and any other live data are included alongside the static descriptors so a single call answers “what is this strategy and what is it doing right now?”

​
Request

curl https://hubra.app/api/v1/strategies/sol-liquid-stake
Path parameterTypeDescription
keystringOne of the canonical strategy keys: sol-native-stake, sol-liquid-stake, usdc-earn.

​
Response (live strategy)

{
  "strategy": {
    "key":    "sol-liquid-stake",
    "asset":  "SOL",
    "title":  "Liquid",
    "blurb":  "Mint raSOL via Sanctum.",
    "status": "live",

    "intro":  "Mint raSOL by depositing SOL into Hubra's Sanctum-routed pool. Your raSOL is non-rebasing; the SOL redemption rate climbs as the underlying stake earns rewards.",

    "steps": [
      { "ord": "1", "lead": "Deposit SOL",  "tail": "Routed to Hubra's validator via Sanctum." },
      { "ord": "2", "lead": "Receive raSOL", "tail": "Non-rebasing, value-accruing receipt." },
      { "ord": "3", "lead": "Use freely",    "tail": "Hold, swap, lend, or LP across Solana DeFi." }
    ],

    "trust": [
      "Self-custody",
      "No Hubra protocol fee",
      "Sanctum-audited infrastructure"
    ],

    "onchain": {
      "assetMint":     "So11111111111111111111111111111111111111112",
      "receiptMint":   "HUBsveNpjo5pWqNkH57QzxjQASdTVXcSK7bVKTSZtcSX",
      "receiptSymbol": "raSOL"
    },

    "actions": {
      "stake":   { "kinds": ["mint"],            "notes": "Mints raSOL via Sanctum's swap router (SOL → raSOL)." },
      "unstake": { "kinds": ["instant", "slow"], "notes": "`instant` routes raSOL → SOL via Sanctum liquidity. `slow` runs Sanctum withdrawStake to a native stake account, then standard epoch deactivation." }
    },

    "live": { "apy": 6.4, "exchangeRate": 1.0723 }
  }
}

​
Field reference

FieldDescription
introOne-paragraph summary an agent can quote to its principal.
stepsNumbered steps describing what the strategy does, in order.
trustTrust labels — the same chips the UI shows.
onchainOn-chain handles relevant to building transactions against this strategy. Field set varies by strategy.
actions.stake.kindsAction kinds accepted by POST /api/v1/stake for this strategy.
actions.unstake.kindsAction kinds accepted by POST /api/v1/unstake for this strategy.
live.apyHeadline APY as a percentage.
live.exchangeRateCurrent asset-per-receipt rate.
The onchain field set is strategy-specific:
  • sol-native-stake: validatorVoteAccount, assetMint.
  • sol-liquid-stake: assetMint, receiptMint, receiptSymbol.
  • usdc-earn: assetMint, receiptMint, receiptSymbol, voltrVault.

​
Errors

StatusSlugWhen
404not_foundUnknown strategy key. See GET /api/v1/strategies for the canonical list.
503service_unavailableStrategy is announced but not live yet. Includes a Retry-After header.
Coming-soon example response: 
{
  "type":   "https://hubra.app/errors/service_unavailable",
  "title":  "Service unavailable",
  "status": 503,
  "detail": "Strategy \"<key>\" is announced but not live yet."
}

​
See also

GET /strategies

The full list.

POST /stake

Build a stake tx using one of the strategy keys.