> ## 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. # Search DLMM pools > Requires key scope `read`. Searches Meteora DLMM pools by name, symbol, or address. Returns 20 pools per page. ## OpenAPI ````yaml /api-reference/openapi.json get /dlmm/pools 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: /dlmm/pools: get: tags: - Market reads summary: Search DLMM pools description: >- Requires key scope `read`. Searches Meteora DLMM pools by name, symbol, or address. Returns 20 pools per page. operationId: searchDlmmPools parameters: - name: vault in: query required: true description: >- A vault this key may access. The server checks the allowlist and current on-chain authority before it reads. schema: $ref: '#/components/schemas/PublicKey' - name: query in: query required: true description: 1 to 64 characters, not only whitespace. schema: type: string minLength: 1 maxLength: 64 - name: page in: query required: false description: Page number from 1 to 50. Default 1. schema: type: integer minimum: 1 maximum: 50 default: 1 responses: '200': description: The vault address and one page of pools. content: application/json: schema: type: object required: - vault - data properties: vault: $ref: '#/components/schemas/PublicKey' data: $ref: '#/components/schemas/PoolSearchPage' '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' '502': $ref: '#/components/responses/BadGateway' '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 PoolSearchPage: type: object properties: total: type: integer page: type: integer pages: type: integer pools: type: array maxItems: 20 items: type: object properties: address: $ref: '#/components/schemas/PublicKey' name: type: string tokenX: type: object properties: mint: $ref: '#/components/schemas/PublicKey' symbol: type: string decimals: type: integer verified: type: boolean logo: type: - string - 'null' tokenY: type: object properties: mint: $ref: '#/components/schemas/PublicKey' symbol: type: string decimals: type: integer verified: type: boolean logo: type: - string - 'null' binStep: type: integer baseFeePct: type: number description: 'Percent: 0.04 means 0.04%.' tvl: type: number volume24h: type: number fees24h: type: number feeTvl24h: type: number description: 'Percent: 24-hour fees / TVL.' currentPrice: type: number description: Token Y per token X. 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 BadGateway: description: An upstream provider (Jupiter, Meteora, or Phoenix) failed. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: JupiterQuoteFailed 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.