POST fx/internal/quote

The POST Internal Quote endpoint provides the ability to transfer cross-currency fiat (transfer from a U.S. dollar account into a foreign currency account and vice versa) between owned Silvergate accounts. A subscription must have FX Trade Execution permission on the debit account and at least view only access to the credit account to execute upon this.

Get started with the fx/internal/quote endpoint and select the appropriate Accept header for the request. The fx/internal/quote endpoint has two Accept header types from which to choose from:

Internal Quote

application/vnd.silvergate.internalquote+json (or application/vnd.silvergate.internalquote.hateoas+json for links)

This Accept header can be used to review exchange market prices.

The response returned will include the exchange rate for the currency pair selected as well as the information needed to execute upon the quote using the POST Internal Trade endpoint.

Internal Market Order

application/vnd.silvergate.internalmarketorder+json (or application/vnd.silvergate.internalmarketorder.hateoas+json for links)

This Accept header can be used to execute an Internal FX Trade at the current market price.

The response returned will include the contract id (trade id) for the agreement of currency exchange with Silvergate and the payment id which can be used to track the movement of funds.

POST fx/internal/trade

The POST fx/internal/trade endpoint provides the ability to accept the quote received in an Internal Quote request. A valid fx/internal/quote id must be provided to execute the trade. Valid quote IDs cannot be:

Indicative

Indicative quotes are informative only. Refer to the “is_indicative” and “indicative_reason” fields from the fx/internal/quote response to determine if your “quote_id” is valid.

Expired

Each internal quote response includes a “quote_expiration”. If the current date/time exceeds the “quote_expiration”, the “quote_id” becomes invalid.

Previously used, or

A unique “quote_id” is required for each POST fx/internal/trade request.

From the fx/quote endpoint

Only quotes received from the fx/internal/quote endpoint are valid.

application/vnd.silvergate.internaltradeexecution+json or else application/vnd.silvergate.internaltradeexecution.hateoas+json to get Hateoas links.

The response returned will include the contract id (trade id) for the agreement of currency exchange with Silvergate and the payment id which can be used to track the movement of funds.