> ## 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.

# Goldsky Edge

> Goldsky Edge is one API key for JSON-RPC, RPC caching (Boost), quorum-verified reads (Fanout), curated protocol datasets, and enterprise bundles.

export const D = {
  gold: 'var(--gsk-purple, #8C54F2)',
  green: 'var(--gsk-green, #059669)',
  red: 'var(--gsk-red, #DC2626)',
  gray: 'var(--gsk-gray, #6B7280)',
  sub: 'var(--gsk-sub, #6B7280)',
  wire: 'var(--gsk-wire, #94A3B8)',
  ink: 'var(--gsk-ink, #111827)',
  onGold: 'var(--gsk-on-accent, #FFFFFF)'
};

export const MONO = 'ui-monospace, SFMono-Regular, Menlo, monospace';

export const Mark = ({x, y, ok}) => <path d={ok ? 'M ' + (x - 4) + ' ' + y + ' l 3 3.4 l 6.5 -7.4' : 'M ' + (x - 3.6) + ' ' + (y - 3.6) + ' l 7.2 7.2 M ' + (x + 3.6) + ' ' + (y - 3.6) + ' l -7.2 7.2'} fill="none" stroke={ok ? D.green : D.red} strokeWidth="1.8" strokeLinecap="round" strokeLinejoin="round" />;

export const NodeBox = ({x, y, w, h, color, title, note, dash, mono, solid, mark}) => <g>
    <rect x={x} y={y} width={w} height={h} rx="10" fill={solid ? color : 'none'} stroke={solid ? 'none' : color} strokeWidth="1.2" strokeDasharray={dash ? '6 5' : undefined} />
    {mark ? <Mark x={x + 19} y={y + h / 2} ok={mark === 'ok'} /> : null}
    <text x={x + w / 2} y={note ? y + h / 2 - 3 : y + h / 2 + 5} textAnchor="middle" fontFamily={mono ? MONO : undefined} fontSize="14" fontWeight="600" fill={solid ? D.onGold : color}>{title}</text>
    {note ? <text x={x + w / 2} y={y + h / 2 + 15} textAnchor="middle" fontSize="11" fill={solid ? D.onGold : D.sub}>{note}</text> : null}
  </g>;

export const Wire = ({d}) => <path d={d} fill="none" stroke={D.wire} strokeWidth="1.2" />;

export const Cap = ({x, y, t, color}) => <text x={x} y={y} textAnchor="middle" fontSize="11" fill={color || D.sub}>{t}</text>;

export const Mini = ({h, children}) => <div style={{
  border: '1px solid var(--gsk-hair, rgba(17,24,39,0.12))',
  borderRadius: '12px',
  padding: '10px 12px',
  margin: '14px 0',
  background: 'var(--gsk-panel, #FCFCFB)'
}}>
    <svg viewBox={'0 0 760 ' + h} style={{
  width: '100%',
  height: 'auto',
  display: 'block'
}}>{children}</svg>
  </div>;

export const PGrid = ({children}) => <div style={{
  display: 'grid',
  gridTemplateColumns: 'repeat(auto-fit, minmax(300px, 1fr))',
  gap: '12px',
  margin: '16px 0'
}}>{children}</div>;

export const PCard = ({href, pain, product, children}) => <a href={href} style={{
  display: 'flex',
  flexDirection: 'column',
  border: '1px solid var(--gsk-hair, rgba(17,24,39,0.12))',
  borderRadius: '14px',
  padding: '15px 16px',
  textDecoration: 'none',
  background: 'var(--gsk-card, #FFFFFF)'
}}>
    <span style={{
  color: D.ink,
  fontSize: '16px',
  fontWeight: 600
}}>{pain}</span>
    <div style={{
  color: 'var(--gsk-body, #4B5563)',
  fontSize: '14px',
  fontWeight: 400,
  marginTop: '8px',
  lineHeight: 1.5
}}>{children}</div>
    <div style={{
  marginTop: 'auto',
  paddingTop: '12px'
}}>
      <span style={{
  color: D.gold,
  fontSize: '15px',
  fontWeight: 600,
  whiteSpace: 'nowrap'
}}>{product} →</span>
    </div>
  </a>;

<Mini h={280}>
  <Wire d="M 154 140 L 230 140" />

  <Wire d="M 400 122 C 434 108, 438 32, 470 32" />

  <Wire d="M 400 131 C 434 122, 438 86, 470 86" />

  <Wire d="M 400 140 L 470 140" />

  <Wire d="M 400 149 C 434 158, 438 194, 470 194" />

  <Wire d="M 400 158 C 434 172, 438 248, 470 248" />

  <NodeBox x={24} y={118} w={130} h={44} color={D.gray} title="Your app" />

  <NodeBox x={230} y={118} w={170} h={44} color={D.gold} title="edge.goldsky.com" mono solid />

  <NodeBox x={470} y={14} w={110} h={36} color={D.gold} title="Cache" />

  <Cap x={666} y={36} t="your endpoint + ours" />

  <NodeBox x={470} y={68} w={110} h={36} color={D.gold} title="RPC" />

  <Cap x={666} y={90} t="250+ chains" />

  <NodeBox x={470} y={122} w={110} h={36} color={D.gold} title="Fanout" />

  <Cap x={666} y={144} t="provider quorum" />

  <NodeBox x={470} y={176} w={110} h={36} color={D.gold} title="Data" />

  <Cap x={666} y={198} t="curated datasets" />

  <NodeBox x={470} y={230} w={110} h={36} color={D.gray} title="Enterprise" dash />

  <Cap x={666} y={252} t="your cloud + SLA" />
</Mini>

## Onchain data at the edge

Every product below runs on `edge.goldsky.com` with the same API key. Start with whichever problem sounds like yours.

<PGrid>
  <PCard pain="My RPC bill is too high" product="Boost" href="/boost">
    Point it at your provider and save on every cached read.
  </PCard>

  <PCard pain="I just need a solid endpoint" product="Edge RPC" href="/edge-rpc/introduction">
    One endpoint, 250+ chains, eRPC reliability.
  </PCard>

  <PCard pain="Wrong answers cost me money" product="Edge Fanout" href="/edge-rpc/tiers/fanout">
    Every read verified by a quorum of providers.
  </PCard>

  <PCard pain="Positions, not raw logs" product="Edge Data" href="#edge-data">
    Polymarket positions, balances, activity, plus block headers.
  </PCard>

  <PCard pain="I need a solution + SLA" product="Edge Enterprise" href="#edge-enterprise">
    The suite, assembled. BYOC available.
  </PCard>

  <PCard pain="Give my agents chain data" product="x402" href="/edge-rpc/capabilities/x402">
    Pay per call in USDC. No account, no key.
  </PCard>
</PGrid>

## At a glance

| Product             | One line                                | Price                    | Status       |
| ------------------- | --------------------------------------- | ------------------------ | ------------ |
| **Boost**           | Cache-first proxy over *your* endpoint  | Free                     | Available    |
| **Edge RPC**        | Goldsky's multi-region RPC, 250+ chains | \$5/M, all methods equal | GA           |
| **Edge Fanout**     | Quorum-verified reads                   | \$15/M requests          | On request   |
| **Edge Data**       | Protocol datasets, REST                 | \$10/M CUs               | Private beta |
| **Edge Enterprise** | The suite + SLA + BYOC                  | Contract                 | Talk to us   |

## Boost

**Bring your endpoint. We answer what we've indexed; everything else passes through untouched.**

<Mini h={134}>
  <Wire d="M 154 67 L 260 67" />

  <Wire d="M 430 56 C 500 46, 510 36, 560 32" />

  <Wire d="M 430 78 C 500 88, 510 98, 560 102" />

  <NodeBox x={24} y={45} w={130} h={44} color={D.gray} title="Your app" />

  <NodeBox x={260} y={45} w={170} h={44} color={D.gold} title="Boost" solid />

  <NodeBox x={560} y={8} w={180} h={48} color={D.green} title="Goldsky data" note="hit, free" />

  <NodeBox x={560} y={78} w={180} h={48} color={D.gray} title="Your endpoint" note="miss, free" />
</Mini>

* Cached: blocks, transactions, receipts, logs at fixed heights.
* `latest`, tags, writes, everything else: your endpoint, free.
* Boost is available on networks with indexed coverage from genesis. See the [current network list](/boost/reference#supported-networks).
* Enable one Boost per project, then connect a provider account or add a custom URL in the dashboard or with `goldsky boost enable` ([CLI reference](/reference/cli#boost)). Every request then uses `/boost/{chain}?key=…`.

```bash wrap theme={"dark"}
curl -i -X POST \
  "https://edge.goldsky.com/boost/ethereum?key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,
       "method":"eth_getBlockByNumber","params":["0x0",false]}'
```

[Full docs →](/boost)

## Edge RPC

**A standard JSON-RPC endpoint. \$5/M, every method equal: traces cost the same as `eth_blockNumber`.**

<Mini h={140}>
  <Wire d="M 154 70 L 260 70" />

  <Wire d="M 430 60 C 500 48, 510 30, 560 26" />

  <Wire d="M 430 70 L 560 70" />

  <Wire d="M 430 80 C 500 92, 510 110, 560 114" />

  <NodeBox x={24} y={48} w={130} h={44} color={D.gray} title="Your app" />

  <NodeBox x={260} y={44} w={170} h={52} color={D.gold} title="Edge RPC" note="failover, hedging" solid />

  <NodeBox x={560} y={8} w={180} h={36} color={D.green} title="Provider A" mark="ok" />

  <NodeBox x={560} y={52} w={180} h={36} color={D.green} title="Provider B" mark="ok" />

  <NodeBox x={560} y={96} w={180} h={36} color={D.red} title="Provider C" mark="bad" />
</Mini>

* Built on [eRPC](https://github.com/erpc/erpc): failover, hedging, dedup, upstream scoring, integrity checks.
* Indexer-aware: archive routing, `eth_getLogs` auto-splitting.
* gRPC block streaming: early access, ask us.
* Live chain list: `GET https://edge.goldsky.com`.
* CLI: `goldsky edge create <name>` gives you a key; `goldsky edge networks` lists chains. See the [CLI reference](/reference/cli#edge).

```bash wrap theme={"dark"}
curl -X POST \
  "https://edge.goldsky.com/rpc/standard/evm/1?key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,
       "method":"eth_blockNumber","params":[]}'
```

[Full docs →](/edge-rpc/introduction)

## Edge Fanout

**Reads verified by a quorum of independent providers. Disagreement returns an error, never a guess.**

<Mini h={150}>
  <Wire d="M 154 70 L 260 70" />

  <Wire d="M 430 60 C 500 48, 510 30, 560 26" />

  <Wire d="M 430 70 L 560 70" />

  <Wire d="M 430 80 C 500 92, 510 110, 560 114" />

  <NodeBox x={24} y={48} w={130} h={44} color={D.gray} title="Your app" />

  <NodeBox x={260} y={44} w={170} h={52} color={D.gold} title="Edge Fanout" note="quorum reads" solid />

  <NodeBox x={560} y={8} w={180} h={36} color={D.green} title="0xd4e5…" mark="ok" mono />

  <NodeBox x={560} y={52} w={180} h={36} color={D.green} title="0xd4e5…" mark="ok" mono />

  <NodeBox x={560} y={96} w={180} h={36} color={D.red} title="0x9a1b…" mark="bad" mono />

  <Cap x={345} y={128} t="2 of 3 agree → answer" color={D.green} />
</Mini>

* Quorums sized per network: 2-of-3 up to 4-of-5, 46 networks.
* Deep integrity checks: state and receipt roots recomputed.
* `eth_sendRawTransaction` broadcasts to every provider at once.
* \$15/M requests; each read fans out to multiple providers. For DeFi, agents, settlement.

<Info>
  Fanout is mainly for clients that can't protect themselves: indexers or apps that don't handle reorgs and reverted data, or can't verify block and log integrity on their own. No RPC provider, ours or anyone's, can compensate for a limited client implementation. Fanout moves those checks server-side, so every response arrives already verified.
</Info>

On request: [book a call](https://cal.com/team/goldsky/website-intro), email [sales@goldsky.com](mailto:sales@goldsky.com), or read the [full docs](/edge-rpc/tiers/fanout).

## Edge Data

**Protocol data as an API. No indexer to build, run, or backfill.**

<Mini h={134}>
  <Wire d="M 154 67 L 260 67" />

  <Wire d="M 430 56 C 500 46, 510 36, 560 32" />

  <Wire d="M 430 78 C 500 88, 510 98, 560 102" />

  <NodeBox x={24} y={45} w={130} h={44} color={D.gray} title="Your app" />

  <NodeBox x={260} y={45} w={170} h={44} color={D.gold} title="Edge Data" note="REST, JSON" solid />

  <NodeBox x={560} y={8} w={180} h={48} color={D.gold} title="polymarket/*" note="positions, balances, activity" mono />

  <NodeBox x={560} y={78} w={180} h={48} color={D.gold} title="blocks/{chain}" note="headers, chain head" mono />
</Mini>

* Polymarket (Polygon): positions with PnL, token balances, trade activity.
* Blocks: block headers by number, hash, or number/timestamp range, plus chain head.
* Roadmap: USDC transfers and supply, ENS, token balances, DeFi positions.
* CLI: `goldsky edge create <name> --product data` gives you a key; `goldsky edge sources` lists datasets. See the [CLI reference](/reference/cli#edge).

```bash wrap theme={"dark"}
BASE="https://edge.goldsky.com/data"
curl "$BASE/polymarket/positions?address=0xWALLET&key=KEY"
curl "$BASE/blocks/matic/head?key=KEY"
```

\$10 per million compute units. One returned row is one CU today; CU weight can change per dataset. Private beta: ask your Goldsky contact for `data` access.

### Blocks

The usual job is turning a timestamp into a block number. Ask for the newest
block at or before it:

```bash wrap theme={"dark"}
BASE="https://edge.goldsky.com/data"

curl "$BASE/blocks/ethereum?timestamp_lte=1787250755&sort=number_desc&limit=1&key=KEY"
curl "$BASE/blocks/ethereum/head?key=KEY"
```

`head` reports `head_lag_seconds`, so you can tell a quiet chain from a stalled one.

#### Supported chains

Edge RPC support doesn't imply a Blocks dataset. This list is shorter, and
anything else returns `400 unknown chain`. The live set is the `chain` enum in
the [API reference](https://edge.goldsky.com/data/docs/).

| Chain             | Slug         |
| ----------------- | ------------ |
| Base              | `base`       |
| Blast             | `blast`      |
| Bsc               | `bsc`        |
| Celo              | `celo`       |
| Ethereum          | `ethereum`   |
| Flare             | `flare`      |
| HyperEVM          | `hyperevm`   |
| Linea             | `linea`      |
| Optimism          | `optimism`   |
| Plasma            | `plasma`     |
| Plume             | `plume`      |
| Polygon           | `matic`      |
| Robinhood Mainnet | `robinhood`  |
| Sei               | `sei`        |
| World Chain       | `worldchain` |
| X Layer           | `xlayer`     |

## Edge Enterprise

**The suite, assembled for your requirements.**

<Mini h={150}>
  <Wire d="M 154 75 L 250 75" />

  <rect x={250} y={10} width={490} height={130} rx="12" fill="none" stroke={D.gray} strokeWidth="1.2" strokeDasharray="6 5" />

  <Cap x={495} y={32} t="Your contract, BYOC option" color={D.gray} />

  <NodeBox x={272} y={48} w={102} h={36} color={D.gold} title="Cache" solid />

  <NodeBox x={386} y={48} w={102} h={36} color={D.gold} title="RPC" solid />

  <NodeBox x={500} y={48} w={102} h={36} color={D.gold} title="Fanout" solid />

  <NodeBox x={614} y={48} w={102} h={36} color={D.gold} title="Data" solid />

  <Cap x={495} y={118} t="SLA, 24/7 support, committed-use pricing" color={D.green} />

  <NodeBox x={24} y={53} w={130} h={44} color={D.gray} title="Your app" />
</Mini>

* Contractual SLAs, 24/7 on-call, named CSM, shared Slack.
* BYOC, static IPs, custom network integrations.
* AWS Marketplace: retire up to 25% of an annual AWS commit.

[Book a call](https://cal.com/team/goldsky/website-intro) or email [sales@goldsky.com](mailto:sales@goldsky.com).

## Still deciding?

* Happy with your provider, unhappy with the bill → [Boost](/boost)
* One endpoint across 250+ chains → [Edge RPC](/edge-rpc/introduction)
* Indexing or backfilling → [Edge RPC](/edge-rpc/introduction)
* Highest-quality data (no missed logs, no corrupt blocks) → [Edge Fanout](/edge-rpc/tiers/fanout)
* Application data, not chain calls → [Edge Data](#edge-data)
* SLA, residency, procurement → [Edge Enterprise](#edge-enterprise)


## Related topics

- [Edge EVM Sources](/turbo-pipelines/sources/edge-evm.md)
- [trace_call](/edge-rpc/evm/methods/trace_call.md)
- [eth_accounts](/edge-rpc/evm/methods/eth_accounts.md)
- [trace_block](/edge-rpc/evm/methods/trace_block.md)
- [trace_filter](/edge-rpc/evm/methods/trace_filter.md)