> ## Documentation Index > Fetch the complete documentation index at: https://docs.hedgin.xyz/llms.txt > Use this file to discover all available pages before exploring further. # List open strategies > Requires key scope `read`. Returns the vault's open strategies sorted by id. A strategy whose protocol account cannot be read appears with `type: "unreadable"`. The data can be up to 15 seconds old. ## OpenAPI ````yaml /api-reference/openapi.json get /vaults/{vault}/strategies openapi: 3.1.0 info: title: Hedgin manager bot API version: 1.0.0 description: >- Versioned HTTP API for approved manager bots. Reads vault state and builds unsigned Solana transactions. The bot signs locally with the vault's current authority key. Runs only on Solana mainnet-beta. servers: - url: https://hedgin.xyz/api/external/v1 description: Production (Solana mainnet-beta) security: - bearerAuth: [] tags: - name: Vault reads - name: Market reads - name: Jupiter transactions - name: Meteora DLMM transactions - name: Phoenix transactions - name: Vault and strategy transactions - name: Send and status paths: /vaults/{vault}/strategies: get: tags: - Vault reads summary: List open strategies description: >- Requires key scope `read`. Returns the vault's open strategies sorted by id. A strategy whose protocol account cannot be read appears with `type: "unreadable"`. The data can be up to 15 seconds old. operationId: getVaultStrategies parameters: - name: vault in: path required: true description: >- Vault public key. Must be in the key's allowlist when the key has one, and the key's manager must be the vault's current on-chain authority. schema: $ref: '#/components/schemas/PublicKey' responses: '200': description: The vault address and its data. content: application/json: schema: type: object required: - vault - data properties: vault: $ref: '#/components/schemas/PublicKey' data: type: array items: $ref: '#/components/schemas/StrategyView' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' '503': $ref: '#/components/responses/ServiceUnavailable' components: schemas: PublicKey: type: string description: >- Base58 Solana public key. The server decodes it and rejects anything that is not 32 bytes. pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$ example: So11111111111111111111111111111111111111112 StrategyView: description: >- One open strategy. `type` selects the shape. All shapes share `address`, `id`, `createdTs`, and `lastActionTs`. oneOf: - title: jupiter type: object properties: type: const: jupiter address: $ref: '#/components/schemas/PublicKey' id: type: integer createdTs: type: integer lastActionTs: type: integer targetMint: $ref: '#/components/schemas/PublicKey' symbol: type: string decimals: type: integer logo: type: - string - 'null' priceUsd: type: - number - 'null' uiMultiplier: type: number vaultBalance: $ref: '#/components/schemas/BaseUnitAmount' - title: dlmm type: object properties: type: const: dlmm address: $ref: '#/components/schemas/PublicKey' id: type: integer createdTs: type: integer lastActionTs: type: integer position: $ref: '#/components/schemas/PublicKey' lbPair: $ref: '#/components/schemas/PublicKey' tokenX: $ref: '#/components/schemas/TokenInfo' tokenY: $ref: '#/components/schemas/TokenInfo' lowerBinId: type: integer upperBinId: type: integer description: Inclusive. activeBinId: type: integer binStep: type: integer lowerPrice: type: string description: Token Y per token X. upperPrice: type: string activePrice: type: string amountX: $ref: '#/components/schemas/BaseUnitAmount' amountY: $ref: '#/components/schemas/BaseUnitAmount' pendingFeeX: $ref: '#/components/schemas/BaseUnitAmount' pendingFeeY: $ref: '#/components/schemas/BaseUnitAmount' bins: type: array items: $ref: '#/components/schemas/BinAmounts' pnlUsd: type: - number - 'null' pnlPct: type: - number - 'null' - title: dlmm_limit_order type: object properties: type: const: dlmm_limit_order address: $ref: '#/components/schemas/PublicKey' id: type: integer createdTs: type: integer lastActionTs: type: integer limitOrder: $ref: '#/components/schemas/PublicKey' lbPair: $ref: '#/components/schemas/PublicKey' tokenX: $ref: '#/components/schemas/TokenInfo' tokenY: $ref: '#/components/schemas/TokenInfo' side: type: string enum: - ask - bid binStep: type: integer lowerBinId: type: integer upperBinId: type: integer activeBinId: type: integer lowerPrice: type: string upperPrice: type: string activePrice: type: string bins: type: array items: type: object properties: binId: type: integer status: type: string enum: - open - partial - filled empty: type: boolean deposit: $ref: '#/components/schemas/BaseUnitAmount' unfilled: $ref: '#/components/schemas/BaseUnitAmount' proceeds: $ref: '#/components/schemas/BaseUnitAmount' feeX: $ref: '#/components/schemas/BaseUnitAmount' feeY: $ref: '#/components/schemas/BaseUnitAmount' depositX: $ref: '#/components/schemas/BaseUnitAmount' depositY: $ref: '#/components/schemas/BaseUnitAmount' unfilledX: $ref: '#/components/schemas/BaseUnitAmount' unfilledY: $ref: '#/components/schemas/BaseUnitAmount' proceedsX: $ref: '#/components/schemas/BaseUnitAmount' proceedsY: $ref: '#/components/schemas/BaseUnitAmount' feeX: $ref: '#/components/schemas/BaseUnitAmount' feeY: $ref: '#/components/schemas/BaseUnitAmount' - title: phoenix type: object properties: type: const: phoenix address: $ref: '#/components/schemas/PublicKey' id: type: integer createdTs: type: integer lastActionTs: type: integer traderAccount: $ref: '#/components/schemas/PublicKey' canonicalMint: $ref: '#/components/schemas/PublicKey' collateral: $ref: '#/components/schemas/BaseUnitAmount' equity: $ref: '#/components/schemas/BaseUnitAmount' description: >- Collateral + unrealized PnL + unsettled funding, floored at 0. USDC base units. canonicalBalance: $ref: '#/components/schemas/BaseUnitAmount' leverage: type: - number - 'null' positions: type: array items: $ref: '#/components/schemas/PerpPosition' closable: type: boolean - title: unreadable type: object properties: type: const: unreadable address: $ref: '#/components/schemas/PublicKey' id: type: integer createdTs: type: integer lastActionTs: type: integer protocol: type: string enum: - dlmm - dlmm_limit_order - phoenix position: $ref: '#/components/schemas/PublicKey' reason: type: string BaseUnitAmount: type: string description: >- Non-negative integer in token base units, as a decimal string. Must fit in u64 (at most 18446744073709551615). Never a JSON number. pattern: ^\d+$ maxLength: 20 example: '1000000' TokenInfo: type: object required: - mint - symbol - decimals - logo - priceUsd properties: mint: $ref: '#/components/schemas/PublicKey' symbol: type: string name: type: string decimals: type: integer logo: type: - string - 'null' priceUsd: type: - number - 'null' description: USD per whole token (base units / 10^decimals). Display only. uiMultiplier: type: number description: >- Token-2022 scaled UI amount multiplier. Absent for unscaled mints. Display only. BinAmounts: type: object properties: binId: type: integer amountX: $ref: '#/components/schemas/BaseUnitAmount' amountY: $ref: '#/components/schemas/BaseUnitAmount' PerpPosition: type: object properties: assetId: type: integer symbol: type: string logo: type: - string - 'null' side: type: string enum: - long - short size: type: string description: Whole base units, decimal string. entryPrice: type: string markPrice: type: string notional: type: string unrealizedPnl: type: string accruedFunding: type: string Error: type: object description: >- Every error response uses this envelope. Responses with status 500, 502, or 503 always carry the message `Service temporarily unavailable`. Responses with status 422 always carry the message `Transaction rejected during simulation or preflight`. In both cases `code` still names the cause. required: - error properties: error: type: object required: - code - message properties: code: type: string description: >- Stable machine-readable code, such as `Validation`, `Forbidden`, or a decoded program error name. example: Validation message: type: string description: Human-readable detail. Never contains provider logs. example: vault must be a public key responses: BadRequest: description: >- Invalid path, query, or body. Builder messages name the field, such as `amount: must be a non-negative integer string`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: Validation message: vault must be a public key Unauthorized: description: Missing, malformed, unknown, revoked, or expired API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: Unauthorized message: Invalid API key Forbidden: description: >- The key lacks the required scope, the vault is outside the key's allowlist, or the key's manager is not the vault's current on-chain authority. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: Forbidden message: Action is not enabled for this key NotFound: description: Unknown route, or the vault, mint, pool, or strategy does not exist. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NotFound message: Vault not found TooManyRequests: description: A rate limit is exhausted. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RateLimited message: Too many requests, slow down InternalError: description: >- Internal error, including a builder that returned an invalid transaction (`BuildFailed`). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: Internal message: Service temporarily unavailable ServiceUnavailable: description: RPC, key store, or service configuration unavailable. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RpcUnavailable message: Service temporarily unavailable securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: hv1__ description: >- API key issued by a Hedgin administrator, in the form `hv1__`. `` is 1 to 48 characters and `` is 32 to 128 characters, both from `[A-Za-z0-9_-]`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.