> ## Documentation Index > Fetch the complete documentation index at: https://docs.bags.fm/llms.txt > Use this file to discover all available pages before exploring further. # Get Deployer Claimable Positions > Return exact token-specific pending and accrued SOL deployer earnings for a wallet. Computations use fresh finalized pool/config state and event attribution reconciled with the aggregate vault. Amounts are decimal strings. Normal creator/recipient earnings remain on the existing creator endpoints. A successful response may be cached for 5 seconds with a 2-second stale window; unavailable attribution is an error, not a zero balance. Returns token-attributed pending and accrued SOL deployer revenue. All amounts are decimal lamport strings. The wallet-wide residual remains separate, and unavailable attribution returns an error rather than a zero balance. See [Deployer Fees](/how-to-guides/deployer-fees#read-deployer-balances) for the accounting formula and the separate creator claim flow. ## OpenAPI ````yaml GET /fee-share/deployer/claimable-positions openapi: 3.1.0 info: title: Bags Public API v2 description: API endpoints for Bags platform version: 2.0.0 contact: name: Bags Support url: https://support.bags.fm servers: - url: https://public-api-v2.bags.fm/api/v1 description: Production server security: - ApiKeyAuth: [] tags: - name: Token Launch description: Endpoints for creating and managing token launches - name: Fee Share description: Endpoints for managing fee sharing configs - name: Fee Share Admin description: >- Endpoints for fee share admin operations including listing, transferring admin authority, and updating configs - name: Analytics description: Endpoints for retrieving token analytics and metadata - name: Fee Claiming description: Endpoints for claiming fees from various sources - name: State description: Endpoints for retrieving on-chain state and derived state - name: Trade description: Endpoints for getting trade quotes and executing token swaps - name: Partner description: Endpoints for managing partner configurations and claiming partner fees - name: Solana description: Endpoints for direct Solana blockchain interactions - name: EVM description: Endpoints for reading Bags EVM token data - name: Robinhood Chain description: Read endpoints for Bags V2 tokens on Robinhood Chain (chain id 4663) - name: Dexscreener description: >- Endpoints for managing Dexscreener token info orders, payments, and image uploads - name: Auth description: Endpoints for retrieving authenticated user information - name: Agent description: Endpoints for AI agent wallet-signature authentication (V2) paths: /fee-share/deployer/claimable-positions: get: tags: - Fee Share summary: Get deployer claimable positions description: >- Return exact token-specific pending and accrued SOL deployer earnings for a wallet. Computations use fresh finalized pool/config state and event attribution reconciled with the aggregate vault. Amounts are decimal strings. Normal creator/recipient earnings remain on the existing creator endpoints. A successful response may be cached for 5 seconds with a 2-second stale window; unavailable attribution is an error, not a zero balance. parameters: - name: wallet in: query required: true schema: type: string description: >- Base58 deployer public key; for newly created SOL fee-share v2 configs this is the config payer. responses: '200': description: Successfully retrieved reconciled deployer balances content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessResponse' - type: object properties: response: $ref: '#/components/schemas/DeployerClaimableData' description: Successful deployer response payload. required: - response '400': description: >- Bad request - Invalid wallet, unknown fields, or out-of-range parameters content: application/json: schema: $ref: '#/components/schemas/DeployerErrorResponse' '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limit exceeded - Retry according to Retry-After when present content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/DeployerErrorResponse' '503': description: >- Deployer accounting temporarily unavailable - Indexed attribution or the on-chain snapshot could not be reconciled. Retry; do not treat this as a zero balance. content: application/json: schema: $ref: '#/components/schemas/DeployerErrorResponse' headers: Retry-After: description: Suggested delay before retrying, in seconds. schema: type: string example: '5' security: - ApiKeyAuth: [] components: schemas: SuccessResponse: type: object properties: success: type: boolean example: true response: description: '' required: - success DeployerClaimableData: type: object properties: wallet: type: string description: Verified deployer wallet. quoteMint: type: string enum: - So11111111111111111111111111111111111111112 description: WSOL mint. This endpoint covers SOL fee-share v2 revenue only. positions: type: array description: >- Positive token-specific deployer balances, ordered by tokenMint. Zero balances are omitted. No pagination; requests exceeding accounting limits fail rather than return partial totals. items: $ref: '#/components/schemas/DeployerClaimablePosition' vaultClaimableLamports: type: string pattern: ^[0-9]+$ description: >- Current aggregate vault balance. Equals the sum of position accruedLamports plus unattributedVaultLamports; do not add it again to token totals. Decimal lamports as string to support bigint. unattributedVaultLamports: type: string pattern: ^[0-9]+$ description: >- Vault funds that are not recorded as token fee accrual, such as direct deposits. Reported separately and never assigned to an arbitrary token. Decimal lamports as string to support bigint. totalClaimableLamports: type: string pattern: ^[0-9]+$ description: >- Sum of position totalClaimableLamports plus unattributedVaultLamports. This already includes the aggregate vault balance. Decimal lamports as string to support bigint. required: - wallet - quoteMint - positions - vaultClaimableLamports - unattributedVaultLamports - totalClaimableLamports DeployerErrorResponse: type: object properties: success: type: boolean enum: - false description: False when the deployer request cannot be completed. response: type: string description: >- Error message. Backend deployer validation, availability, and server errors use response; public gateway auth failures use the shared error envelope. required: - success - response ErrorResponse: type: object properties: success: type: boolean example: false error: type: string description: Error message required: - success - error DeployerClaimablePosition: type: object properties: tokenMint: type: string description: Base mint of the token that generated these deployer fees. pendingDbcLamports: type: string pattern: ^[0-9]+$ description: >- Deployer cut still pending in the token's bonding-curve pool. Decimal lamports as string to support bigint. pendingDammLamports: type: string pattern: ^[0-9]+$ description: >- Deployer cut still pending across the token's DAMM v2 fee positions. Decimal lamports as string to support bigint. accruedLamports: type: string pattern: ^[0-9]+$ description: >- Unclaimed deployer fees already credited to the aggregate vault and attributed to this token through reconciled events. Decimal lamports as string to support bigint. totalClaimableLamports: type: string pattern: ^[0-9]+$ description: >- pendingDbcLamports + pendingDammLamports + accruedLamports. Excludes normal recipient earnings and unattributed vault funds. Decimal lamports as string to support bigint. required: - tokenMint - pendingDbcLamports - pendingDammLamports - accruedLamports - totalClaimableLamports securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key authentication. Provide your API key as the header value. ````