---
title: "Get or Create Crypto Prefund Wallet"
method: POST
path: "/v3/prefund-accounts/crypto-wallet"
tags: ["Prefund Accounts"]
---

# Get or Create Crypto Prefund Wallet

`POST /v3/prefund-accounts/crypto-wallet`

## Request

- Base URL: `https://sandbox-api.transfi.com`
- URL: `https://sandbox-api.transfi.com/v3/prefund-accounts/crypto-wallet`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/transfi/apis/transfi-single-integrated-api/docs/v3/prefund-accounts/crypto-wallet/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns a wallet address for crypto prefunding operations. If a wallet already exists for the organization and crypto ticker, the existing wallet address is returned; otherwise a new wallet is created.

Either `cryptoTicker` must be provided, OR both `currency` and `network` must be provided together. The wallet is created per organization and crypto ticker combination — once created, subsequent calls return the same wallet address.

## Headers

- `MID` string

## Request body

- object
  - `cryptoTicker` string: The cryptocurrency ticker symbol (e.g., USDTPOLYGON). Either cryptoTicker must be provided, OR both currency and network must be provided together.
  - `currency` string: The cryptocurrency symbol (e.g., BTC, ETH, USDT). Required when cryptoTicker is not provided. Must be provided together with network.
  - `network` string: Blockchain network (e.g., polygon). Required when cryptoTicker is not provided. Must be provided together with currency.

## Response `200`

Wallet address retrieved or created successfully

- object
  - `status` string: Response status
  - `data` object
    - `walletAddress` string: The crypto wallet address for prefunding
  - `traceId` string, uuid: Request trace identifier

## Other responses

- `400`: Validation error - Invalid crypto ticker/currency or missing required network with currency
- `401`: Unauthorized - Invalid API credentials
- `500`: Internal server error - Wallet creation failed

## Changes

- **2026-11-03** `7b745621a79f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/transfi/apis/transfi-single-integrated-api/changes/v3/prefund-accounts/crypto-wallet/post.md)

---

[API](https://skmtc.dev/transfi/apis/transfi-single-integrated-api.md) - [All operations](https://skmtc.dev/transfi/apis/transfi-single-integrated-api/llms.txt) - [OpenAPI document](https://skmtc.dev/transfi/apis/transfi-single-integrated-api/revisions/7b745621a79f?raw)