Skip to main content

Spot Rate records over given interval

Provides spot price movement over a defined interval, together with information on the products offered and system variables. When defining parameters, note that this works in the concept of querying for [Spot price of gold in {currency} for the last {qtyIntervals} x {intervalSize}{interval}].

Query Parameters
interval int32

Possible values: [minute, hour, day, week, month, second]

Time intervals, expressed in minutes. Integer value represents the member's equivalent number of minutes (except for Month (-1) and Year (-2).

Determines the interval between spots we are concerned with.

qtyIntervals int32

Number of most-recent Intervals that we will like to query on.

currency string

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

intervalSize int32

The gap between each intervals. (e.g. X minutes, X hours, X days). This field will be ignored if 'intervals' was selected as [month] or [second].

Responses
200

Success

Schema
spots object
xau object[]

Array of spot records for Gold

metalCode string

The ISO-4271 Alphabetical 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 rate determined by Silver Bullion, which in-turn determines the sellback and purchase rate used.

sellback double

The rate that will be used when performing a sellback to Silver Bullion.

purchase double

The rate that will be used when performing a purchase from Silver Bullion.

fx double

The exchange rate of the currency to USD. (i.e. 1USD = $(fx)(current currency)

xag object[]

Array of spot records for Silver

metalCode string

The ISO-4271 Alphabetical 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 rate determined by Silver Bullion, which in-turn determines the sellback and purchase rate used.

sellback double

The rate that will be used when performing a sellback to Silver Bullion.

purchase double

The rate that will be used when performing a purchase from Silver Bullion.

fx double

The exchange rate of the currency to USD. (i.e. 1USD = $(fx)(current currency)

xpt object[]

Array of spot records for Platinum

metalCode string

The ISO-4271 Alphabetical 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 rate determined by Silver Bullion, which in-turn determines the sellback and purchase rate used.

sellback double

The rate that will be used when performing a sellback to Silver Bullion.

purchase double

The rate that will be used when performing a purchase from Silver Bullion.

fx double

The exchange rate of the currency to USD. (i.e. 1USD = $(fx)(current currency)

variables object
fxToBase double

The exchange rate as compared to the system's base currency (e.g. for $1 of the queried currency, how much of the base currency is needed for the same value)

lockTokenExpiry int32

The maximum amount of time in seconds that a quotation remains \'Valid\'.

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],[IntervalQuantityOutOfValidRange] and [IntervalSizeOutOfValidRange]

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.