Skip to main content

Latest spot rate record

Provides the latest spot price for metals, together with the token that will be required for making sale operations.

Query Parameters
currency string

The fiat currency that we want to query for metal prices in (e.g. SGD). Defaults to system defined base currency(SGD) if not provided.

search string

Filters the type of metals to be displayed based on their ISO-4271 codes (e.g. XAU). If multiple metals are required, use the _ delimiter to perform the search. If no value is provided, all available metals will be displayed.

Responses
200

Successful

Schema
spots object
xau object

The latest spot record for Gold

encSpotToken string

The token to be provided for referencing "this" spot-record

expiry date-time

The time where this record will expires. (Time shown is in UTC)

metalCode string

The ISO-4271 Alpha-3 Code of the Precious Metal (e.g. XAG, XAU, XPT)

asOfTime date-time

The as-of time for the spot record. The time displayed is shared across different metals, and is reflected in SGT.

currency string

The ISO-4271(alpha-3) Currency code of the currency for the spot record

spot double

The spot value, rounded to 8 decimal places.

sellback double

The rate used when performing a sellback to us, rounded to 4 decimal places.

purchase double

The rate used when purchasing from us, rounded to 4 decimal places.

fx double

The conversion rate from 1 USD to 'this' currency.

xag object

The latest spot record for Silver

encSpotToken string

The token to be provided for referencing "this" spot-record

expiry date-time

The time where this record will expires. (Time shown is in UTC)

metalCode string

The ISO-4271 Alpha-3 Code of the Precious Metal (e.g. XAG, XAU, XPT)

asOfTime date-time

The as-of time for the spot record. The time displayed is shared across different metals, and is reflected in SGT.

currency string

The ISO-4271(alpha-3) Currency code of the currency for the spot record

spot double

The spot value, rounded to 8 decimal places.

sellback double

The rate used when performing a sellback to us, rounded to 4 decimal places.

purchase double

The rate used when purchasing from us, rounded to 4 decimal places.

fx double

The conversion rate from 1 USD to 'this' currency.

xpt object

The latest spot record for Platinum

encSpotToken string

The token to be provided for referencing "this" spot-record

expiry date-time

The time where this record will expires. (Time shown is in UTC)

metalCode string

The ISO-4271 Alpha-3 Code of the Precious Metal (e.g. XAG, XAU, XPT)

asOfTime date-time

The as-of time for the spot record. The time displayed is shared across different metals, and is reflected in SGT.

currency string

The ISO-4271(alpha-3) Currency code of the currency for the spot record

spot double

The spot value, rounded to 8 decimal places.

sellback double

The rate used when performing a sellback to us, rounded to 4 decimal places.

purchase double

The rate used when purchasing from us, rounded to 4 decimal places.

fx double

The conversion rate from 1 USD to 'this' currency.

variables object
market string

The market status, used to indicate whether the market is open or closed.

400

Failed to retrieve spot records due to a validation error.

Schema
errors object[]

Provides specific details about the errors encountered and on which underlying records. Shown only for validation done on business levels. (invalid inputs are not reflected through this field/object)

errorCode string

A brief set of characters that describe the error. Valid values include [UnsupportedCurrency] and [SearchTermsContainsInvalidMetal]

errorMessage string

A human readable version of what went wrong during the validation process.

recordIdentifierName string

The name of the identifier (known to the caller) which will be used to display the errorneous records relating to this error.

records undefined[]

The list of transaction identifiers (mentioned in [recordIdentifierName] that had a hit with this error.

errorCount integer

The number of failing points which caused the call to be rejected.

type url

A URI reference that identifies the problem type as detailed in RFC-3896 (https://www.rfc-editor.org/rfc/rfc3986). When dereferenced, it provide human-readable documentation for the problem

title string

Short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence.

status number

The advisory status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem. This is the same status code returned from this API call.

detail string

By convention, this should provide a human-readable explanation specific to this occurrence of the problem and ought to focus on helping the client correct the problem, rather than giving debugging information. In the event there are seveal errors, a reference to another field will be made.

instance string

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

traceId string

Used mainly for error tracing purposes.