Skip to content

docs: document x-api-experimental GuideStar-only header - #1149

Open
codyborn wants to merge 1 commit into
mainfrom
docs/guidestar-only-header-faq
Open

docs: document x-api-experimental GuideStar-only header#1149
codyborn wants to merge 1 commit into
mainfrom
docs/guidestar-only-header-faq

Conversation

@codyborn

Copy link
Copy Markdown
Contributor

Summary

Uniswap/backend#11443 shipped an x-api-experimental header on /quote that forces a GuideStar-only quote. The parameter itself is in the OpenAPI spec served at trade-api.gateway.uniswap.org/v1/api.json (so it already surfaces on the auto-generated /quote reference), but nothing in the FAQ pointed integrators at it.

This adds one FAQ entry, in both the structured faqs: frontmatter list and the matching <details> block, under Quotes and Quoting, right after the existing native-token FAQ (same section, same pattern as the x-erc20eth-enabled entry).

Covers:

  • how to set the header and its one prerequisite header
  • EXACT_INPUT / mainnet-only eligibility
  • fail-closed behavior (400 on unmet prerequisite, 404 if GuideStar can't serve, no UniRoute/other-order-type fallback)
  • that it's experimental/unstable and to reach out before relying on it in production

Test plan

  • Verified live against prod (trade-api.gateway.uniswap.org) that x-api-experimental: true + x-universal-router-swapsteps: true on a mainnet EXACT_INPUT quote returns a GuideStar-served quote, and that missing prerequisites 400 as documented.
  • Docs preview renders correctly.

馃 Generated with Claude Code

Adds a Quotes and Quoting FAQ entry for the x-api-experimental header
shipped in Uniswap/backend#11443, so integrators know how to force a
GuideStar-only quote and what its prerequisites and failure modes are.
@github-actions

Copy link
Copy Markdown

Thanks for contributing to Uniswap Docs! 馃

Quick heads up on how this repo works: the docs you see on developers.uniswap.org are built from a separate source repo. When we accept a change here, we port it over there, so your fix might show up on the live site before it lands in this repo.

Updates to this repo come in batches on a regular cadence. When yours is included, you'll be credited as a co-author on the commit, so the contribution counts on your GitHub profile and in Uniswap/docs.

We review every PR but can't merge everything. Either way, someone from the docs team will follow up here once we've taken a look.

One legal bit: by submitting a PR you agree your contribution is licensed under the repo's MIT license.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant