title: Quickstart description: Make your first Pulse Markets request in about a minute, without signing up.

Pulse Markets is a REST API for instruments, prices, corporate actions, FX rates and earnings dates. Every response tells you what was known as of a date, not merely what is true now.

Your first request

The sandbox returns real historical data on its own separate allowance, so you can evaluate the API before creating an account.

curl -H "Authorization: Bearer $PULSE_SANDBOX_KEY" \
  "https://markets.pulseline.io/v1/instruments?query=AAPL"

Every successful response has the same two-part shape: a data payload and a meta block describing the answer's provenance.

{
  "data": [
    {
      "id": "…",
      "assetClass": "equity",
      "currentSymbol": "AAPL",
      "quoteCurrency": "USD",
      "isActive": true
    }
  ],
  "meta": {
    "asOf": "2026-07-18",
    "source": "…",
    "stale": false
  }
}

meta.stale is the honest field. When the underlying dataset has not been refreshed inside its expected window it is true, and meta.asOf tells you how old the answer is. A stale answer with an accurate asOf is more useful than a fabricated fresh one, so the API never pretends.

Fetch a price series

curl -H "Authorization: Bearer $PULSE_SANDBOX_KEY" \
  "https://markets.pulseline.io/v1/instruments/{id}/prices?from=2020-01-01&to=2020-12-31&adjusted=true"

Price responses carry two extra meta fields:

• adjusted - whether the bars have had the corporate action set applied.
• actionSetVersion - the version of that action set. Pin it and the same request returns the same numbers forever, even after a later restatement.

Where to go next

• Point-in-time and as-of queries - the flagship concept. Read this before you backtest anything.
• Authentication and API keys - scopes, environments, and rolling a key.
• Corporate actions and price adjustment - how raw and adjusted prices relate.
• Rate limits and quotas - how to read your allowance before you exhaust it.
• Errors - every code the API returns, and what to do about each.

Conventions used throughout

| Convention | Meaning | |---|---| | Dates | ISO yyyy-mm-dd, and always the exchange's session date | | Instrument ids | Opaque and stable. Resolve a ticker to one via /v1/instruments | | asOf | Optional on every resource. Omitted means "as of now" | | Money | Numbers, never strings. quoteCurrency and quoteUnit name the units |