> ## Documentation Index > Fetch the complete documentation index at: https://cobo.com/products/agentic-wallet/manual/llms.txt > Use this file to discover all available pages before exploring further. # Create wallet address > This operation derives a new on-chain address for the specified wallet and chain. The wallet ID can be retrieved by calling the List all wallets operation. Provide `chain_id` (Cobo metadata id, e.g. `SETH`) and/or `chain_type` (WaaS id such as `ETH`/`SOL`, or a resolvable Cobo id). If only `chain_id` is set, the server resolves the WaaS chain type. If only `chain_type` is set, behavior matches the previous API. If both are set, `chain_id` is used. ## OpenAPI ````yaml post /api/v1/wallets/{wallet_uuid}/addresses openapi: 3.1.0 info: title: Cobo Agentic Wallet Service description: Unified wallet engine for human and agent principals version: 1.3.0 servers: [] security: [] paths: /api/v1/wallets/{wallet_uuid}/addresses: post: tags: - Wallets summary: Create wallet address description: >- This operation derives a new on-chain address for the specified wallet and chain. The wallet ID can be retrieved by calling the List all wallets operation. Provide `chain_id` (Cobo metadata id, e.g. `SETH`) and/or `chain_type` (WaaS id such as `ETH`/`SOL`, or a resolvable Cobo id). If only `chain_id` is set, the server resolves the WaaS chain type. If only `chain_type` is set, behavior matches the previous API. If both are set, `chain_id` is used. operationId: create_wallet_address parameters: - name: wallet_uuid in: path required: true schema: type: string format: uuid title: Wallet Uuid - name: X-API-Key in: header required: false schema: title: X-Api-Key type: string nullable: true requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WalletAddressCreate' responses: '200': description: Already exists (idempotent). Successful Response content: application/json: schema: $ref: '#/components/schemas/StandardResponse_WalletAddressRead_' '201': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/StandardResponse_WalletAddressRead_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/WrappedValidationError' components: schemas: WalletAddressCreate: properties: chain_id: title: Chain Id description: >- Cobo ``chain_id`` from chain metadata (for example, ``SETH``, ``BASE_ETH``). When both ``chain_id`` and ``chain_type`` are set, ``chain_id`` is used. type: string maxLength: 100 minLength: 1 nullable: true chain_type: title: Chain Type description: >- WaaS chain identifier (for example, ``ETH``, ``SOL``) or a Cobo ``chain_id`` that resolves to one (for example, ``SETH``). Ignored when ``chain_id`` is set. type: string maxLength: 100 minLength: 1 nullable: true type: object title: WalletAddressCreate description: Request payload for creating wallet address. StandardResponse_WalletAddressRead_: properties: success: type: boolean title: Success default: true result: $ref: '#/components/schemas/WalletAddressRead' suggestion: type: string title: Suggestion default: '' message: type: string title: Message default: '' meta: $ref: '#/components/schemas/PaginationMeta' nullable: true type: object required: - result title: StandardResponse[WalletAddressRead] WrappedValidationError: title: WrappedValidationError type: object required: - success - error properties: success: type: boolean const: false default: false title: Success error: type: object title: Error required: - detail properties: detail: type: array title: Detail items: $ref: '#/components/schemas/ValidationError' WalletAddressRead: properties: wallet_id: type: string format: uuid title: Wallet Id description: The wallet ID. chain_type: type: string title: Chain Type description: >- The address standard shared across chains — chains with the same chain_type share one wallet address. E.g. ETH, BASE, ARB, OP, BSC, MATIC, AVAXC, and SETH are all chain_type: ETH, so they all use the same 0x... address. default: '' compatible_chains: items: type: string type: array title: Compatible Chains description: >- Supported chain IDs that share the same address under this chain_type. address: type: string title: Address description: The on-chain address. created_at: type: string format: date-time title: Created At description: The timestamp when the address was created, in ISO 8601 format. updated_at: type: string format: date-time title: Updated At description: The timestamp when the address was last updated, in ISO 8601 format. type: object required: - wallet_id - address - created_at - updated_at title: WalletAddressRead description: Wallet address response payload. PaginationMeta: properties: total: title: Total type: integer nullable: true offset: title: Offset type: integer nullable: true limit: title: Limit type: integer nullable: true has_more: title: Has More type: boolean nullable: true after: title: After type: string nullable: true before: title: Before type: string nullable: true type: object title: PaginationMeta description: |- Pagination metadata for list responses. Supports both legacy offset-based and cursor-based pagination. Cursor fields (``has_more``, ``after``, ``before``) are populated for cursor-paginated endpoints. Legacy fields (``offset``, ``limit``) are populated when the caller uses the deprecated ``offset`` parameter. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ````