> ## Documentation Index > Fetch the complete documentation index at: https://docs.getpara.com/llms.txt > Use this file to discover all available pages before exploring further. # Transfer > High-level transfer endpoint that handles nonce, gas, and fee estimation automatically. Supports native and token transfers on EVM and Solana. **EVM:** Provide `to`, `value`, and `chainId`. The endpoint auto-fills `nonce` (via `getTransactionCount`), `gasLimit` (via `estimateGas` with 20% buffer), and fee data (`maxFeePerGas`/`gasPrice` via `getFeeData`) if omitted. Transaction `type` is auto-detected from chain (EIP-1559 if supported, legacy otherwise). For ERC-20 transfers, provide `tokenAddress` — the endpoint encodes the `transfer(address,uint256)` calldata automatically. **Solana:** Provide `to` and `value` (in lamports for SOL, smallest unit for SPL). For SPL token transfers, also provide `tokenAddress` (the mint address). Blockhash is fetched automatically. Address screening is enabled by default when Para has screening configured. Set `addressScreening: false` to skip recipient screening for a request. Use `kind` to explicitly declare the transfer type (`NATIVE`, `ERC20`, or `SPL`), or omit it to infer from the presence of `tokenAddress` (backwards compatible). ## OpenAPI ````yaml /openapi.yaml post /v1/wallets/{walletId}/transfer openapi: 3.0.3 info: title: Para REST API version: '1.0' description: Server-to-server wallet creation and signing over HTTP servers: - url: https://api.beta.getpara.com description: Beta - url: https://api.getpara.com description: Production security: - ApiKeyAuth: [] paths: /v1/wallets/{walletId}/transfer: post: tags: - Signing summary: Transfer description: > High-level transfer endpoint that handles nonce, gas, and fee estimation automatically. Supports native and token transfers on EVM and Solana. **EVM:** Provide `to`, `value`, and `chainId`. The endpoint auto-fills `nonce` (via `getTransactionCount`), `gasLimit` (via `estimateGas` with 20% buffer), and fee data (`maxFeePerGas`/`gasPrice` via `getFeeData`) if omitted. Transaction `type` is auto-detected from chain (EIP-1559 if supported, legacy otherwise). For ERC-20 transfers, provide `tokenAddress` — the endpoint encodes the `transfer(address,uint256)` calldata automatically. **Solana:** Provide `to` and `value` (in lamports for SOL, smallest unit for SPL). For SPL token transfers, also provide `tokenAddress` (the mint address). Blockhash is fetched automatically. Address screening is enabled by default when Para has screening configured. Set `addressScreening: false` to skip recipient screening for a request. Use `kind` to explicitly declare the transfer type (`NATIVE`, `ERC20`, or `SPL`), or omit it to infer from the presence of `tokenAddress` (backwards compatible). operationId: transfer parameters: - $ref: '#/components/parameters/WalletId' - $ref: '#/components/parameters/RequestId' - $ref: '#/components/parameters/IdempotencyKey' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferRequest' responses: '200': description: Signed transaction headers: x-transaction-id: schema: type: string format: uuid description: >- Set when the transfer was broadcast (default behavior). Matches the persisted transaction record id. content: application/json: schema: $ref: '#/components/schemas/TransferResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': description: | Forbidden. Either the API key is invalid (`FORBIDDEN`) or a policy denied the operation (`POLICY_DENIED`). content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/PolicyDeniedError' examples: forbidden: summary: Invalid API key value: code: FORBIDDEN message: invalid secret api key policyDenied: summary: Denied by policy value: code: POLICY_DENIED message: Transaction denied by policy deniedBy: scopeName: transfers permissionType: TRANSFER condition: resource: VALUE comparator: GREATER_THAN reference: '1000000000000000000' sanctionedAddress: summary: Sanctioned recipient value: code: SANCTIONED_ADDRESS message: Recipient address is sanctioned screeningUnavailable: summary: Address screening unavailable value: code: ADDRESS_SCREENING_UNAVAILABLE message: Address screening is unavailable '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/IdempotencyConflict' '422': $ref: '#/components/responses/Unprocessable' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' components: parameters: WalletId: name: walletId in: path required: true description: Wallet ID schema: type: string example: 0a1b2c3d-4e5f-6789-abcd-ef0123456789 RequestId: name: X-Request-Id in: header required: false description: UUID for request tracing. Para returns one if omitted. schema: type: string format: uuid IdempotencyKey: name: Idempotency-Key in: header required: false description: > Unique key for safe retries on POST endpoints. If a request with the same key is received within 24 hours, the original response is returned without re-executing. Recommended format: UUID v4. Max length 256 characters. Returns 422 if the same key is reused with a different request body. Returns 409 if a request with the same key is still being processed. schema: type: string maxLength: 256 schemas: TransferRequest: type: object required: - to - value properties: to: type: string description: Recipient address example: 0x742d35Cc6634C0532925a3b844Bc9e7595f... value: type: string description: Amount in smallest unit (wei for ETH, lamports for SOL) example: '1000000000000000' chainId: oneOf: - type: string - type: integer description: Chain ID. Required for EVM wallets, ignored for Solana. example: '1' kind: type: string enum: - NATIVE - ERC20 - SPL description: | Transfer type discriminator. EVM wallets accept `NATIVE` or `ERC20`. Solana wallets accept `NATIVE` or `SPL`. If omitted, inferred from `tokenAddress` presence (backwards compatible). tokenAddress: type: string description: >- Token contract address. Required when kind is `ERC20` or `SPL`. EVM: ERC-20 contract. Solana: SPL mint address. nonce: type: integer minimum: 0 description: >- Transaction nonce. EVM only — auto-fetched via `getTransactionCount` if omitted. gasLimit: type: string description: Gas limit. EVM only — auto-estimated with 20% buffer if omitted. maxFeePerGas: type: string description: EIP-1559 max fee per gas. EVM only — auto-fetched if omitted. maxPriorityFeePerGas: type: string description: >- EIP-1559 max priority fee per gas. EVM only — auto-fetched if omitted. gasPrice: type: string description: Legacy gas price. EVM only — auto-fetched if omitted. type: type: integer enum: - 0 - 2 description: >- Transaction type: 0 (legacy) or 2 (EIP-1559). EVM only — auto-detected from chain if omitted. network: type: string enum: - SOLANA - SOLANA_DEVNET description: >- Solana network. In production, defaults to SOLANA. In beta, only SOLANA_DEVNET is allowed (and is the default). broadcast: type: boolean default: true description: >- Whether to broadcast the signed transaction. Defaults to true. Set to false to receive only the signed transaction without broadcasting. addressScreening: type: boolean default: true description: >- Whether to screen the recipient address before signing. Defaults to true when address screening is enabled for the API. TransferResponse: type: object required: - signedTransaction properties: signedTransaction: type: string description: >- Signed transaction ready for broadcast. EVM: RLP-encoded hex string. Solana: base64-encoded string. example: 0x02f8... txHash: type: string nullable: true description: >- Transaction hash. Present when broadcast is true (default). Omitted when broadcast is false. example: 0x1234abcd... transactionId: type: string format: uuid description: >- Persisted transaction record id (present only when broadcasted). Use it to poll `GET /v1/wallets/{walletId}/transactions/{transactionId}` or match incoming `rest.transaction.confirmed` / `rest.transaction.failed` webhooks. example: 550e8400-e29b-41d4-a716-446655440000 Error: type: object required: - code - message properties: code: type: string description: Machine-readable error code for programmatic handling example: INVALID_REQUEST message: type: string description: Human-readable error message transactionId: type: string format: uuid description: >- Persisted transaction record id. Present only when a broadcast request failed after a history row was created. failureStage: type: string enum: - mpc_sign - signature_apply - signer_verify - broadcast - monitor_timeout description: >- Which stage of the broadcast lifecycle failed. Present on persisted broadcast failures. failureCode: type: string description: >- Machine-readable failure reason from the underlying broadcast helper (e.g. `INSUFFICIENT_NATIVE_BALANCE`, `EXECUTION_FAILED`). Present on broadcast-stage failures. signedTransaction: type: string description: >- Signed transaction bytes. Present on broadcast failures that happen after signing completed. additionalProperties: true description: > All error responses include `code` and `message` fields. Some errors include extra fields (e.g. `walletId` on 409 Conflict). Broadcast failures that occur after a persisted transaction row is created include `transactionId`, `failureStage`, and (on broadcast-stage failures) `failureCode`, and also set the `x-transaction-id` response header. If signing completed before the failure, `signedTransaction` is included so callers can inspect or retry the already-signed bytes. Common error codes: `INVALID_REQUEST`, `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `CONFLICT`, `WALLET_ALREADY_EXISTS`, `WALLET_ALREADY_CLAIMED`, `RATE_LIMITED`, `INTERNAL_ERROR`. PolicyDeniedError: type: object properties: code: type: string example: POLICY_DENIED message: type: string example: Transaction denied by policy deniedBy: type: object properties: scopeName: type: string permissionType: type: string condition: type: object properties: resource: type: string comparator: type: string reference: {} responses: BadRequest: description: Invalid request body content: application/json: schema: $ref: '#/components/schemas/Error' example: code: INVALID_REQUEST message: type must be one of EVM, SOLANA, COSMOS, STELLAR Unauthorized: description: API key not provided content: application/json: schema: $ref: '#/components/schemas/Error' example: code: UNAUTHORIZED message: secret api key not provided NotFound: description: Wallet not found content: application/json: schema: $ref: '#/components/schemas/Error' example: code: NOT_FOUND message: wallet not found IdempotencyConflict: description: A request with this idempotency key is currently being processed content: application/json: schema: $ref: '#/components/schemas/Error' example: code: CONFLICT message: A request with this idempotency key is currently being processed Unprocessable: description: Idempotency key reused with a different request body content: application/json: schema: $ref: '#/components/schemas/Error' example: code: UNPROCESSABLE message: >- Idempotency key has already been used with different request parameters TooManyRequests: description: Rate limit exceeded headers: Retry-After: schema: type: integer description: Seconds until the rate limit window resets example: 60 content: application/json: schema: $ref: '#/components/schemas/Error' example: code: RATE_LIMITED message: Rate limit exceeded, try again shortly. ServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' example: code: INTERNAL_ERROR message: Internal Server Error securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: Your partner secret key (server-side only) x-default: sk_your_secret_key_here ````