> ## 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 Robinhood Portfolio > Get an owner's Bags V2 portfolio on Robinhood Chain. - `holdings`: tokens the owner has traded and still holds, with live list enrichment and balance. - `earnings`: every token the owner created, is partner on, or has claimed from — including launches with no earnings yet (`lifetimeWei` `"0"`). Each row carries the `feeShare` contract to claim against, `claimableWei`, and `lifetimeWei` (the owner's claimed + currently-claimable total, so claimed-out launches still list). `truncated` is `true` only when created/partner-token discovery hit the ~10k-token safety bound before exhausting the owner's tokens, in which case `earnings` is a subset — surface "some earnings may be missing" rather than treating the list as complete. `earnings` lists every token the owner created, is partner on, or has claimed from — including launches with no earnings yet (`lifetimeWei` `"0"`) and claimed-out launches (`lifetimeWei` = claimed + currently claimable). When `truncated` is `true`, earnings discovery hit its safety bound and `earnings` is a subset — surface "some earnings may be missing" rather than treating the list as complete. ## OpenAPI ````yaml GET /evm/rh/portfolio 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: Incorporation description: >- Endpoints for token incorporation payment, submission, and project management - 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: /evm/rh/portfolio: get: tags: - Robinhood Chain summary: Get portfolio description: >- Get an owner's Bags V2 portfolio on Robinhood Chain. - `holdings`: tokens the owner has traded and still holds, with live list enrichment and balance. - `earnings`: every token the owner created, is partner on, or has claimed from — including launches with no earnings yet (`lifetimeWei` `"0"`). Each row carries the `feeShare` contract to claim against, `claimableWei`, and `lifetimeWei` (the owner's claimed + currently-claimable total, so claimed-out launches still list). `truncated` is `true` only when created/partner-token discovery hit the ~10k-token safety bound before exhausting the owner's tokens, in which case `earnings` is a subset — surface "some earnings may be missing" rather than treating the list as complete. parameters: - name: owner in: query required: true schema: type: string description: >- Owner wallet address. Accepts any casing; normalized to EIP-55 checksum form. responses: '200': description: Successfully retrieved portfolio content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessResponse' - type: object properties: response: $ref: '#/components/schemas/RhPortfolio' '400': description: Bad request - Invalid owner address content: application/json: schema: $ref: '#/components/schemas/RhErrorResponse' '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/RhErrorResponse' security: - ApiKeyAuth: [] components: schemas: SuccessResponse: type: object properties: success: type: boolean example: true response: description: '' required: - success RhPortfolio: type: object properties: holdings: type: array items: $ref: '#/components/schemas/RhPortfolioHolding' description: >- Tokens the owner has traded and still holds, with live enrichment and balance. earnings: type: array items: $ref: '#/components/schemas/RhPortfolioEarnings' description: >- Every token the owner created, is partner on, or has claimed from — including launches with no earnings yet (`lifetimeWei` "0"). truncated: type: boolean description: >- True only when created/partner-token discovery hit the ~10k-token safety bound before exhausting the owner's tokens; `earnings` is then a subset, so surface "some earnings may be missing" rather than treating the list as complete. False on the normal path. required: - holdings - earnings - truncated RhErrorResponse: type: object properties: success: type: boolean example: false response: type: string description: Error message describing why the request failed. required: - success - response ErrorResponse: type: object properties: success: type: boolean example: false error: type: string description: Error message required: - success - error RhPortfolioHolding: type: object properties: token: allOf: - $ref: '#/components/schemas/RhTokenListItem' description: The held token with live price and bonding-progress enrichment. balanceWei: type: string description: >- The owner's token balance in token base units, as string to support bigint. required: - token - balanceWei RhPortfolioEarnings: type: object properties: token: allOf: - $ref: '#/components/schemas/RhToken' description: A token the owner created, is partner on, or has claimed from. feeShare: type: string description: Address of the fee-share contract to claim against for this row. claimableWei: type: string description: >- The owner's currently claimable amount on this token (wei), as string to support bigint. lifetimeWei: type: string description: >- The owner's lifetime earnings on this token (wei) = already claimed + currently claimable, as string to support bigint. "0" for launches with no earnings yet (still listed). required: - token - feeShare - claimableWei - lifetimeWei RhTokenListItem: allOf: - $ref: '#/components/schemas/RhToken' - type: object properties: priceEthPerToken: type: string nullable: true description: >- Live spot price as an 1e18 fixed-point decimal string (ETH per whole token). For migrated tokens this comes from the pool (slot0) only — null when the pool read is unavailable. Render null as "unavailable", never 0. bondingProgressPct: type: number description: >- Bonding-curve graduation progress, 0-99 while bonding and 100 once migrated. required: - priceEthPerToken - bondingProgressPct RhToken: type: object properties: address: type: string description: EIP-55 checksummed token address. name: type: string description: Token name. symbol: type: string description: Token symbol. metadataURI: type: string description: Token metadata URI as stored on-chain (typically IPFS). metadata: allOf: - $ref: '#/components/schemas/RhTokenMetadata' nullable: true description: >- Backend-resolved metadata (image, description). Null when resolution failed or is still pending. curve: type: string description: Address of the token's bonding curve contract. feeShare: type: string description: Address of the token's fee-share contract. poolId: type: string description: Uniswap V4 pool ID (bytes32 hex string) assigned at launch. creator: type: string description: EIP-55 checksummed address of the token creator. partner: type: string nullable: true description: >- EIP-55 checksummed partner address. Null when the token was launched without a partner. partnerFeeBps: type: number description: >- Partner's share of the creator-side fee half in basis points, snapshotted at launch. createdAtBlock: type: number description: Block number of the launch transaction. createdAtTimestamp: type: number description: Launch time as unix seconds. txHash: type: string description: Transaction hash of the launch. migrated: type: boolean description: >- Whether the token has graduated from the bonding curve to its Uniswap V4 pool. migratedAtBlock: type: number nullable: true description: >- Block number of the migration. Null while the token is still bonding. migratedAtTimestamp: type: number nullable: true description: >- Migration time as unix seconds. Null while the token is still bonding. required: - address - name - symbol - metadataURI - metadata - curve - feeShare - poolId - creator - partner - partnerFeeBps - createdAtBlock - createdAtTimestamp - txHash - migrated - migratedAtBlock - migratedAtTimestamp RhTokenMetadata: type: object properties: image: type: string nullable: true description: >- Resolved token image URL. Null when the metadata URI could not be resolved. description: type: string nullable: true description: >- Resolved token description. Null when the metadata URI could not be resolved. required: - image - description securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key authentication. Provide your API key as the header value. ````