GET /v1/market/snapshots - SEC API for AI

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/market/snapshots?symbols=AAPL,MSFT"

{
  "object": "list",
  "data": [
    {
      "object": "market_snapshot",
      "id": "market_snapshot_AAPL",
      "createdAt": "2026-07-01T16:00:00.000Z",
      "livemode": false,
      "symbol": "AAPL",
      "name": "Apple Inc.",
      "exchange": "XNAS",
      "currency": "USD",
      "asOf": "2026-07-01T16:00:00.000Z",
      "price": 200.15,
      "change": 1.2,
      "changePercent": 0.6,
      "volume": 45000000,
      "marketCap": null,
      "previousClose": 198.95,
      "freshness": {
        "status": "fresh",
        "asOf": "2026-07-01T16:00:00.000Z",
        "sourcePublishedAt": null,
        "lagMs": 0
      },
      "provenance": {
        "source": "market_data",
        "accessionNumber": null,
        "filingUrl": "https://example.com/market/AAPL",
        "retrievedAt": "2026-07-01T16:00:00.000Z",
        "parserVersion": "example"
      },
      "sourceRights": {
        "source": "market_data",
        "posture": "contract_gated"
      }
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "degradedState": null,
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Retrieve stored latest-price snapshots for one or more symbols

Audience: developers and agents building a bounded latest-price view.

Coverage and source scope

Use this route to populate a bounded quote view from stored latest snapshots. Supply symbols as a comma-separated list, or one ticker alias. Results preserve request order, but a missing requested symbol is reported in degradedState.missingSymbols rather than represented as a zero price. Inspect each row’s asOf, freshness, provenance, sourceRights, and revision before presenting a value as current. See API conventions.

Canonical metadata

data
degradedState
per-row symbol
per-row asOf
per-row freshness
per-row provenance
per-row sourceRights
requestId
traceparent

Example request

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/market/snapshots?symbols=AAPL,MSFT"

Example response

{
  "object": "list",
  "data": [
    {
      "object": "market_snapshot",
      "id": "market_snapshot_AAPL",
      "createdAt": "2026-07-01T16:00:00.000Z",
      "livemode": false,
      "symbol": "AAPL",
      "name": "Apple Inc.",
      "exchange": "XNAS",
      "currency": "USD",
      "asOf": "2026-07-01T16:00:00.000Z",
      "price": 200.15,
      "change": 1.2,
      "changePercent": 0.6,
      "volume": 45000000,
      "marketCap": null,
      "previousClose": 198.95,
      "freshness": {
        "status": "fresh",
        "asOf": "2026-07-01T16:00:00.000Z",
        "sourcePublishedAt": null,
        "lagMs": 0
      },
      "provenance": {
        "source": "market_data",
        "accessionNumber": null,
        "filingUrl": "https://example.com/market/AAPL",
        "retrievedAt": "2026-07-01T16:00:00.000Z",
        "parserVersion": "example"
      },
      "sourceRights": {
        "source": "market_data",
        "posture": "contract_gated"
      }
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "degradedState": null,
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Missing symbols and freshness

Send a comma-separated symbols list, or a single ticker. The request accepts at most 250 distinct symbols and preserves request order for returned rows. When a requested symbol has no stored snapshot, inspect degradedState.missingSymbols; do not fill it with a previous price or a zero. asOf is the observation time, while freshness and revision explain how current or revised that observation is. See API conventions and freshness and trust.

Errors

A request without symbols or ticker returns 400 missing_symbols; malformed or oversized symbol input returns 400 invalid_symbols. A market-data availability problem can return 503 rather than an empty snapshot list.

Give this prompt to your agent

Failure posture

retain the requested symbol order and degradedState with the response
treat a missing symbol as unavailable data, not a zero price
preserve asOf, freshness, provenance, sourceRights, revision, requestId, and traceparent before downstream display

​Coverage and source scope

​Canonical metadata

​Example request

​Example response

​Missing symbols and freshness

​Errors

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Canonical metadata

Example request

Example response

Missing symbols and freshness

Errors

Give this prompt to your agent

Failure posture