### Get Available Coins - OpenAPI Specification Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/coins/coins This OpenAPI specification defines the GET /v1/coins endpoint, which retrieves a list of available coins for exchange. It includes details on request parameters, successful responses (200) with coin details, and error responses (403, 500). The specification also defines the data structures for coin responses and error messages. ```yaml openapi: 3.0.0 info: title: OpenAPI Plant Store description: '' license: name: MIT version: 1.0.0 servers: - url: https://api.letsexchange.io/api security: - bearerAuth: [] paths: /v1/coins: get: description: > This returns the list of coins available for exchange with the selected coin at a given time or sends the entire list of coins. The response also contains parameters such as the “extra ID”, if applicable for a specific cryptocurrency, for example, the Destination Tag for XRP (XRP). In addition, the response provides icon links. parameters: - in: query name: partner_user_ip schema: description: End user IP address example: 127.0.0.1 type: string responses: '200': description: Coins response content: application/json: schema: type: array items: $ref: '#/components/schemas/CoinResponse' '403': description: Wrong API key in Bearer token content: application/json: schema: $ref: '#/components/schemas/WrongAPITokenError' example: error: Wrong number of segments '500': description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: Internal error components: schemas: CoinResponse: type: object properties: code: description: Coin short name (code) example: ETH-BEP20 type: string name: description: Currency full name example: Ethereum type: string network_code: description: Coin network code example: BEP20 type: string network_name: description: Coin network name example: Binance Smart Chain (BEP20) type: string default_network_code: description: Coin default network code example: ETH type: string default_network_name: description: Coin default network name example: Ethereum type: string disabled: description: >- The availability of the coins. `0` - available, `1` - unavailable **[DEPRECATED]** example: 1 type: number is_active: description: The availability of the coins. `1` - available, `0` - unavailable example: 1 type: number icon: description: The link to the coin logo example: >- https://letsexchange.s3.eu-central-1.amazonaws.com/coins/23d9818d338b43e692dddf6455c0d197.svg type: string has_extra: description: >- `1` f the coin has an extra ID in addition to the address, `0` if it doesn’t example: 1 type: number extra_name: description: Name of the extra ID example: MEMO nullable: true type: string additional_info_get: description: Additional info for a coin to get example: >- Due to network requirements, the exchange will be processed after 500 confirmations of your deposit transaction. type: string additional_info_send: description: Additional info for a coin to send example: >- Please note that token has migrated to the new Binance Chain contact address type: string explorer: description: >- Cryptocurrency blockchain explorer URL is used to check transaction status in a block explorer example: https://pacific-explorer.manta.network/ type: string contract_address: description: Contract address example: '0x2170ed0880ac9a755fd29b2688956bd959f933f8' type: string WrongAPITokenError: required: - error type: object properties: error: type: string Error: required: - success - error type: object properties: success: type: boolean error: type: string securitySchemes: bearerAuth: type: http scheme: bearer ``` -------------------------------- ### Get a List of Coins V2 Source: https://api-doc.letsexchange.io/api-reference/endpoint/v2/coins/coins Fetches the list of coins available for exchange, including their networks, extra ID applicability, and icon links. ```APIDOC ## GET /coins/list ### Description Fetches the list of coins available for exchange with a selected coin at a given time or the entire list of coins. Each coin entry contains an array of networks. The response also contains parameters such as the “extra ID”, if applicable for a specific cryptocurrency, for example, the Destination Tag for XRP (XRP). In addition, the response provides icon links. ### Method GET ### Endpoint /coins/list ### Parameters #### Query Parameters - **currency** (string) - Optional - The currency to filter the list by. ### Request Example ``` GET /coins/list?currency=BTC ``` ### Response #### Success Response (200) - **coins** (array) - An array of coin objects. - **id** (string) - The unique identifier for the coin. - **name** (string) - The name of the coin. - **iconUrl** (string) - The URL of the coin's icon. - **networks** (array) - An array of network objects available for the coin. - **name** (string) - The name of the network. - **ticker** (string) - The ticker symbol for the network. - **extraIDName** (string) - The name of the extra ID field, if applicable. - **extraID** (boolean) - Indicates if an extra ID is required for this network. #### Response Example ```json { "coins": [ { "id": "btc", "name": "Bitcoin", "iconUrl": "https://example.com/icons/btc.png", "networks": [ { "name": "Bitcoin", "ticker": "BTC", "extraIDName": null, "extraID": false } ] }, { "id": "xrp", "name": "XRP", "iconUrl": "https://example.com/icons/xrp.png", "networks": [ { "name": "XRP Ledger", "ticker": "XRP", "extraIDName": "Destination Tag", "extraID": true } ] } ] } ``` ``` -------------------------------- ### Get Coins List Source: https://api-doc.letsexchange.io/documentation/swap-flow Fetches a list of available cryptocurrencies. This is a prerequisite for calculating rates and creating exchanges. Pay attention to the `is_active` property to ensure you select active coins. ```APIDOC ## GET /api/v2/coins ### Description Fetches a list of all available cryptocurrencies supported by the LetsExchange API. This list is essential for identifying potential trading pairs. ### Method GET ### Endpoint /api/v2/coins ### Parameters #### Query Parameters - **is_active** (integer) - Optional - Filters the list to include only active cryptocurrencies (1 for active, 0 for inactive). ### Request Example ```json { "example": "No request body needed for GET request." } ``` ### Response #### Success Response (200) - **coins** (array) - A list of cryptocurrency objects, each containing details like name, symbol, and activation status. - **id** (integer) - The unique identifier for the coin. - **name** (string) - The full name of the cryptocurrency. - **symbol** (string) - The trading symbol for the cryptocurrency. - **is_active** (integer) - Indicates if the coin is currently active for trading (1) or not (0). #### Response Example ```json { "example": [ { "id": 1, "name": "Bitcoin", "symbol": "BTC", "is_active": 1 }, { "id": 2, "name": "Ethereum", "symbol": "ETH", "is_active": 1 } ] } ``` ``` -------------------------------- ### Get Transaction Info Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/transaction/get-transaction Fetches detailed information about a specific transaction. Includes the current rate offered by LetsExchange, which may differ from the market rate. ```APIDOC ## GET /transactions/{transactionId} ### Description Fetches detailed information about a specific transaction. The response includes the current rate offered by LetsExchange, which may differ from the market rate and change rapidly depending on market conditions. ### Method GET ### Endpoint /transactions/{transactionId} ### Parameters #### Path Parameters - **transactionId** (string) - Required - The unique identifier of the transaction. #### Query Parameters None #### Request Body None ### Request Example None ### Response #### Success Response (200) - **transactionId** (string) - The unique identifier of the transaction. - **status** (string) - The current status of the transaction (e.g., 'completed', 'pending'). - **rate** (number) - The current exchange rate offered by LetsExchange for this transaction. - **amount_from** (number) - The amount sent by the user. - **amount_to** (number) - The estimated amount to be received by the user. - **currency_from** (string) - The currency being sent. - **currency_to** (string) - The currency being received. #### Response Example ```json { "transactionId": "tx_12345abcde", "status": "completed", "rate": 0.00005678, "amount_from": 1.0, "amount_to": 0.00005678, "currency_from": "BTC", "currency_to": "ETH" } ``` ``` -------------------------------- ### Get Coin Info Bulk - OpenAPI Specification Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/coins/info-bulk This OpenAPI 3.0.0 specification defines the 'POST /v1/info/bulk' endpoint for fetching cryptocurrency information in bulk. It includes request body schemas for specifying coins, affiliate ID, and float rate, as well as response schemas for successful retrieval and various error conditions. ```yaml openapi: 3.0.0 info: title: OpenAPI Plant Store description: '' license: name: MIT version: 1.0.0 servers: - url: https://api.letsexchange.io/api security: - bearerAuth: [] paths: /v1/info/bulk: post: requestBody: description: '' content: application/json: schema: $ref: '#/components/schemas/CoinInfoBulkRequest' required: true responses: '200': description: Coin Info Bulk response content: application/json: schema: type: array items: $ref: '#/components/schemas/CoinInfoRevertResponse' '403': description: Wrong API key in Bearer token content: application/json: schema: $ref: '#/components/schemas/WrongAPITokenError' example: error: Wrong number of segments '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: validation: coins: The coins field is required. '500': description: unexpected error content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: Internal error components: schemas: CoinInfoBulkRequest: required: - float - affiliate_id - coins type: object properties: float: description: Is float rate example: true type: boolean affiliate_id: description: Affiliate ID example: q1W2e3R4tEXAMPLE type: string partner_user_ip: description: End user IP address example: 127.0.0.1 nullable: true type: string coins: description: >- You will get coins rates with pairs from intersections between that list. **The limit is 50 coins per query.** example: - BTC - USDT - ETH type: array items: type: string CoinInfoRevertResponse: type: object properties: min_amount: description: The minimum possible amount to be sent example: '0.002' type: string max_amount: description: The maximum possible amount to be sent example: '27000' type: string amount: description: >- The amount a user must send to receive the amount from the `amount` request example: '1725.45941279' type: string fee: description: Service fee (in destination currency) **[DEPRECATED]** example: '0' type: string rate: description: The current exchange rate offered by LetsExchange example: '0.000290844400000' type: string profit: description: If a promo code was used, a bonus value in BTC example: '13' nullable: true type: string withdrawal_fee: description: The withdrawal fee is specified in the currency a user gets. example: '5.90634362' type: string rate_id: description: Rate identifier for a FIXED rate flow example: 646006ec-c1c7-482e-acb6-682e7674fd7e nullable: true type: string rate_id_expired_at: description: The timestamp (in milliseconds) when the received rate will expire example: '1719396641906' nullable: true type: string WrongAPITokenError: required: - error type: object properties: error: type: string Error: required: - success - error type: object properties: success: type: boolean error: type: string securitySchemes: bearerAuth: type: http scheme: bearer ``` -------------------------------- ### Get DEX Coins List Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/transaction/dex/coins Fetches the list of coins available for DEX swaps. The response includes coin details, potential extra IDs (like XRP's Destination Tag), and icon links. ```APIDOC ## GET /v1/dex/coins ### Description This endpoint returns the list of coins available for DEX swap. The response also contains parameters such as the “extra ID”, if applicable for a specific cryptocurrency, for example, the Destination Tag for XRP (XRP). In addition, the response provides icon links. ### Method GET ### Endpoint /v1/dex/coins ### Parameters #### Query Parameters - **partner_user_ip** (string) - Optional - End user IP address ### Request Example ```json { "partner_user_ip": "127.0.0.1" } ``` ### Response #### Success Response (200) - **code** (string) - Coin short name (code) - **name** (string) - Currency full name - **icon** (string) - The link to the coin logo - **networks** (array) - List of networks the coin is available on - **uuid** (string) - Unique network ID - **name** (string) - Network name - **code** (string) - Network code - **icon** (string) - The link to the network logo - **background_color** (string) - Network background color - **color** (string) - Network text color - **chain_id** (string) - Network chain id - **contract_address** (string) - Contract address - **smart_contract_explorer_url** (string) - Blockchain explorer URL is used to check transaction status in a block explorer - **validation_address_regex** (string) - Validation address regex #### Error Response (403) - **error** (string) - Error message (e.g., "Wrong API key in Bearer token") #### Error Response (500) - **success** (boolean) - Indicates if the request was successful - **error** (string) - Error message (e.g., "Internal error") #### Response Example (200) ```json [ { "code": "USDC", "name": "USDC", "icon": "https://images.letsexchange.io/coins/cce0373d3721efb48fb7ced57e26f6d6.svg", "networks": [ { "uuid": "783211cb-60c2-4ae4-8a16-761f9fa9b2c9", "name": "Ethereum Network", "code": "ERC20", "icon": "https://images.letsexchange.io/coins/cce0373d3721efb48fb7ced57e26f6d6.svg", "background_color": "#e5ebff", "color": "#4d67cb", "chain_id": "1", "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "smart_contract_explorer_url": "https://etherscan.io/address/", "validation_address_regex": "^(0x)[0-9A-Fa-f]{40}$" } ] } ] ``` #### Response Example (403) ```json { "error": "Wrong number of segments" } ``` #### Response Example (500) ```json { "success": false, "error": "Internal error" } ``` ``` -------------------------------- ### Get a List of Coins Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/coins/coins Retrieves the list of coins available for exchange. The response includes details like 'extra ID' requirements and icon links. ```APIDOC ## GET /coins ### Description Fetches the list of coins available for exchange. This endpoint can return coins relevant to a selected coin or the entire list of supported coins. The response includes cryptocurrency-specific details such as the 'extra ID' (e.g., Destination Tag for XRP) and links to coin icons. ### Method GET ### Endpoint /coins ### Parameters #### Query Parameters - **paired_coin** (string) - Optional - The coin to filter the exchange list by. ### Request Example ```json { "example": "GET /coins?paired_coin=BTC" } ``` ### Response #### Success Response (200) - **id** (string) - The unique identifier for the coin. - **name** (string) - The name of the coin. - **icon_url** (string) - The URL for the coin's icon. - **has_extra_id** (boolean) - Indicates if the coin requires an extra ID. - **extra_id_name** (string) - The name of the extra ID field, if applicable. #### Response Example ```json { "example": [ { "id": "BTC", "name": "Bitcoin", "icon_url": "https://example.com/icons/btc.png", "has_extra_id": false }, { "id": "XRP", "name": "Ripple", "icon_url": "https://example.com/icons/xrp.png", "has_extra_id": true, "extra_id_name": "Destination Tag" } ] } ``` ``` -------------------------------- ### Get Coin Bridge Info Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/coins/bridge/info Fetches the current exchange rate for a crypto bridge between two specified networks. It also calculates the final amount a user will receive and provides the minimum and maximum deposit amounts. ```APIDOC ## GET /coins/bridge/info ### Description Retrieves the current rate for a crypto bridge across two specific networks, calculates the final amount that the user will receive, and provides minimum and maximum deposit amounts. ### Method GET ### Endpoint /coins/bridge/info ### Parameters #### Query Parameters - **from_network** (string) - Required - The network from which the cryptocurrency is being sent. - **to_network** (string) - Required - The network to which the cryptocurrency is being sent. - **from_coin** (string) - Required - The cryptocurrency being sent. - **to_coin** (string) - Required - The cryptocurrency being received. ### Request Example ``` GET /coins/bridge/info?from_network=ethereum&to_network=bsc&from_coin=ETH&to_coin=BNB ``` ### Response #### Success Response (200) - **rate** (number) - The current exchange rate for the bridge. - **estimated_amount** (number) - The calculated final amount the user will receive. - **min_deposit** (number) - The minimum deposit amount allowed. - **max_deposit** (number) - The maximum deposit amount allowed. #### Response Example ```json { "rate": 0.05, "estimated_amount": 95.0, "min_deposit": 10.0, "max_deposit": 10000.0 } ``` ``` -------------------------------- ### GET /v2/transactions-list Source: https://api-doc.letsexchange.io/api-reference/endpoint/v2/transaction/get-transactions-list Retrieves a paginated list of transactions with filtering options for date ranges. ```APIDOC ## GET /v2/transactions-list ### Description It returns detailed information about transactions. [API Version 2] ### Method GET ### Endpoint /v2/transactions-list ### Parameters #### Query Parameters - **page** (integer) - Optional - Page number for pagination. Example: 1 - **limit** (integer) - Optional - Number of elements per page. Example: 10 - **start_date** (integer) - Optional - Start date filter. Example: 1757404910 - **end_date** (integer) - Optional - End date filter. Example: 1757405520 ### Request Example ```json { "example": "No request body for GET request" } ``` ### Response #### Success Response (200) - **current_page** (integer) - The current page number. - **data** (array) - An array of transaction objects. - **from** (integer) - The starting item number for the current page. - **last_page** (integer) - The total number of pages. - **next_page_url** (string) - URL for the next page, or null if it's the last page. - **path** (string) - The base URL path for the transaction list. - **per_page** (integer) - The number of items per page. - **prev_page_url** (string) - URL for the previous page, or null if it's the first page. - **to** (integer) - The ending item number for the current page. - **total** (integer) - The total number of transactions. #### Response Example ```json { "current_page": 1, "data": [ { "created_at": "2025-02-05 18:52:46", "status": "wait", "transaction_id": "5bb44a4d99cd5", "coin_from": "BTC", "coin_from_name": "Bitcoin", "coin_from_network": "BTC", "coin_from_chain_id": null, "coin_from_icon": "https://images.letsexchange.io/coins/6dfa9838b46e464c1c27446f6e7b4b64.svg", "coin_from_explorer_url": "https://blockchair.com/bitcoin/transaction/", "coin_from_additional_get_info": "Due to network requirements, the exchange will be processed after 500 confirmations of your deposit transaction." } ], "from": 1, "last_page": 118, "next_page_url": "https://api.letsexchange.io/api/v2/transactions-list?page=2", "path": "https://api.letsexchange.io/api/v2/transactions-list", "per_page": 50, "prev_page_url": null, "to": 50, "total": 5867 } ``` #### Error Responses - **403**: Wrong API key in Bearer token. Example: `{"error": "Wrong number of segments"}` - **500**: Unexpected error. Example: `{"success": false, "error": "Internal error"}` ``` -------------------------------- ### LetsExchange API Introduction Source: https://api-doc.letsexchange.io/api-reference/introduction Provides an overview of the LetsExchange API, including base URL, version differences, and important notes on coin codes, Extra IDs, and request headers. ```APIDOC ## Introduction to LetsExchange API ### Base URL `https://api.letsexchange.io/api` ### API Versions - **API ver. 1**: Displays a list of cryptocurrencies in the form of coin codes and networks. - **API ver. 2**: Displays an aggregated list of cryptocurrencies containing a list of networks for each specific coin. (Recommended) ### Important Notes #### Coin Codes - Parameters like `coin_from` or `coin_to` require coin tickets in uppercase (e.g., BTC, ETH, XMR). #### Security - All requests must be made using HTTPS. #### Extra ID - An optional field for addresses that require an additional identifier for transaction processing (e.g., XRP's "Destination Tag", Monero's "Payment ID", Stellar's "Memo"). - This parameter should only be included if the coin necessitates it. ### Request Headers For each request, the following headers must be used: ```json { "Content-Type": "application/json", "Accept": "application/json" } ``` ``` -------------------------------- ### POST /v1/info/bulk Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/coins/info-bulk Retrieves bulk coin information including rates, limits, and fees for a specified list of coins. Requires an API key for authentication. ```APIDOC ## POST /v1/info/bulk ### Description Retrieves bulk coin information including rates, limits, and fees for a specified list of coins. Requires an API key for authentication. ### Method POST ### Endpoint https://api.letsexchange.io/api/v1/info/bulk ### Parameters #### Query Parameters - **float** (boolean) - Required - Specifies whether to use float rates. - **affiliate_id** (string) - Required - Your affiliate ID. - **partner_user_ip** (string) - Optional - The end user's IP address. - **coins** (array of strings) - Required - A list of coins (up to 50 per query) for which to retrieve information. #### Request Body This endpoint does not use a request body. Parameters are passed as query parameters. ### Request Example ```bash curl -X POST "https://api.letsexchange.io/api/v1/info/bulk?float=true&affiliate_id=q1W2e3R4tEXAMPLE&coins[]=BTC&coins[]=USDT&coins[]=ETH" -H "Authorization: Bearer YOUR_API_KEY" ``` ### Response #### Success Response (200) - **min_amount** (string) - The minimum possible amount to be sent. - **max_amount** (string) - The maximum possible amount to be sent. - **amount** (string) - The amount a user must send to receive the amount from the `amount` request. - **fee** (string) - Service fee (in destination currency) **[DEPRECATED]**. - **rate** (string) - The current exchange rate offered by LetsExchange. - **profit** (string) - If a promo code was used, a bonus value in BTC. - **withdrawal_fee** (string) - The withdrawal fee is specified in the currency a user gets. - **rate_id** (string) - Rate identifier for a FIXED rate flow. - **rate_id_expired_at** (string) - The timestamp (in milliseconds) when the received rate will expire. #### Response Example ```json [ { "min_amount": "0.002", "max_amount": "27000", "amount": "1725.45941279", "fee": "0", "rate": "0.000290844400000", "profit": null, "withdrawal_fee": "5.90634362", "rate_id": "646006ec-c1c7-482e-acb6-682e7674fd7e", "rate_id_expired_at": "1719396641906" } ] ``` #### Error Responses - **403 Forbidden**: Wrong API key in Bearer token. ```json { "error": "Wrong number of segments" } ``` - **422 Unprocessable Entity**: Unprocessable Entity. ```json { "success": false, "error": { "validation": { "coins": "The coins field is required." } } } ``` - **500 Internal Server Error**: Unexpected error. ```json { "success": false, "error": "Internal error" } ``` ``` -------------------------------- ### Get DEX Coins List - OpenAPI Specification Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/transaction/dex/coins This OpenAPI specification defines the GET /v1/dex/coins endpoint, which retrieves a list of coins available for DEX swaps. The response includes coin details, network information, and icon links. It also specifies error responses for invalid API keys and internal server errors. ```yaml openapi: 3.0.0 info: title: OpenAPI Plant Store description: '' license: name: MIT version: 1.0.0 servers: - url: https://api.letsexchange.io/api security: - bearerAuth: [] paths: /v1/dex/coins: get: description: > This returns the list of coins available for DEX swap. The response also contains parameters such as the “extra ID”, if applicable for a specific cryptocurrency, for example, the Destination Tag for XRP (XRP). In addition, the response provides icon links. parameters: - in: query name: partner_user_ip schema: description: End user IP address example: 127.0.0.1 type: string responses: '200': description: DEX Coins response content: application/json: schema: type: array items: $ref: '#/components/schemas/DEXCoinResponse' '403': description: Wrong API key in Bearer token content: application/json: schema: $ref: '#/components/schemas/WrongAPITokenError' example: error: Wrong number of segments '500': description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: Internal error components: schemas: DEXCoinResponse: type: object properties: code: description: Coin short name (code) example: USDC type: string name: description: Currency full name example: USDC type: string icon: description: The link to the coin logo example: >- https://images.letsexchange.io/coins/cce0373d3721efb48fb7ced57e26f6d6.svg type: string networks: type: array items: type: object properties: uuid: description: Unique network ID example: 783211cb-60c2-4ae4-8a16-761f9fa9b2c9 type: string name: description: Network name example: Ethereum Network type: string code: description: Network code example: ERC20 type: string icon: description: The link to the network logo example: >- https://images.letsexchange.io/coins/cce0373d3721efb48fb7ced57e26f6d6.svg nullable: true type: string background_color: description: Network background color example: '#e5ebff' type: string color: description: Network text color example: '#4d67cb' type: string chain_id: description: Network chain id example: '1' type: string contract_address: description: Contract address example: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' type: string smart_contract_explorer_url: description: >- Blockchain explorer URL is used to check transaction status in a block explorer example: https://etherscan.io/address/ type: string validation_address_regex: description: Validation address regex example: ^(0x)[0-9A-Fa-f]{40}$ type: string WrongAPITokenError: required: - error type: object properties: error: type: string Error: required: - success - error type: object properties: success: type: boolean error: type: string securitySchemes: bearerAuth: type: http scheme: bearer ``` -------------------------------- ### Documentation Index Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/transaction/get-transactions-list Fetches the complete documentation index, which lists all available API documentation pages. ```APIDOC ## GET /llms.txt ### Description Fetches the complete documentation index. Use this file to discover all available API documentation pages before exploring further. ### Method GET ### Endpoint /llms.txt ### Parameters None ### Request Example ``` GET https://api-doc.letsexchange.io/llms.txt ``` ### Response #### Success Response (200) - **documentation_index** (string) - A text file containing links to all available documentation pages. #### Response Example ``` https://api-doc.letsexchange.io/transactions.html https://api-doc.letsexchange.io/users.html ``` ``` -------------------------------- ### Get Transaction Status OpenAPI Specification Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/transaction/get-transaction-status This OpenAPI specification defines the GET /v1/transaction/{id}/status endpoint. It allows clients to retrieve the current status of a transaction by providing its unique ID. The response includes the transaction status as a string, with potential error responses for invalid API keys, not found transactions, or internal server errors. ```yaml openapi: 3.0.0 info: title: OpenAPI Plant Store description: '' license: name: MIT version: 1.0.0 servers: - url: https://api.letsexchange.io/api security: - bearerAuth: [] paths: /v1/transaction/{id}/status: get: description: Allows the current status of the transaction to be checked as a string. parameters: - in: path name: id schema: description: Unique identifier for transaction assigned by letsexchange.io example: 599cd4bb4d4a5 type: string required: true responses: '200': description: Get Transaction Status response content: application/json: schema: $ref: '#/components/schemas/GetTransactionStatusResponse' '403': description: Wrong API key in Bearer token content: application/json: schema: $ref: '#/components/schemas/WrongAPITokenError' example: error: Wrong number of segments '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: Transaction not found '500': description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: Internal error components: schemas: GetTransactionStatusResponse: type: string description: >- Transaction status is used to notify user about progress of the exchange process. [See *transaction statuses for detailed description](/documentation/statuses) example: success WrongAPITokenError: required: - error type: object properties: error: type: string Error: required: - success - error type: object properties: success: type: boolean error: type: string securitySchemes: bearerAuth: type: http scheme: bearer ``` -------------------------------- ### Initiate Bridge Transaction (OpenAPI) Source: https://api-doc.letsexchange.io/api-reference/endpoint/v1/transaction/bridge/create-transaction This OpenAPI definition describes the POST /v1/bridge/transaction endpoint. It allows users to initiate a cryptocurrency swap by specifying the token, networks, amounts, and withdrawal addresses. The response includes deposit details, fees, and other relevant parameters. It also details various error responses for invalid requests or server issues. ```yaml openapi: 3.0.0 info: title: OpenAPI Plant Store description: '' license: name: MIT version: 1.0.0 servers: - url: https://api.letsexchange.io/api security: - bearerAuth: [] paths: /v1/bridge/transaction: post: description: >- This call allows you to initiate a swap in bridge mode. You choose a token, the networks between which the token will move, provide the sender’s withdrawal address and specify the amount of crypto you want to swap. [Letsexchange.io](https://letsexchange.io) returns the deposit address, extra ID (if needed), final amount, fee, and other parameters. **To receive an affiliate fee from a transaction, the API query must include the following parameter: `affiliate_id`.** requestBody: description: '' content: application/json: schema: $ref: '#/components/schemas/CreateBridgeTransactionRequest' required: true responses: '200': description: Create Bridge Transaction response content: application/json: schema: $ref: '#/components/schemas/CreateBridgeTransactionResponse' '403': description: Wrong API key in Bearer token content: application/json: schema: $ref: '#/components/schemas/WrongAPITokenError' example: error: Wrong number of segments '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: Rate is not available for this pair. '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: validation: withdrawal_extra_id: The withdrawal extra id field must be present. '500': description: unexpected error content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false error: Internal error components: schemas: CreateBridgeTransactionRequest: required: - coin - network_from - network_to - deposit_amount - withdrawal - withdrawal_extra_id - affiliate_id type: object properties: coin: description: Coin code to swap example: BTC type: string network_from: description: Code for a cryptocurrency network of a coin a user will send example: BTC type: string network_to: description: Code for a cryptocurrency network of a coin to get example: TRC20 type: string deposit_amount: description: The amount of coins to be exchanged is specified by a user example: 0.01 type: number withdrawal: description: >- The destination address. LetsExchange will send the exchanged coins to this address example: TR7NHqjeKQxGTCi8q8ZY4txxxSzgjLj6t type: string withdrawal_extra_id: description: >- Additional ID for destination wallet addresses for currencies that use extra ID for transaction processing. The field should be empty if an extra ID is not provided for a given cryptocurrency. **A request without this field is not allowed.** example: '' type: string return: description: >- A user's address he sent coins from or another one that may be used as a refund address if it is necessary example: bc1qxygdygjrs2kzq2n0qtyrf2111pxxxxxxxwl0h nullable: true type: string return_extra_id: description: >- An extra ID for a user's address he sent coins from or another one that may be used as a refund address if it is necessary example: '' nullable: true type: string rate_id: description: 'Rate identifier for a FIXED `{float: false}` rate flow' example: n4142vs2-5a55-11a3-344a-0b17163 type: string promocode: description: Is a transaction with a promo code example: promocodeExample nullable: true type: string email: description: User email example: example@gmail.com nullable: true type: string affiliate_id: description: Affiliate ID ``` -------------------------------- ### Get Transactions List Info V2 Source: https://api-doc.letsexchange.io/api-reference/endpoint/v2/transaction/get-transactions-list Fetches detailed information about transactions using API Version 2. ```APIDOC ## GET /transactions/list/v2 ### Description Returns detailed information about transactions. [API Version 2] ### Method GET ### Endpoint /transactions/list/v2 ### Parameters #### Query Parameters - **limit** (integer) - Optional - The maximum number of transactions to return. - **offset** (integer) - Optional - The number of transactions to skip before starting to collect the result set. - **sort** (string) - Optional - The field to sort the transactions by (e.g., 'date', 'amount'). - **order** (string) - Optional - The order of sorting ('asc' or 'desc'). ### Request Example ``` GET /transactions/list/v2?limit=10&offset=0&sort=date&order=desc ``` ### Response #### Success Response (200) - **transactions** (array) - A list of transaction objects. - **id** (string) - The unique identifier for the transaction. - **date** (string) - The date and time the transaction occurred. - **amount** (number) - The amount of the transaction. - **currency** (string) - The currency of the transaction. - **type** (string) - The type of transaction (e.g., 'deposit', 'withdrawal'). - **status** (string) - The status of the transaction (e.g., 'completed', 'pending'). #### Response Example ```json { "transactions": [ { "id": "txn_12345", "date": "2023-10-27T10:00:00Z", "amount": 100.50, "currency": "USD", "type": "deposit", "status": "completed" }, { "id": "txn_67890", "date": "2023-10-26T15:30:00Z", "amount": 50.00, "currency": "EUR", "type": "withdrawal", "status": "pending" } ] } ``` ```