> ## Documentation Index > Fetch the complete documentation index at: https://docs.goldsky.com/llms.txt > Use this file to discover all available pages before exploring further. # Count a feed's requests over time > The requests this project sent the feed, from any of its Data API keys, counted per time bucket: how many succeeded, failed, and counted toward usage. Every bucket in the window is returned, empty ones as zeros. Defaults to the last 24 hours in hourly buckets; requests are kept for 30 days. ## OpenAPI ````yaml https://api.goldsky.com/api/v1/docs/openapi.json get /feeds/{theme}/{dataset}/usage openapi: 3.1.0 info: title: Goldsky API description: >- REST API for managing Goldsky resources — pipelines, subgraphs, Edge endpoints, and Feeds keys and usage. Create, deploy, monitor, and manage them programmatically. For guides and reference, see the [Goldsky documentation](https://docs.goldsky.com) — including [Subgraphs](https://docs.goldsky.com/subgraphs/introduction) and [Pipelines](https://docs.goldsky.com/mirror/introduction). ## Authentication Every request carries an API token as a bearer token: ``` Authorization: Bearer ``` Create one on the [API Keys page](https://app.goldsky.com/dashboard/settings/api-keys) of the Goldsky dashboard. A token is scoped to the project it was created in, so the project is never part of a request path. Read operations need the Viewer role; writes need Editor. The Feeds data itself — wallet transfers and balances — is served from `https://edge.goldsky.com/data` with a Data API key, and documented in its own reference: [edge.goldsky.com/data/openapi.json](https://edge.goldsky.com/data/openapi.json). ## Errors Errors are [RFC 9457 problem details](https://www.rfc-editor.org/rfc/rfc9457) served as `application/problem+json`: ```json { "type": "https://api.goldsky.com/api/errors/subgraph-not-found", "title": "Subgraph not found", "status": 404, "detail": "No subgraph named 'my-subgraph' exists in this project.", "instance": "/api/v1/subgraphs/my-subgraph" } ``` Branch on `type`, not on `title` or `detail` — the URI is stable, the prose is not. Every `type` dereferences to a human-readable page describing the cause and the fix; the full list lives at [api.goldsky.com/api/errors](https://api.goldsky.com/api/errors). Validation failures (400) add an `errors` array naming each offending field. ## Pagination List endpoints that can return unbounded results — pipelines and subgraphs — page with `page_size` and `page_token`: ``` GET /api/v1/subgraphs?page_size=50 GET /api/v1/subgraphs?page_size=50&page_token= ``` Keep following `pagination.next_page_token` until it comes back `null`. A page can hold fewer than `page_size` items and still have a next page, so treat a short page as "keep going", not as the end. version: 1.6.0 contact: name: Goldsky Support email: support@goldsky.com url: https://docs.goldsky.com servers: - url: /api/v1 description: Current environment security: - BearerAuth: [] tags: - name: Pipelines x-displayName: Create & manage description: >- Create, read, and delete pipelines. A pipeline is identified by its name within the project. - name: Pipeline Authoring x-displayName: Validate & preview description: >- Check a pipeline definition and see what it would produce, before creating anything. Neither endpoint touches an existing pipeline. - name: Pipeline Lifecycle x-displayName: Lifecycle description: Pause, resume, and restart a running pipeline. - name: Pipeline Status x-displayName: Status description: Query pipeline runtime status and per-source progress state. - name: Pipeline Logs x-displayName: Logs description: Retrieve pipeline execution logs and error counts. - name: Subgraphs x-displayName: Browse description: >- Read subgraphs and their versions. A subgraph is identified by `name`/`version`. - name: Subgraph Deployments x-displayName: Deployments description: >- Deploy a compiled subgraph bundle as a new version, or remove a deployed one. - name: Subgraph Tags x-displayName: Tags description: >- Point a stable alias — `production`, say — at a specific version, so consumers keep one URL across deploys. - name: Subgraph Lifecycle x-displayName: Lifecycle description: Pause and resume indexing, and update the settings of a deployed version. - name: Subgraph Logs x-displayName: Logs description: Retrieve subgraph indexing logs. - name: Subgraph Webhooks x-displayName: Webhooks description: >- Stream row-level changes to a subgraph entity out to a URL. Webhooks are project-scoped and each one targets a single entity of a single subgraph version. - name: Edge Endpoints x-displayName: Create & manage description: >- Create and manage Edge endpoints — RPC and Data — including rate limits and allowed domains. - name: Edge Lifecycle x-displayName: Lifecycle description: >- Pause and resume an endpoint. A paused endpoint rejects traffic but keeps its configuration and key. - name: Edge API Keys x-displayName: API keys description: Reveal the API key an Edge endpoint serves traffic under. - name: Edge Metrics x-displayName: Metrics description: Request volume and error rates for an Edge endpoint. - name: Boost x-displayName: Endpoint description: >- Read and update the project's Boost: a cache-first proxy for EVM JSON-RPC reads, backed by your own provider upstreams. One Boost per project. Free for verified organizations: a team with a member on a business email domain (not a free mailbox provider) qualifies automatically. - name: Boost Lifecycle x-displayName: Lifecycle description: >- Enable and disable the project's Boost. A disabled Boost refuses traffic but keeps its chains, upstreams, and key. - name: Boost API Keys x-displayName: API key description: Reveal the API key the Boost serves traffic under. - name: Boost Chains x-displayName: Chains description: >- List the chains Boost can cache, and switch a chain on or off or override its timeouts on this Boost. - name: Boost Providers x-displayName: Provider accounts description: >- Connect a provider account (Alchemy or QuickNode) and let Boost create and register its endpoints for you, instead of pasting URLs one chain at a time. - name: Boost Upstreams x-displayName: Upstreams description: >- The provider URLs Boost forwards to, one active per chain with fallbacks. Validate a URL, add or remove an upstream, replace its URL, fail over to another, or tune its settings. Upstreams are addressed by `{chain, id}` in the request body. - name: Boost Metrics x-displayName: Metrics description: >- Cache hit rate, latency, provider calls, credit savings, and the per-request history for a Boost. - name: Feed Catalog x-displayName: Catalog & API key description: >- List the feeds Goldsky offers and when the project first used each, and get or create the project's Feeds key (an Edge Data endpoint named `feeds`) every feed authenticates with; rotate it with `POST /api/v1/feeds/key/rotate`. - name: Feed Logs x-displayName: Request logs description: >- Every request the project sent a feed: when, which path, whether it succeeded, and how long it took. Kept for 30 days. - name: Catalogs x-displayName: Catalogs description: >- What Goldsky supports: chains you can index a subgraph on, and the networks and datasets an Edge endpoint can be pointed at. Unauthenticated-safe reads that never change per project. paths: /feeds/{theme}/{dataset}/usage: get: tags: - Feed Logs summary: Count a feed's requests over time description: >- The requests this project sent the feed, from any of its Data API keys, counted per time bucket: how many succeeded, failed, and counted toward usage. Every bucket in the window is returned, empty ones as zeros. Defaults to the last 24 hours in hourly buckets; requests are kept for 30 days. operationId: getFeedUsage parameters: - schema: format: date-time type: string in: query name: from required: false description: >- Inclusive lower bound on the request time (ISO 8601). Defaults to 24 hours before `to`. Requests are kept for 30 days. - schema: format: date-time type: string in: query name: to required: false description: >- Inclusive upper bound on the request time (ISO 8601). Defaults to now. - schema: anyOf: - type: string enum: - 1h - type: string enum: - 6h - type: string enum: - 1d in: query name: bucket required: false description: >- Width of each bucket. Defaults to `1h` for a window of a day or less, `6h` up to a week, `1d` beyond. - schema: type: string in: query name: timeZone required: false description: >- IANA time zone the buckets start on, like `America/New_York`: a `1d` bucket runs from that zone's midnight. Defaults to `UTC`. - schema: type: string in: path name: theme required: true description: Feed theme, e.g. `wallets`. - schema: type: string in: path name: dataset required: true description: Dataset within the theme, e.g. `transfers`. responses: '200': description: Default Response content: application/json: schema: type: object properties: from: format: date-time type: string to: format: date-time type: string bucket: anyOf: - type: string enum: - 1h - type: string enum: - 6h - type: string enum: - 1d data: description: >- Every bucket in the window, oldest first, including empty ones. type: array items: type: object properties: time: format: date-time description: Start of the bucket, on the `timeZone` clock. type: string succeeded: description: Requests that succeeded. type: integer failed: description: Requests that failed. type: integer billable: description: Requests that counted toward usage. type: integer required: - time - succeeded - failed - billable totals: type: object properties: requests: description: All requests in the window. type: integer succeeded: description: Requests that succeeded. type: integer failed: description: Requests that failed. type: integer billable: description: Requests that counted toward usage. type: integer required: - requests - succeeded - failed - billable required: - from - to - bucket - data - totals components: securitySchemes: BearerAuth: type: http scheme: bearer description: >- API token generated from the [Goldsky Dashboard](https://app.goldsky.com/dashboard/settings/api-keys). Pass as: Authorization: Bearer ```` ## Related topics - [Pricing: plans, metering, and product costs](https://docs.goldsky.com/pricing/summary.md) - [List a feed's requests](https://docs.goldsky.com/api-reference/feed-logs/list-a-feeds-requests.md) - [List feeds](https://docs.goldsky.com/api-reference/feed-catalog/list-feeds.md) - [Feeds API overview](https://docs.goldsky.com/feeds/api/overview.md) - [Get endpoint metrics](https://docs.goldsky.com/api-reference/edge-metrics/get-endpoint-metrics.md)