> ## Documentation Index > Fetch the complete documentation index at: https://docs.tender.cash/llms.txt > Use this file to discover all available pages before exploring further. # Conversion Stats > Count your conversions: total, pending and created today > [!NOTE] > > **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](/api-reference/authentication.md#signed-hmac-authentication). All conversion endpoints share a bucket of 10 requests per minute per merchant, on top of the general limit. See [Rate limits](/api-reference/rate-limits.md). ## Headers **authorization** `string` *required* Base64-encoded HMAC-SHA256 signature of `{"timeStamp":"","requestId":"","accessId":""}`, signed with your access secret. The request body is not part of the signature. **Example:** `"pV3n0o8kq0lK2mJ8bZ1yq3Yt6hR0cXK9u4mVJ2l9sE0="` **x-timestamp** `string` *required* ISO 8601 timestamp; must be within 5 minutes of server time **Example:** `"2026-10-15T09:45:53.000Z"` **x-request-id** `string` *required* A unique UUID v4 per request **Example:** `"550e8400-e29b-41d4-a716-446655440000"` **x-access-id** `string` *required* Your API access ID provided by Tender **Example:** `"your-access-id-here"` ## Query parameters **from** `string` Start of a `createdAt` date range (ISO 8601). Only applied when `to` is also sent. **Example:** `"2026-10-01T00:00:00.000Z"` **to** `string` End of a `createdAt` date range (ISO 8601). Only applied when `from` is also sent. **Example:** `"2026-10-15T23:59:59.999Z"` **search** `string` Case-insensitive search across the transaction ID, status, and the bank account name, bank name and account number of fiat conversions. **Example:** `"completed"` ## Response **status** `string` *required* `success` on success **Example:** `"success"` **message** `string` *required* Human-readable result message **Example:** `"success"` **data** `object` *required* Conversion counts for your merchant account, after applying the filters **data properties** **total** `number` Number of conversions matching the filters **Example:** `42` **pending** `number` Number of matching conversions whose status is exactly `pending` (not `processing`) **Example:** `2` **todayConversion** `number` Number of matching conversions created today (server time) **Example:** `3` ```bash cURL theme={null} curl "https://sandbox-api.tender.cash/v1/api/conversions/stats" \ -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: " ``` ```json 200 theme={null} { "status": "success", "message": "success", "data": { "total": 42, "pending": 2, "todayConversion": 3 } } ``` ## OpenAPI ````yaml GET /v1/api/conversions/stats openapi: 3.1.0 info: title: Tender API description: Tender Developer API for cryptocurrency payments and agent management version: 2.0.0 contact: name: Tender Support url: https://tender.cash servers: - url: https://secureapi.tender.cash description: Production Server - url: https://sandbox-api.tender.cash description: Sandbox Server security: - SignedAuth: [] tags: - name: Agents description: Manage agents and sub-businesses - name: Transactions description: Payment and transaction operations - name: System description: System information and configuration - name: Webhooks description: Webhook management and logs - name: On-ramp description: Fiat-to-crypto on-ramp operations - name: Payouts description: Send crypto from merchant balance to a wallet address or payout account - name: Subwallets description: Provision and manage crypto wallet infrastructure for your end-users - name: Conversions description: Swap crypto between coins and chains, or convert to a payout account paths: /v1/api/conversions/stats: get: tags: - Conversions summary: Conversion Stats description: >- Counts of your conversions: total, pending (status exactly `pending`) and created today. Conversion endpoints share a 10 requests/minute bucket per merchant. operationId: getConversionStats parameters: - name: authorization in: header required: true description: >- Base64-encoded HMAC-SHA256 signature of `{"timeStamp":"","requestId":"","accessId":""}`, signed with your access secret. The request body is not part of the signature. schema: type: string example: pV3n0o8kq0lK2mJ8bZ1yq3Yt6hR0cXK9u4mVJ2l9sE0= - name: x-timestamp in: header required: true description: ISO 8601 timestamp; must be within 5 minutes of server time schema: type: string format: date-time example: '2026-10-15T09:45:53.000Z' - name: x-request-id in: header required: true description: A unique UUID v4 per request schema: type: string format: uuid example: 550e8400-e29b-41d4-a716-446655440000 - name: x-access-id in: header required: true schema: type: string example: your-access-id-here - name: from in: query required: false description: Start of createdAt range; needs `to` schema: type: string format: date-time example: '2026-10-01T00:00:00.000Z' - name: to in: query required: false description: End of createdAt range; needs `from` schema: type: string format: date-time example: '2026-10-15T23:59:59.999Z' - name: search in: query required: false description: Searches transaction ID, status and bank details schema: type: string example: completed responses: '200': description: Stats content: application/json: schema: $ref: '#/components/schemas/ConversionStatsResponse' example: status: success message: success data: total: 42 pending: 2 todayConversion: 3 '400': description: Request failed content: application/json: schema: $ref: '#/components/schemas/ConversionPayoutErrorResponse' example: status: error message: Bad request data: {} '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ConversionPayoutErrorResponse' example: status: error message: Too many requests. Max 10 per 60s. data: {} security: - SignedAuth: [] components: schemas: ConversionStatsResponse: type: object required: - status - message - data properties: status: type: string example: success message: type: string example: success data: type: object properties: total: type: integer pending: type: integer description: Status exactly pending todayConversion: type: integer ConversionPayoutErrorResponse: type: object properties: status: type: string example: error message: type: string data: type: object nullable: true securitySchemes: SignedAuth: type: apiKey in: header name: authorization description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.