menu

Executable Rates Guide

TxB APIs allows TxB clients to make FX payments as described on the Make a Payment Guide. Additionally, this guide describes how to lock in an exchange rate before actually sending the payment. This can be useful if you want to display a proposed FX rate to your customer before committing them to accepting the rate, or do a bulk purchase of your FX that can be allocated to multiple underlying payments. All exchange rates described below are spot transactions (T+2). Rates are only available during market opening and are valid for 90 seconds.

Step by Step Guide

Step 1 - Create an exchange rate quote

First, create a quote. This quote is real-time (it changes throughout the day) and includes all relevant FX fees that you have agreed with TxB. The payment using the FX will likely generate additional fees When creating a quote, you must specify the payment amount, which is the amount of the currency you want to send as payment.

To create a quote, POST /v2/exchangeRates/quotes with the following payload:

{
  "fxTrade": {
    "paymentCurrency": "EUR", // The currency you want to convert to
    "sourceCurrency": "USD", // The currency you will convert from
    "paymentAmount": 1000
  },
  "liquidityTiming": {
    "tenor": "90_SECONDS"
  }
}

Returns this response:

{
    "quoteId": "Q7471",
    "tradeId": null,
    "status": "QUOTED",
    "relatedEntityId": null,
    "expirationTime": "2023-02-21T20:46:23.162Z",
    "liquidityTiming": {
        "settlementDate": null,
        "tenor": "90_SECONDS"
    },
    "fxTrade": {
        "paymentAmount": 1000.00,
        "paymentCurrency": "EUR",
        "sourceCurrency": "USD",
        "sourceAmount": 1066.29,
        "fxRate": 1.06628522,
        "fxTimeStamp": null
    },
    "fxTradeUsage": null,
    "fxQuoteUsage": null
}

Step 2 - Decide whether to accept the rate

Now that you created a quote, you can:

  1. Book a trade against the quote by accepting it within 90 seconds
  2. Walk away and leave the quote to expire
  3. Request a new quote

If you decide to accept the quote, you have up to 2 business days to make a payment(s) on that trade.

To accept the quote, POST /v2/exchangeRates/quotes/accept

{
  "quoteId": "Q7471"
}

Returns this response:

{
    "quoteId": "Q7471",
    "tradeId": "271130",
    "status": "TRADED",
    "relatedEntityId": null,
    "expirationTime": null,
    "liquidityTiming": {
        "settlementDate":2023-02-23,
        "tenor": null
   },
    "fxTrade": {
        "paymentAmount": 1000.00,
        "paymentCurrency": "EUR",
        "sourceCurrency": "USD",
        "sourceAmount": 1066.29,
        "fxRate": 1.06628500,
        "fxTimeStamp": null
    },
    "fxTradeUsage": {
        "paymentAmountAvailable": 1000.00,
        "sourceAmountAvailable": 1066.29,
        "linkedPaymentEndToEndIds": null
    },
    "fxQuoteUsage": null
}

At this point, the currency is now TRADED. Canceling the trade would involve booking an equal and opposite trade which may create a financial loss if rates have changed in an unfavorable direction.


Step 3 - View the current status of the quote or trade

Use this API to get information about your trade. This API will help you know the details of your trade, including trade status, how much of your trade has been utilized and what payments are associated with it. It will help you ensure that the data you cache in your system about your trade is always accurate.

Request quote details by: POST /v2/exchangeRates/quotes/status

{
  "idType": "TRADEID",
  "idValue": "271130"
} 

Returns this response:

{
    "quoteId": "Q7471",
    "tradeId": "271130",
    "status": "TRADED",
    "relatedEntityId": null,
    "expirationTime": null,
    "liquidityTiming": {
        "settlementDate":2023-02-23,
        "tenor": null
   },
    "fxTrade": {
        "paymentAmount": 1000.00,
        "paymentCurrency": "EUR",
        "sourceCurrency": "USD",
        "sourceAmount": 1066.29,
        "fxRate": 1.06628500,
        "fxTimeStamp": null
    },
    "fxTradeUsage": {
        "paymentAmountAvailable": 1000.00,
        "sourceAmountAvailable": 1066.29,
        "linkedPaymentEndToEndIds": []
    },
    "fxQuoteUsage": null
}

Step 4 - Use your currency

You have two business days to use your newly purchased currency to make a payment.
You can use the entire amount in one payment or divide it across multiple payments. Any currency that is unused after two days will be unwound. An unwind may create a financial loss if rates have changed in an unfavorable direction.

To make a payment, include the tradeId in your request. Your payment amount should not exceed the total trade amount.

To initiate your payment, POST /v2/payments/payouts

{
    "paymentRequestId": "US_004535424",
    "requestLevel": {
        "fundingSource": {
            "fundingAccount": {
                "accountInfo": {
                    "accountHolderName": "Client11",
                    "accountIdentifier": {
                        "accountNumber": "290000069300"
                    },
                    "bankIdentifier": {
                        "bic": "GSCRUS30XXX"
                    }
                }
            },
            "fundingCurrency": "USD"
        },
        "routingPreferences": {
            "paymentTypePreference": "WIRE"
        }
    },
    "payouts": [
        {
            "paymentEndToEndId": "EUR_031434",
            "corePayoutInfo": {
                "requestedPaymentDate": "2023-02-21",
                "paymentCurrency": "EUR",
                "amount": 100.00,
                "payeeAccount": {
                    "accountInfo": {
                        "accountHolderName": "Creditor Acc",
                        "accountIdentifier": {
                            "iban": "GB46BUKB20041538290008"
                        },
                        "bankIdentifier": {
                            "bic": "BUKBGB22"
                        },
                        "address": {
                            "addressLines": [
                                "15",
                                "Broad Avenue"
                            ],
                            "city": "Amsterdam",
                            "countryISOCode": "NL",
                            "postalCode": "1011 AA"
                        }
                    }
                },
                "messagesFromOriginator": {
                    "paymentPurpose": "WIRE TEST-EUR",
                    "remittanceInfo": {
                        "unstructuredRemittance": [
                            "WIRE TEST-EUR"
                        ]
                    }
                }
            },
            "routingSpecificPayoutInfo": {
                "wirePayoutLevel": {
                    "chargeBearer": "SLEV"
                }
            },
            "otherPayoutInfo": {
                "fxPayoutLevel": {
                    "amountType": "PAYMENT",
                    "tradeId": "271130"
                }
            }
        }
    ]
}

For a successful payment request, you will get the response:

{
    "paymentRequestId": "004535424",
    "collectionRequestId": null,
    "requestStatus": "ACCEPTED",
    "message": null
}

Once you’ve initiated a payment, review the status of your trade again to see how much currency you have left to use. Use POST /v2/exchangeRates/quotes/status as mentioned in Step 3 above to get the Trade details.

Frequently Asked Questions

QuestionAnswer
When I accept my quote, the status shows PENDING, not QUOTED. How come?If you receive the status PENDING, poll the Get Trade details API from Step 3 (POST /v2/exchangeRates/quotes/status) until status shows TRADED.
PENDING status simply means that we haven’t booked the trade yet.
Is there a separate payment date?Once you accept a quote and receive a Trade Id, you have 2 business days to instruct payments. This deadline is expressed as settlementDate in your quote acceptance response.
Is there a difference between payment value date and deal settlement date?The payment date is when the payment is settled. The deal settlement date is the date by which you should initiate the payment. Payments can be made up to T+2 days once you accept a quote.
What happens when the settlementDate is passed and no payments are sent?You have up to T+2 to instruct payments using POST /v2/payments/payouts from Step 4. Once T+2 has passed, our Operations team will initiate an unwind process with you. This is a manual process that we will manage and support you through. However, these breaks are not common.
Can you support weekend trading?Currently, we do not support presenting quotes over the weekend. Our executable rates product is only available during open market hours. Any trade submitted after 5pm ET on Friday will be rejected. Please discuss extending the offering to weekends with your TxB representative. We offer a held rates product which will allow you to provide quotes over the weekend.
Can I use the same trade across multiple unassociated legal entities?We do not support settlement across multiple entities. We currently only support settlement for a single client, within a single branch.

GS DAP® is owned and operated by Goldman Sachs. This site is for informational purposes only and does not constitute an offer to provide, or the solicitation of an offer to provide access to or use of GS DAP®. Any subsequent commitment by Goldman Sachs to provide access to and / or use of GS DAP® would be subject to various conditions, including, amongst others, (i) satisfactory determination and legal review of the structure of any potential product or activity, (ii) receipt of all internal and external approvals (including potentially regulatory approvals); (iii) execution of any relevant documentation in a form satisfactory to Goldman Sachs; and (iv) completion of any relevant system / technology / platform build or adaptation required or desired to support the structure of any potential product or activity. All GS DAP® features may not be available in certain jurisdictions. Not all features of GS DAP® will apply to all use cases. Use of terms (e.g., "account") on GS DAP® are for convenience only and does not imply any regulatory or legal status by such term.

¹ Real-time data can be impacted by planned system maintenance, connectivity or availability issues stemming from related third-party service providers, or other intermittent or unplanned technology issues.

Transaction Banking services are offered by Goldman Sachs Bank USA ("GS Bank") and its affiliates. GS Bank is a New York State chartered bank, a member of the Federal Reserve System and a Member FDIC. For additional information, please see Bank Regulatory Information.

Certain solutions and Institutional Services described herein are provided via our Marquee platform. The Marquee platform is for institutional and professional clients only. This site is for informational purposes only and does not constitute an offer to provide the Marquee platform services described, nor an offer to sell, or the solicitation of an offer to buy, any security. Some of the services and products described herein may not be available in certain jurisdictions or to certain types of clients. Please contact your Goldman Sachs sales representative with any questions. Any data or market information presented on the site is solely for illustrative purposes. There is no representation that any transaction can or could have been effected on such terms or at such prices. Please see https://www.goldmansachs.com/disclaimer/sec-div-disclaimers-for-electronic-comms.html for additional information.

² Source: Goldman Sachs Asset Management, as of March 31, 2025.

Mosaic is a service mark of Goldman Sachs & Co. LLC. This service is made available in the United States by Goldman Sachs & Co. LLC and outside of the United States by Goldman Sachs International, or its local affiliates in accordance with applicable law and regulations. Goldman Sachs International and Goldman Sachs & Co. LLC are the distributors of the Goldman Sachs Funds. Depending upon the jurisdiction in which you are located, transactions in non-Goldman Sachs money market funds are affected by either Goldman Sachs & Co. LLC, a member of FINRA, SIPC and NYSE, or Goldman Sachs International. For additional information contact your Goldman Sachs representative. Goldman Sachs & Co. LLC, Goldman Sachs International, Goldman Sachs Liquidity Solutions, Goldman Sachs Asset Management, L.P., and the Goldman Sachs funds available through Goldman Sachs Liquidity Solutions and other affiliated entities, are under the common control of the Goldman Sachs Group, Inc.

Goldman Sachs & Co. LLC is a registered U.S. broker-dealer and futures commission merchant, and is subject to regulatory capital requirements including those imposed by the SEC, the U.S. Commodity Futures Trading Commission (CFTC), the Chicago Mercantile Exchange, the Financial Industry Regulatory Authority, Inc. and the National Futures Association.

FOR INSTITUTIONAL USE ONLY - NOT FOR USE AND/OR DISTRIBUTION TO RETAIL AND THE GENERAL PUBLIC.

This material is for informational purposes only. It is not an offer or solicitation to buy or sell any securities.

THIS MATERIAL DOES NOT CONSTITUTE AN OFFER OR SOLICITATION IN ANY JURISDICTION WHERE OR TO ANY PERSON TO WHOM IT WOULD BE UNAUTHORIZED OR UNLAWFUL TO DO SO. Prospective investors should inform themselves as to any applicable legal requirements and taxation and exchange control regulations in the countries of their citizenship, residence or domicile which might be relevant. This material is provided for informational purposes only and should not be construed as investment advice or an offer or solicitation to buy or sell securities. This material is not intended to be used as a general guide to investing, or as a source of any specific investment recommendations, and makes no implied or express recommendations concerning the manner in which any client's account should or would be handled, as appropriate investment strategies depend upon the client's investment objectives.

United Kingdom: In the United Kingdom, this material is a financial promotion and has been approved by Goldman Sachs Asset Management International, which is authorized and regulated in the United Kingdom by the Financial Conduct Authority.

European Economic Area (EEA): This marketing communication is disseminated by Goldman Sachs Asset Management B.V., including through its branches ("GSAM BV"). GSAM BV is authorised and regulated by the Dutch Authority for the Financial Markets (Autoriteit Financiële Markten, Vijzelgracht 50, 1017 HS Amsterdam, The Netherlands) as an alternative investment fund manager ("AIFM") as well as a manager of undertakings for collective investment in transferable securities ("UCITS"). Under its licence as an AIFM, the Manager is authorized to provide the investment services of (i) reception and transmission of orders in financial instruments; (ii) portfolio management; and (iii) investment advice. Under its licence as a manager of UCITS, the Manager is authorized to provide the investment services of (i) portfolio management; and (ii) investment advice.

Information about investor rights and collective redress mechanisms are available on www.gsam.com/responsible-investing (section Policies & Governance). Capital is at risk. Any claims arising out of or in connection with the terms and conditions of this disclaimer are governed by Dutch law.

To the extent it relates to custody activities, this financial promotion is disseminated by Goldman Sachs Bank Europe SE ("GSBE"), including through its authorised branches. GSBE is a credit institution incorporated in Germany and, within the Single Supervisory Mechanism established between those Member States of the European Union whose official currency is the Euro, subject to direct prudential supervision by the European Central Bank (Sonnemannstrasse 20, 60314 Frankfurt am Main, Germany) and in other respects supervised by German Federal Financial Supervisory Authority (Bundesanstalt für Finanzdienstleistungsaufsicht, BaFin) (Graurheindorfer Straße 108, 53117 Bonn, Germany; website: www.bafin.de) and Deutsche Bundesbank (Hauptverwaltung Frankfurt, Taunusanlage 5, 60329 Frankfurt am Main, Germany).

Switzerland: For Qualified Investor use only - Not for distribution to general public. This is marketing material. This document is provided to you by Goldman Sachs Bank AG, Zürich. Any future contractual relationships will be entered into with affiliates of Goldman Sachs Bank AG, which are domiciled outside of Switzerland. We would like to remind you that foreign (Non-Swiss) legal and regulatory systems may not provide the same level of protection in relation to client confidentiality and data protection as offered to you by Swiss law.

Asia excluding Japan: Please note that neither Goldman Sachs Asset Management (Hong Kong) Limited ("GSAMHK") or Goldman Sachs Asset Management (Singapore) Pte. Ltd. (Company Number: 201329851H ) ("GSAMS") nor any other entities involved in the Goldman Sachs Asset Management business that provide this material and information maintain any licenses, authorizations or registrations in Asia (other than Japan), except that it conducts businesses (subject to applicable local regulations) in and from the following jurisdictions: Hong Kong, Singapore, India and China. This material has been issued for use in or from Hong Kong by Goldman Sachs Asset Management (Hong Kong) Limited and in or from Singapore by Goldman Sachs Asset Management (Singapore) Pte. Ltd. (Company Number: 201329851H).

Australia: This material is distributed by Goldman Sachs Asset Management Australia Pty Ltd ABN 41 006 099 681, AFSL 228948 (‘GSAMA’) and is intended for viewing only by wholesale clients for the purposes of section 761G of the Corporations Act 2001 (Cth). This document may not be distributed to retail clients in Australia (as that term is defined in the Corporations Act 2001 (Cth)) or to the general public. This document may not be reproduced or distributed to any person without the prior consent of GSAMA. To the extent that this document contains any statement which may be considered to be financial product advice in Australia under the Corporations Act 2001 (Cth), that advice is intended to be given to the intended recipient of this document only, being a wholesale client for the purposes of the Corporations Act 2001 (Cth). Any advice provided in this document is provided by either of the following entities. They are exempt from the requirement to hold an Australian financial services licence under the Corporations Act of Australia and therefore do not hold any Australian Financial Services Licences, and are regulated under their respective laws applicable to their jurisdictions, which differ from Australian laws. Any financial services given to any person by these entities by distributing this document in Australia are provided to such persons pursuant to the respective ASIC Class Orders and ASIC Instrument mentioned below.

  • Goldman Sachs Asset Management, LP (GSAMLP), Goldman Sachs & Co. LLC (GSCo), pursuant ASIC Class Order 03/1100; regulated by the US Securities and Exchange Commission under US laws.
  • Goldman Sachs Asset Management International (GSAMI), Goldman Sachs International (GSI), pursuant to ASIC Class Order 03/1099; regulated by the Financial Conduct Authority; GSI is also authorized by the Prudential Regulation Authority, and both entities are under UK laws.
  • Goldman Sachs Asset Management (Singapore) Pte. Ltd. (GSAMS), pursuant to ASIC Class Order 03/1102; regulated by the Monetary Authority of Singapore under Singaporean laws
  • Goldman Sachs Asset Management (Hong Kong) Limited (GSAMHK), pursuant to ASIC Class Order 03/1103 and Goldman Sachs (Asia) LLC (GSALLC), pursuant to ASIC Instrument 04/0250; regulated by the Securities and Futures Commission of Hong Kong under Hong Kong laws

No offer to acquire any interest in a fund or a financial product is being made to you in this document. If the interests or financial products do become available in the future, the offer may be arranged by GSAMA in accordance with section 911A(2)(b) of the Corporations Act. GSAMA holds Australian Financial Services Licence No. 228948. Any offer will only be made in circumstances where disclosure is not required under Part 6D.2 of the Corporations Act or a product disclosure statement is not required to be given under Part 7.9 of the Corporations Act (as relevant).

FOR DISTRIBUTION ONLY TO FINANCIAL INSTITUTIONS, FINANCIAL SERVICES LICENSEES AND THEIR ADVISERS. NOT FOR VIEWING BY RETAIL CLIENTS OR MEMBERS OF THE GENERAL PUBLIC

Canada: This presentation has been communicated in Canada by GSAM LP, which is registered as a portfolio manager under securities legislation in all provinces of Canada and as a commodity trading manager under the commodity futures legislation of Ontario and as a derivatives adviser under the derivatives legislation of Quebec. GSAM LP is not registered to provide investment advisory or portfolio management services in respect of exchange-traded futures or options contracts in Manitoba and is not offering to provide such investment advisory or portfolio management services in Manitoba by delivery of this material.

Japan: This material has been issued or approved in Japan for the use of professional investors defined in Article 2 paragraph (31) of the Financial Instruments and Exchange Law ("FIEL"). Also, any description regarding investment strategies on or funds as collective investment scheme under Article 2 paragraph (2) item 5 or item 6 of FIEL has been approved only for Qualified Institutional Investors defined in Article 10 of Cabinet Office Ordinance of Definitions under Article 2 of FIEL.

Interest Rate Benchmark Transition Risks: This transaction may require payments or calculations to be made by reference to a benchmark rate ("Benchmark"), which will likely soon stop being published and be replaced by an alternative rate, or will be subject to substantial reform. These changes could have unpredictable and material consequences to the value, price, cost and/or performance of this transaction in the future and create material economic mismatches if you are using this transaction for hedging or similar purposes. Goldman Sachs may also have rights to exercise discretion to determine a replacement rate for the Benchmark for this transaction, including any price or other adjustments to account for differences between the replacement rate and the Benchmark, and the replacement rate and any adjustments we select may be inconsistent with, or contrary to, your interests or positions. Other material risks related to Benchmark reform can be found at https://www.gs.com/interest-rate-benchmark-transition-notice. Goldman Sachs cannot provide any assurances as to the materialization, consequences, or likely costs or expenses associated with any of the changes or risks arising from Benchmark reform, though they may be material. You are encouraged to seek independent legal, financial, tax, accounting, regulatory, or other appropriate advice on how changes to the Benchmark could impact this transaction.

Confidentiality: No part of this material may, without GSAM's prior written consent, be (i) copied, photocopied or duplicated in any form, by any means, or (ii) distributed to any person that is not an employee, officer, director, or authorized agent of the recipient.

GSAM Services Private Limited (formerly Goldman Sachs Asset Management (India) Private Limited) acts as the Investment Advisor, providing non-binding non-discretionary investment advice to dedicated offshore mandates, involving Indian and overseas securities, managed by GSAM entities based outside India. Members of the India team do not participate in the investment decision making process.

© 2025 Goldman Sachs. All rights reserved.