Skip to main content
Servix Iran market data API
Documentation menu

Market Data Explorer guide

Use the Market Data Explorer and export Excel or JSON

Learn how to select assets, confirm one quota unit, interpret Market Data Explorer fields, and download the loaded result as Excel or JSON without another request.

This guide covers the authenticated Market Data Explorer in the Servix customer panel. It is intended for interactive review and export; programmatic applications should continue to use the authenticated assets API with an API key kept on their server.

Before you begin

  • Register or sign in.
  • Free Starter includes one seven-day Explorer trial, starting only after the first successful table generation. Paid plans retain Explorer access after that trial.
  • Permanent Free Starter API access is separate and continues with up to 50 authenticated requests per day, one active API key, and all documented endpoints.

Generate a table

  1. Open Market Data Explorer. The initial screen contains controls and guidance but no requested price table.
  2. Select the assets you want. Use the supported-assets catalog when you need identifiers or quote directions.
  3. Choose “Generate price table.” A confirmation dialog appears before the endpoint is called.
  4. Confirm the notice that this generation consumes one asset-quota unit. Cancelling consumes nothing.
  5. After confirmation, wait for the authenticated response and review the generated-at time and row states.

Quota is reserved once the confirmed attempt passes entitlement checks. If a later selection, retrieval, or rendering step fails, that accepted attempt still costs one unit. Consult errors and rate limits before retrying.

Interpret the columns

FieldMeaning
Asset codeThe documented identifier used for selection and integration.
Localized nameA readable customer-facing asset name.
Value and unitThe precise returned value and its explicit quote unit; never infer the unit from the code.
Business timeThe source observation time represented by the row.
AvailabilityWhether the requested row is available in the loaded result.
FreshnessA state that helps distinguish current, aging, unavailable, or otherwise qualified data.

The generated-at time describes the table request, not necessarily every asset's source time. See the current-price response contract, methodology, and service status for context.

Download Excel or JSON

Use the download actions only after a table has loaded. The browser creates both files from the in-memory result. No additional assets request is sent, no additional quota is charged, and the generated files are not normally persisted on the Servix server.

  • Excel: a formatted worksheet with readable headings, localized timestamps, units, availability, freshness, and safe spreadsheet cell handling.
  • JSON: the same loaded rows with stable field names and precise values for downstream processing.

Downloaded files can contain customer-requested market data. Protect them in transit and at rest, and remove them when they are no longer needed.

Choose the right access path

Use the panel Explorer when a person needs to select, inspect, and export a snapshot. Use the authenticated customer API for scheduled jobs, applications, and repeatable integrations. Compare paid plans, review permanent Free Starter, or read the public Explorer overview.

Related documentation

Continue with the contract and service context