Execute on-demand conversion - Payward Developer Documentation

curl --request POST \
  --url https://api.services.payward.com/v1/accounts/{account_id}/on-demand-conversions \
  --header 'API-Key: <api-key>' \
  --header 'API-Nonce: <api-key>' \
  --header 'API-Sign: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "from": {
    "symbol": "USD",
    "type": "balance",
    "amount": "1000.00"
  },
  "to": {
    "symbol": "ETH",
    "type": "wallet",
    "wallet": {
      "via": "ethereum",
      "address": "0xabcdef1234567890abcdef1234567890abcdef12",
      "memo": "destination-memo",
      "tag": "destination-tag"
    }
  }
}
'

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000009",
    "status": "converting",
    "from": {
      "symbol": "USD",
      "amount": "1000.00",
      "type": "balance",
      "status": "pending"
    },
    "to": {
      "symbol": "ETH",
      "amount": "0.40000000",
      "type": "wallet",
      "status": "pending",
      "wallet": {
        "via": "ethereum",
        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
        "memo": "destination-memo",
        "tag": "destination-tag"
      }
    },
    "rate": {
      "base": {
        "symbol": "USD"
      },
      "quote": {
        "symbol": "ETH"
      },
      "price": "0.0004"
    },
    "fees": {
      "from": {
        "symbol": "EUR",
        "amount": "0.50"
      },
      "trade": {
        "symbol": "EUR",
        "amount": "0.25"
      },
      "to": {
        "symbol": "BTC",
        "amount": "0.00001"
      }
    },
    "created_at": "2026-07-31T00:00:00Z",
    "updated_at": "2026-07-31T00:00:00Z"
  }
}

POST

/

v1

/

accounts

/

{account_id}

/

on-demand-conversions

curl --request POST \
  --url https://api.services.payward.com/v1/accounts/{account_id}/on-demand-conversions \
  --header 'API-Key: <api-key>' \
  --header 'API-Nonce: <api-key>' \
  --header 'API-Sign: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "from": {
    "symbol": "USD",
    "type": "balance",
    "amount": "1000.00"
  },
  "to": {
    "symbol": "ETH",
    "type": "wallet",
    "wallet": {
      "via": "ethereum",
      "address": "0xabcdef1234567890abcdef1234567890abcdef12",
      "memo": "destination-memo",
      "tag": "destination-tag"
    }
  }
}
'

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000009",
    "status": "converting",
    "from": {
      "symbol": "USD",
      "amount": "1000.00",
      "type": "balance",
      "status": "pending"
    },
    "to": {
      "symbol": "ETH",
      "amount": "0.40000000",
      "type": "wallet",
      "status": "pending",
      "wallet": {
        "via": "ethereum",
        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
        "memo": "destination-memo",
        "tag": "destination-tag"
      }
    },
    "rate": {
      "base": {
        "symbol": "USD"
      },
      "quote": {
        "symbol": "ETH"
      },
      "price": "0.0004"
    },
    "fees": {
      "from": {
        "symbol": "EUR",
        "amount": "0.50"
      },
      "trade": {
        "symbol": "EUR",
        "amount": "0.25"
      },
      "to": {
        "symbol": "BTC",
        "amount": "0.00001"
      }
    },
    "created_at": "2026-07-31T00:00:00Z",
    "updated_at": "2026-07-31T00:00:00Z"
  }
}

Authorizations

API-Key

string

header

required

Your public API key. Identifies the partner making the request.

API-Sign

string

header

required

HMAC signature over the request, computed with your private key.

API-Nonce

string

header

required

Monotonically increasing nonce included in the request signature.

Headers

Idempotency-Key

string<uuid>

required

Client-generated canonical UUIDv4 that uniquely identifies a request for safe retries.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

account_id

string

required

Globally unique public identifier for an account.

Required string length: 14 - 42

Body

application/json

Source amount
Destination amount

Provide from.amount to specify how much to debit. Omit to.amount; the service calculates the amount delivered to the destination.

from

OnDemandConversionBalanceSource · object

required

Source side of an on-demand conversion.

OnDemandConversionBalanceSource
OnDemandConversionBankSource

Show child attributes

to

OnDemandConversionWalletDestination · object

required

Destination side of an on-demand conversion.

OnDemandConversionWalletDestination
OnDemandConversionBankDestination

Show child attributes

Response

On-demand conversion created.

data

object

required

Details of an on-demand conversion. It includes the amount debited from the source, the amount delivered to the destination, the exchange rate, destination details, and fees. Transaction references are included when available. A linked bank source remains pending while funding is in progress. An RfP conversion includes next_action while its payer must authorize the payment. A wallet destination may include a saved memo or tag; when present, those fields are returned in every response.

Show child attributes