List Conversions

curl "https://sandbox-api.tender.cash/v1/api/conversions?page=1&limit=10&status=completed" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>"

{
  "status": "success",
  "message": "success",
  "data": {
    "conversion": {
      "data": [
        {
          "_id": "66aec7de809b7f45c42a49f9",
          "type": "crypto",
          "status": "completed",
          "amount": 100,
          "usdAmount": 100,
          "rate": 0.006667,
          "fee": 0.5,
          "feeUSD": 0.5,
          "chain": { "id": "ethereum", "name": "Ethereum", "chainType": "evm" },
          "currency": { "id": "usdt", "name": "Tether USD", "symbol": "USDT" },
          "swapChain": { "id": "solana", "name": "Solana", "chainType": "sol" },
          "swapCurrency": { "id": "sol", "name": "Solana", "symbol": "SOL" },
          "convertedAmount": 0.6633,
          "swappedAmount": 0.6621,
          "destinationCrypto": { "chain": "solana", "coin": "sol", "address": "7xKX...9fQ" },
          "initiatedVia": "api",
          "processingStages": {
            "sendForConversion": { "status": "completed" },
            "conversionState": { "status": "completed" },
            "settleCrypto": { "status": "completed" }
          },
          "createdAt": "2026-10-15T09:20:15.650Z",
          "updatedAt": "2026-10-15T09:31:02.114Z"
        }
      ],
      "pages": 1,
      "page": 1,
      "limit": 10
    },
    "history": { "today": 100, "allTime": 12840.5, "count": 42, "pending": 2 }
  }
}

GET

api

conversions

curl "https://sandbox-api.tender.cash/v1/api/conversions?page=1&limit=10&status=completed" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>"

{
  "status": "success",
  "message": "success",
  "data": {
    "conversion": {
      "data": [
        {
          "_id": "66aec7de809b7f45c42a49f9",
          "type": "crypto",
          "status": "completed",
          "amount": 100,
          "usdAmount": 100,
          "rate": 0.006667,
          "fee": 0.5,
          "feeUSD": 0.5,
          "chain": { "id": "ethereum", "name": "Ethereum", "chainType": "evm" },
          "currency": { "id": "usdt", "name": "Tether USD", "symbol": "USDT" },
          "swapChain": { "id": "solana", "name": "Solana", "chainType": "sol" },
          "swapCurrency": { "id": "sol", "name": "Solana", "symbol": "SOL" },
          "convertedAmount": 0.6633,
          "swappedAmount": 0.6621,
          "destinationCrypto": { "chain": "solana", "coin": "sol", "address": "7xKX...9fQ" },
          "initiatedVia": "api",
          "processingStages": {
            "sendForConversion": { "status": "completed" },
            "conversionState": { "status": "completed" },
            "settleCrypto": { "status": "completed" }
          },
          "createdAt": "2026-10-15T09:20:15.650Z",
          "updatedAt": "2026-10-15T09:31:02.114Z"
        }
      ],
      "pages": 1,
      "page": 1,
      "limit": 10
    },
    "history": { "today": 100, "allTime": 12840.5, "count": 42, "pending": 2 }
  }
}

Auth method: Signed (HMAC) — this endpoint requires the full set of signed headers: x-access-id, x-request-id, x-timestamp, and an HMAC-SHA256 authorization signature. See Authentication.

All conversion endpoints share a bucket of 10 requests per minute per merchant, on top of the general limit. Polling counts against it. See Rate limits.

Headers

string

required

Base64-encoded HMAC-SHA256 signature of {"timeStamp":"<x-timestamp>","requestId":"<x-request-id>","accessId":"<x-access-id>"}, signed with your access secret. The request body is not part of the signature.Example: "pV3n0o8kq0lK2mJ8bZ1yq3Yt6hR0cXK9u4mVJ2l9sE0="

string

required

ISO 8601 timestamp; must be within 5 minutes of server timeExample: "2026-10-15T09:45:53.000Z"

string

required

A unique UUID v4 per requestExample: "550e8400-e29b-41d4-a716-446655440000"

string

required

Your API access ID provided by TenderExample: "your-access-id-here"

Query parameters

number

required

Page number, starting at 1. There is no default; always send it.Example: 1

number

required

Number of records per page. There is no default; always send it.Example: 10

string

Filter by conversion status. Passing pending returns both pending and processing records.Allowed values: pending, processing, completed, failedExample: "completed"

string

Filter by conversion type.Allowed values: crypto, fiatExample: "fiat"

string

Start of a createdAt date range (ISO 8601). Only applied when to is also sent.Example: "2026-10-01T00:00:00.000Z"

string

End of a createdAt date range (ISO 8601). Only applied when from is also sent.Example: "2026-10-15T23:59:59.999Z"

string

Case-insensitive search across the transaction ID, status, and the bank account name, bank name and account number of fiat conversions.Example: "kuda"

Send only the query parameters listed above.

Response

string

required

success on successExample: "success"

string

required

Human-readable result messageExample: "success"

object

required

Paginated conversions and aggregate totals

Show data properties

object

Paginated list of conversions, newest first

Show conversion properties

array

Array of conversion objects

Show conversion object

string

Conversion IDExample: "66aec7de809b7f45c42a49f9"

string

crypto (swap to another coin or chain) or fiat (sent to a payout account)Example: "crypto"

string

One of pending, processing, completed, failedExample: "completed"

number

Source amount, in the source coinExample: 100

number

Source amount in USD at creationExample: 100

number

Destination units per USD (after fees) used to price the conversionExample: 0.006667

number

Conversion fee, in the source coinExample: 0.5

number

Conversion fee in USDExample: 0.5

object

Source chain. Includes id, name, icon and chainType.Example: { "id": "ethereum", "name": "Ethereum", "chainType": "evm" }

object

Source coin. Includes id, name, symbol and icon.Example: { "id": "usdt", "name": "Tether USD", "symbol": "USDT" }

object

Destination chain. For fiat conversions its id is fiat.Example: { "id": "solana", "name": "Solana", "chainType": "sol" }

object

Destination coin, or the fiat currency for fiat conversionsExample: { "id": "sol", "name": "Solana", "symbol": "SOL" }

number

Amount obtained from the conversion step, in the destination coin. Set once that step completes.Example: 0.6633

number

Amount delivered to the destination after network and provider fees. Set at settlement.Example: 0.6621

number

Fiat amount paid out (fiat conversions only). Set at settlement.Example: 152340.5

object

Bank details of the payout account (fiat conversions only): currency, accountName, accountNumber, bankName.Example: { "currency": "ngn", "accountName": "Ada Obi", "accountNumber": "0123456789", "bankName": "KUDA MICROFINANCE BANK" }

object

Crypto destination: chain, coin and address. Present for crypto conversions and for fiat conversions to a crypto payout account.Example: { "chain": "solana", "coin": "sol", "address": "7xKX...9fQ" }

string

Why the conversion failed. Present only when status is failed.Example: "Destination address rejected"

string

Where the conversion was created: api, dashboard, admin or auto-payoutExample: "api"

object

Status of each processing stage. See Get Conversion for the status values.

Show processingStages properties

object

Example: { "status": "completed" }

object

Example: { "status": "completed" }

object

Example: { "status": "completed" }

object

Present only for fiat conversions.Example: { "status": "processed" }

string

ISO 8601 timestampExample: "2026-10-15T09:20:15.650Z"

string

ISO 8601 timestampExample: "2026-10-15T09:31:02.114Z"

number

Total number of pagesExample: 3

number

Current pageExample: 1

number

Items per pageExample: 10

object

Totals across all your pending, processing and completed conversions. These ignore the query filters.

Show history properties

number

USD value of conversions created todayExample: 250

number

USD value of all conversionsExample: 12840.5

number

Number of conversionsExample: 42

number

Number of conversions that are pending or processingExample: 2

Additional fields may be present; ignore fields you don’t recognise.

curl "https://sandbox-api.tender.cash/v1/api/conversions?page=1&limit=10&status=completed" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>"

{
  "status": "success",
  "message": "success",
  "data": {
    "conversion": {
      "data": [
        {
          "_id": "66aec7de809b7f45c42a49f9",
          "type": "crypto",
          "status": "completed",
          "amount": 100,
          "usdAmount": 100,
          "rate": 0.006667,
          "fee": 0.5,
          "feeUSD": 0.5,
          "chain": { "id": "ethereum", "name": "Ethereum", "chainType": "evm" },
          "currency": { "id": "usdt", "name": "Tether USD", "symbol": "USDT" },
          "swapChain": { "id": "solana", "name": "Solana", "chainType": "sol" },
          "swapCurrency": { "id": "sol", "name": "Solana", "symbol": "SOL" },
          "convertedAmount": 0.6633,
          "swappedAmount": 0.6621,
          "destinationCrypto": { "chain": "solana", "coin": "sol", "address": "7xKX...9fQ" },
          "initiatedVia": "api",
          "processingStages": {
            "sendForConversion": { "status": "completed" },
            "conversionState": { "status": "completed" },
            "settleCrypto": { "status": "completed" }
          },
          "createdAt": "2026-10-15T09:20:15.650Z",
          "updatedAt": "2026-10-15T09:31:02.114Z"
        }
      ],
      "pages": 1,
      "page": 1,
      "limit": 10
    },
    "history": { "today": 100, "allTime": 12840.5, "count": 42, "pending": 2 }
  }
}

Authorizations

authorization

string

header

required

Signed (HMAC) authentication. Required headers: x-access-id, x-request-id (UUID v4), x-timestamp (ISO 8601, must be within 5 minutes of server time), and authorization: the Base64 HMAC-SHA256 of the JSON string {"timeStamp":"","requestId":"","accessId":""} (keys in that order, no whitespace) using your access secret. The request body, method and path are not signed. The API key must be linked to an outlet.

Headers

authorization

string

required

x-timestamp

string<date-time>

required

ISO 8601 timestamp; must be within 5 minutes of server time

x-request-id

string<uuid>

required

A unique UUID v4 per request

x-access-id

string

required

Query Parameters

page

integer

required

Page number, starting at 1

Required range: x >= 1

limit

integer

required

Records per page

Required range: x >= 1

status

enum<string>

pending also matches processing

Available options:

pending,

processing,

completed,

failed

type

enum<string>

Conversion type

Available options:

crypto,

fiat

from

string<date-time>

Start of createdAt range; needs to

string<date-time>

End of createdAt range; needs from

string

Searches transaction ID, status and bank details

Response

Conversions

status

string

required

Example:

"success"

message

string

required

Example:

"success"

data

object

required

Show child attributes

Payment

System

Agents

Conversions

Payouts

Subwallets

Webhooks

On-ramp

Headers

Query parameters

Response

Authorizations

Headers

Query Parameters

Response

​Headers

​Query parameters

​Response

Authorizations

Headers

Query Parameters

Response

Headers

Query parameters

Response