Overview

The Get Status of a Crypto Sell Order API provides the current status and detailed information about a specific crypto-to-fiat sell order. This API allows merchants to track the progress of a transaction, helping to keep users informed and ensure transparency.

Endpoint

URL: https://mudrex.com/api/v1/wallet/conversion/fiat/transaction/{transaction_id}
Method: GET

Request Headers

Header	Description
`X-Timestamp`	UNIX timestamp for the request.
`X-Client-Id`	Unique identifier for the merchant.
`X-Request-Id`	A unique identifier for the request (optional but recommended).
`X-Secret-Key`	API secret key for authenticating the request.
`X-User-Id`	The unique ID of the user making the request.

Sample Request

curl --location 'https://mudrex.com/api/v1/wallet/conversion/fiat/transaction/a892dc4a-aecb-4a22-9de4-2990b4179b77' \
--header 'X-Timestamp: 1732265171' \
--header 'X-Client-Id: CLIENT_ID_HERE' \
--header 'X-Request-Id: CC' \
--header 'X-Secret-Key: SECRET_KEY_HERE' \
--header 'X-User-Id: USER_ID_HERE'

Sample Response

{
  "success": true,
  "data": {
    "exchange_rate": 82.56976,
    "crypto_amount": 1.14,
    "fiat_symbol": "INR",
    "failure_code": null,
    "failure_desc": null,
    "crypto_symbol": "USDT",
    "status": "COMPLETED",
    "fiat_amount": 100,
    "id": "a892dc4a-aecb-4a22-9de4-2990b4179b77",
    "created_at": "2022-10-03 07:51:15",
    "transaction_type": "SELL",
    "bank_transaction_id": "227617569022",
    "source_id": "65d246fc-6a5b-43d7-89bf-944e95ff2279"
  }
}

Key Response Fields

Field	Description	Example Value
`exchange_rate`	The conversion rate used for the transaction.	`82.56976`
`crypto_amount`	The amount of cryptocurrency sold.	`1.14`
`fiat_symbol`	The fiat currency involved in the transaction.	`INR`
`failure_code`	Error code if the transaction failed (null if successful).	`null`
`failure_desc`	Description of the failure reason (null if successful).	`null`
`crypto_symbol`	The cryptocurrency involved in the transaction.	`USDT`
`status`	Current status of the transaction.	`COMPLETED`
`fiat_amount`	The amount of fiat currency received.	`100`
`id`	Unique identifier for the transaction.	`a892dc4a-aecb-4a22-9de4-2990b4179b77`
`created_at`	Timestamp when the transaction was created.	`2022-10-03 07:51:15`
`transaction_type`	Type of transaction (`SELL`).	`SELL`
`bank_transaction_id`	Bank reference ID for the fiat transfer.	`227617569022`
`source_id`	Unique identifier for the transaction source.	`65d246fc-6a5b-43d7-89bf-944e95ff2279`

Use Cases

Transaction Tracking:
- Monitor the status of a specific sell transaction to ensure its completion.
User Notifications:
- Use the transaction status to notify users about the progress or completion of their orders.
Error Investigation:
- Fetch failure codes and descriptions to identify and resolve transaction issues.

Important Notes

Real-Time Status:
- Use this API to fetch the most up-to-date information about a sell transaction.
Error Handling:
- If failure_code or failure_desc is populated, investigate the issue based on the returned details.

This API is crucial for providing transparency and improving user confidence in the on-ramp and off-ramp process. For further details, refer to the here.