> ## 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. # Get the project's Boost > The endpoint record plus Boost serving state: availability, every supported chain with its switch and the upstream serving it, connected provider accounts, the masked configuration, the vendor list, and the dashboard-side settings. ## OpenAPI ````yaml https://api.goldsky.com/api/v1/docs/openapi.json get /boost 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: /boost: get: tags: - Boost summary: Get the project's Boost description: >- The endpoint record plus Boost serving state: availability, every supported chain with its switch and the upstream serving it, connected provider accounts, the masked configuration, the vendor list, and the dashboard-side settings. operationId: getBoostEndpoint responses: '200': description: Default Response content: application/json: schema: type: object properties: data: type: object allOf: - type: object properties: name: examples: - my-endpoint type: string status: anyOf: - type: string enum: - ACTIVE - type: string enum: - PAUSED rate_limit_budget: description: Named rate-limit budget, or null for the default. anyOf: - type: string - type: 'null' allowed_domains: description: >- Web origins allowed to call this endpoint from a browser (empty = unrestricted). examples: - - https://app.example.com type: array items: type: string created_at: format: date-time type: string updated_at: format: date-time type: string paused_at: anyOf: - format: date-time type: string - type: 'null' required: - name - status - rate_limit_budget - allowed_domains - created_at - updated_at - paused_at - type: object properties: boost: description: >- Boost serving state; null when the Boost control plane is unreachable right now (the endpoint record is still served). anyOf: - type: object properties: available: type: boolean chains: description: >- Every Boost-supported chain with its state on this endpoint: switched on or off, which upstream serves it, which stand by. Chains with no configuration are present with enabled: false and no upstreams. type: array items: type: object allOf: - type: object properties: name: examples: - ethereum type: string chain_id: examples: - 1 type: integer cached: type: boolean earliest_block: anyOf: - type: integer - type: 'null' latest_block: anyOf: - type: integer - type: 'null' stale: type: boolean required: - name - chain_id - type: object properties: enabled: type: boolean active_upstream: description: >- The upstream serving this chain, or null when none is. anyOf: - type: object properties: id: examples: - ethereum-quicknode type: string endpoint_host: examples: - eth.quiknode.pro type: string source: description: >- Where the upstream came from: a connected provider account, or a URL pasted by hand. anyOf: - examples: - quicknode anyOf: - type: string enum: - quicknode - type: string enum: - alchemy - type: string enum: - chainstack - type: string enum: - drpc - type: string enum: - ankr - type: string enum: - custom required: - id - endpoint_host - source - type: 'null' standbys: description: >- Configured upstreams not currently serving. type: array items: type: object properties: id: examples: - ethereum-quicknode type: string endpoint_host: examples: - eth.quiknode.pro type: string source: description: >- Where the upstream came from: a connected provider account, or a URL pasted by hand. anyOf: - examples: - quicknode anyOf: - type: string enum: - quicknode - type: string enum: - alchemy - type: string enum: - chainstack - type: string enum: - drpc - type: string enum: - ankr - type: string enum: - custom required: - id - endpoint_host - source required: - enabled - active_upstream - standbys providers: description: >- Provider accounts connected to this project (QuickNode, Alchemy) and the chains each one provisioned. type: array items: type: object properties: vendor: examples: - quicknode anyOf: - type: string enum: - quicknode - type: string enum: - alchemy - type: string enum: - chainstack - type: string enum: - drpc - type: string enum: - ankr credential_hint: description: >- The stored credential, masked. Never the credential itself. examples: - QN_d…7bc type: string connected_at: format: date-time type: string chains: description: >- Chains whose upstream this account created. type: array items: type: string account_resource: description: >- What to look for in the provider's own dashboard to find what this connection created there. Null when the vendor names its resources per chain, in which case the chain rows' endpoint hosts are the answer. examples: - banana-mouse-cube anyOf: - type: string - type: 'null' required: - vendor - credential_hint - connected_at - chains - account_resource config: description: >- null means Boost is available and this endpoint simply has no configuration yet. anyOf: - type: object properties: chains: type: array items: type: object properties: chain_id: type: integer forward_timeout_ms: anyOf: - type: integer - type: 'null' cache_timeout_ms: anyOf: - type: integer - type: 'null' required: - chain_id - forward_timeout_ms - cache_timeout_ms upstreams: type: array items: type: object properties: id: examples: - ethereum-primary type: string chain_id: type: integer endpoint_host: description: >- Provider host only. The stored URL is a credential and is never returned. examples: - eth-mainnet.g.alchemy.com type: string header_names: description: >- Names of configured provider headers; values are never returned. type: array items: type: string active: description: >- Whether this upstream currently serves the chain (standbys are false). type: boolean forward_timeout_ms: anyOf: - type: integer - type: 'null' vendor_name: description: >- Pinned pricing vendor, or null for auto-detection. anyOf: - type: string - type: 'null' required: - id - chain_id - endpoint_host - active - forward_timeout_ms - vendor_name required: - chains - upstreams - type: 'null' vendors: type: array items: type: object properties: name: type: string label: type: string unit: type: string required: - name - label - unit settings: type: object properties: provider_rate_per_million_usd: description: >- What you say your provider charges per million requests, in USD. Prices the estimated saving when no vendor rate card applies. examples: - 5 type: number required: - provider_rate_per_million_usd required: - available - chains - providers - config - vendors - settings - type: 'null' required: - boost required: - data 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 - [Enable Boost for this project](https://docs.goldsky.com/api-reference/boost-lifecycle/enable-boost-for-this-project.md) - [Disable the project's Boost](https://docs.goldsky.com/api-reference/boost-lifecycle/disable-the-projects-boost.md) - [Update the project's Boost](https://docs.goldsky.com/api-reference/boost/update-the-projects-boost.md) - [Get Boost metrics for an endpoint](https://docs.goldsky.com/api-reference/boost-metrics/get-boost-metrics-for-an-endpoint.md) - [Get Boost's per-request history](https://docs.goldsky.com/api-reference/boost-metrics/get-boosts-per-request-history.md)