POST
/
v1
/
wallet
/
transaction
/
curl --request POST \
  --url https://api.withconvexity.com/v1/wallet/transaction/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "fromAddress": 0,
  "toAddress": "0x9bF2a1C0d3E4f5A6b7C8d9E0f1A2b3C4d5E6f7A8",
  "amount": "1000000",
  "chainType": "EVM",
  "chainId": 8453,
  "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
}
'
{
  "status": true,
  "message": "Transfer submitted successfully",
  "data": {
    "id": "c7e0a9b8-1234-4abc-9def-0123456789ab",
    "type": "TRANSFER",
    "chainType": "EVM",
    "network": "MAINNET",
    "chainId": 8453,
    "signerType": "BUSINESS_HD",
    "fromAddress": "0x3A1cF4e2B8D9a7C6e5F4b3A2c1D0e9F8a7B6c5D4",
    "addressIndex": 0,
    "toAddress": "0x9bF2a1C0d3E4f5A6b7C8d9E0f1A2b3C4d5E6f7A8",
    "amount": "1000000",
    "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "data": null,
    "value": null,
    "txHash": "0x5d2e8f3a1b4c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e",
    "status": "COMPLETED",
    "gasUsed": "52000",
    "feeWei": "420000000000000",
    "createdAt": "2026-06-17T10:20:00.000Z",
    "updatedAt": "2026-06-17T10:20:08.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

OAuth 2.0 access token from Auth-Edge.

Headers

​
Idempotency-Key
string
required

Unique client-generated key (use a UUID) that makes this request safe to retry. A retry sent with the same key returns the original result instead of submitting again. See Idempotency.

Body

application/json
​
fromAddress
integer
required

HD addressIndex of the sending wallet.

​
toAddress
string
required

Recipient address.

​
amount
string
required

Amount in the token's smallest unit (e.g. "1000000").

​
chainType
enum<string>
required
Available options:
EVM,
SOLANA
​
chainId
integer

Target chain id. Use 84532 (Base Sepolia) for sponsored testnet transfers. Required for EVM.

​
tokenAddress
string

ERC-20 token contract. Omit for a native transfer.

Response

Created

The response is of type object.