Get Lighter data freshness JSON Schema

Source OpenAPI: 0xArchive API 1.8.0; 227 paths; 217 component schemas. Check when data was last updated for each data type for a specific Lighter coin.

Route Metadata

Field	Value
Method	`GET`
Path	`/v1/lighter/freshness/{symbol}`
operationId	`getLighterFreshness`
Tag	Lighter - Convenience
Family	Lighter
Deprecated or legacy	no

Human endpoint reference

Open GET /v1/lighter/freshness/{symbol} for authentication, parameters, responses, and examples.

Request Parameters

Path Parameters

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "getLighterFreshness path parameters",
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "description": "Coin symbol (e.g., BTC, ETH)",
      "type": "string",
      "example": "BTC",
      "x-parameter-location": "path"
    }
  }
}

Response Contracts

Status 200

Data freshness for the coin

application/json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "getLighterFreshness response 200",
  "description": "API response wrapping coin freshness data",
  "type": "object",
  "properties": {
    "data": {
      "description": "Shared route-family freshness shape. Unsupported data-type buckets may be omitted; consult the operation description for each family.",
      "type": "object",
      "required": [
        "coin",
        "exchange",
        "measured_at",
        "symbol"
      ],
      "properties": {
        "coin": {
          "description": "Trading pair symbol (deprecated, use symbol instead)",
          "type": "string",
          "deprecated": true,
          "example": "BTC"
        },
        "exchange": {
          "description": "Venue-family key recognized by this route, such as `hyperliquid`.",
          "type": "string",
          "example": "hyperliquid"
        },
        "funding": {
          "description": "Freshness information for a single data type",
          "type": "object",
          "properties": {
            "lag_ms": {
              "description": "Current lag in milliseconds between now and last update",
              "type": "integer",
              "nullable": true,
              "example": 1200
            },
            "last_updated": {
              "description": "When this data type was last updated for the coin",
              "type": "string",
              "format": "date-time",
              "nullable": true,
              "example": "2026-02-23T12:00:00.000Z"
            }
          }
        },
        "liquidations": {
          "description": "Freshness information for a single data type",
          "type": "object",
          "properties": {
            "lag_ms": {
              "description": "Current lag in milliseconds between now and last update",
              "type": "integer",
              "nullable": true,
              "example": 1200
            },
            "last_updated": {
              "description": "When this data type was last updated for the coin",
              "type": "string",
              "format": "date-time",
              "nullable": true,
              "example": "2026-02-23T12:00:00.000Z"
            }
          }
        },
        "measured_at": {
          "description": "When the freshness was measured",
          "type": "string",
          "format": "date-time",
          "example": "2026-02-23T12:00:00.000Z"
        },
        "open_interest": {
          "description": "Freshness information for a single data type",
          "type": "object",
          "properties": {
            "lag_ms": {
              "description": "Current lag in milliseconds between now and last update",
              "type": "integer",
              "nullable": true,
              "example": 1200
            },
            "last_updated": {
              "description": "When this data type was last updated for the coin",
              "type": "string",
              "format": "date-time",
              "nullable": true,
              "example": "2026-02-23T12:00:00.000Z"
            }
          }
        },
        "orderbook": {
          "description": "Freshness information for a single data type",
          "type": "object",
          "properties": {
            "lag_ms": {
              "description": "Current lag in milliseconds between now and last update",
              "type": "integer",
              "nullable": true,
              "example": 1200
            },
            "last_updated": {
              "description": "When this data type was last updated for the coin",
              "type": "string",
              "format": "date-time",
              "nullable": true,
              "example": "2026-02-23T12:00:00.000Z"
            }
          }
        },
        "symbol": {
          "description": "Trading pair symbol",
          "type": "string",
          "example": "BTC"
        },
        "trades": {
          "description": "Freshness information for a single data type",
          "type": "object",
          "properties": {
            "lag_ms": {
              "description": "Current lag in milliseconds between now and last update",
              "type": "integer",
              "nullable": true,
              "example": 1200
            },
            "last_updated": {
              "description": "When this data type was last updated for the coin",
              "type": "string",
              "format": "date-time",
              "nullable": true,
              "example": "2026-02-23T12:00:00.000Z"
            }
          }
        }
      }
    },
    "meta": {
      "description": "Response metadata",
      "type": "object",
      "properties": {
        "count": {
          "description": "Number of records returned",
          "type": "integer"
        },
        "coverage_from": {
          "description": "Earliest coverage for the requested symbol and data type. Present only when the requested window ends before coverage begins.",
          "type": "string",
          "format": "date-time"
        },
        "has_more": {
          "description": "Present on cursor-paged routes: true when another page exists. `next_cursor` is present exactly when it is true.",
          "type": "boolean"
        },
        "next_cursor": {
          "description": "Cursor for pagination (timestamp). Use this value as the `cursor` parameter to fetch the next page of results.",
          "type": "string",
          "nullable": true
        },
        "notice": {
          "description": "Human-readable advisory about the response. Used when the requested window ends before coverage begins for the symbol, and on CVD responses that are one page of several; may carry other advisories in future.",
          "type": "string"
        },
        "request_id": {
          "description": "Unique request ID for support",
          "type": "string",
          "format": "uuid"
        },
        "symbol": {
          "description": "Present on per-symbol routes: the symbol the response covers.",
          "type": "string"
        },
        "venue": {
          "description": "Present on per-symbol routes: the venue the response covers, for example `hyperliquid` or `hip3`.",
          "type": "string"
        }
      }
    },
    "success": {
      "type": "boolean",
      "example": true
    }
  }
}

Status 400

Invalid request

application/json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "getLighterFreshness response 400",
  "description": "Error response",
  "type": "object",
  "properties": {
    "code": {
      "description": "HTTP status code",
      "type": "integer"
    },
    "error": {
      "description": "Error message",
      "type": "string"
    },
    "error_code": {
      "description": "Machine-readable error code. Common values: `invalid_query_params` (a query parameter failed to parse or validate) and `invalid_path_params` (a path parameter failed to parse). Other endpoint-specific codes exist; treat unknown codes as generic errors of the given HTTP status.",
      "type": "string"
    },
    "param": {
      "description": "The parameter at fault, when the error is about one parameter.",
      "type": "string"
    },
    "request_id": {
      "description": "Unique request ID for support",
      "type": "string",
      "format": "uuid"
    },
    "success": {
      "description": "Always false on an error.",
      "type": "boolean",
      "example": false
    }
  }
}

OpenAPI example

{
  "code": 400,
  "error": "Failed to deserialize query string: limit: invalid digit found in string",
  "error_code": "invalid_query_params",
  "param": "limit",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05",
  "success": false
}

Status 401

Authentication required

application/json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "getLighterFreshness response 401",
  "description": "Error response",
  "type": "object",
  "properties": {
    "code": {
      "description": "HTTP status code",
      "type": "integer"
    },
    "error": {
      "description": "Error message",
      "type": "string"
    },
    "error_code": {
      "description": "Machine-readable error code. Common values: `invalid_query_params` (a query parameter failed to parse or validate) and `invalid_path_params` (a path parameter failed to parse). Other endpoint-specific codes exist; treat unknown codes as generic errors of the given HTTP status.",
      "type": "string"
    },
    "param": {
      "description": "The parameter at fault, when the error is about one parameter.",
      "type": "string"
    },
    "request_id": {
      "description": "Unique request ID for support",
      "type": "string",
      "format": "uuid"
    },
    "success": {
      "description": "Always false on an error.",
      "type": "boolean",
      "example": false
    }
  }
}

OpenAPI example

{
  "code": 401,
  "error": "Missing authentication credentials. Provide X-API-Key header or Bearer token.",
  "error_code": "unauthorized",
  "request_id": "71ed4b6f-63ef-4ae1-a123-07ffa47c1c14",
  "success": false
}

Status 429

Rate limit exceeded

application/json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "getLighterFreshness response 429",
  "description": "Error response",
  "type": "object",
  "properties": {
    "code": {
      "description": "HTTP status code",
      "type": "integer"
    },
    "error": {
      "description": "Error message",
      "type": "string"
    },
    "error_code": {
      "description": "Machine-readable error code. Common values: `invalid_query_params` (a query parameter failed to parse or validate) and `invalid_path_params` (a path parameter failed to parse). Other endpoint-specific codes exist; treat unknown codes as generic errors of the given HTTP status.",
      "type": "string"
    },
    "param": {
      "description": "The parameter at fault, when the error is about one parameter.",
      "type": "string"
    },
    "request_id": {
      "description": "Unique request ID for support",
      "type": "string",
      "format": "uuid"
    },
    "success": {
      "description": "Always false on an error.",
      "type": "boolean",
      "example": false
    }
  }
}

OpenAPI example

{
  "code": 429,
  "error": "Rate limit exceeded"
}

Endpoint reference

Requests and responses

Datasets

Venues

OpenAPI and schemas

Guides

Get Lighter data freshness JSON Schema

Route Metadata

Human endpoint reference

Request Parameters

Path Parameters

Response Contracts

Status 200

application/json

Status 400

application/json

OpenAPI example

Status 401

application/json

OpenAPI example

Status 429

application/json

OpenAPI example

​Route Metadata

​Human endpoint reference

​Request Parameters

​Path Parameters

​Response Contracts

​Status 200

​application/json

​Status 400

​application/json

OpenAPI example

​Status 401

​application/json

OpenAPI example

​Status 429

​application/json

OpenAPI example

Route Metadata

Human endpoint reference

Request Parameters

Path Parameters

Response Contracts

Status 200

application/json

Status 400

application/json

Status 401

application/json

Status 429

application/json