Skip to content

docs(hyperliquid): add 4 missing HL method pages (approvedBuilders, perpConciseAnnotations, settledOutcome, userOutcome)#463

Merged
akegaviar merged 1 commit into
mainfrom
docs/hl-new-method-pages
Jun 24, 2026
Merged

docs(hyperliquid): add 4 missing HL method pages (approvedBuilders, perpConciseAnnotations, settledOutcome, userOutcome)#463
akegaviar merged 1 commit into
mainfrom
docs/hl-new-method-pages

Conversation

@akegaviar

Copy link
Copy Markdown
Member

Adds reference pages for 4 methods that exist in the official Hyperliquid docs and the @nktkas/hyperliquid SDK but were missing from our reference (found in the coverage audit). Each = page + OpenAPI spec + nav entry, examples verified live.

New pages

info — Chainstack-served (Case A: code uses YOUR_CHAINSTACK_ENDPOINT + endpoint note)

Method Params Verified
approvedBuilders user live: ["0x1cc34f…cda1f"] via curl, Python (info.post), and nktkas
perpConciseAnnotations none live: [["flx:BTC",{"category":"crypto"}], …] via all three
settledOutcome outcome live: {spec, settleFraction, details} via all three

exchange — public-only signing action (Case B)

Method Operations Verified
userOutcome splitOutcome / mergeOutcome / mergeQuestion / negateOutcome signature-checked against nktkas (ExchangeClient.userOutcome present); not executed — it moves funds

Conventions followed

  • info pages model the Case-A pattern (curl → public Chainstack endpoint unchanged; Python/TS → YOUR_CHAINSTACK_ENDPOINT + the standard endpoint <Note>). Python uses info.post("/info", …) since the SDK has no dedicated helpers; TS uses the native nktkas InfoClient methods.
  • userOutcome models the exchange pattern (HL-public-only <Info> + signing <Note>; Python via sign_l1_action + _post_action since the Python SDK has no helper; TS via ExchangeClient.userOutcome).
  • Specs use OpenAPI 3.0 (nullable: true, no type: null); all JSON validated; nav entries added once each.

Companion to #462 (the 4 flagged-page fixes).

Create reference pages (page + OpenAPI spec + nav) for methods present in
the official Hyperliquid docs and the @nktkas/hyperliquid SDK but missing
from our reference. Examples verified live against the public endpoint.

info (Chainstack-served, Case A):
- approvedBuilders — builders a user has approved (user param)
- perpConciseAnnotations — per-asset category/displayName/keywords
- settledOutcome — outcome-market spec + settlement (outcome param)

exchange (signing action, public-only):
- userOutcome — split/merge/negate outcome-market shares (4 operations)

info examples: hyperliquid-python-sdk (info.post) + @nktkas/hyperliquid,
both run live and return the documented data. userOutcome: signature-checked
against the SDKs (never executed — it moves funds).
@infra-bot-atlantis

Copy link
Copy Markdown
Error: This repo is not allowlisted for Atlantis.

@coderabbitai

coderabbitai Bot commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

@akegaviar, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 51 minutes and 10 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 79b7db38-317a-4c6c-906c-c2e14ee1dead

📥 Commits

Reviewing files that changed from the base of the PR and between 52faa09 and 2d914c6.

📒 Files selected for processing (9)
  • docs.json
  • openapi/hyperliquid_node_api/hypercore_exchange/exchange_user_outcome.json
  • openapi/hyperliquid_node_api/hypercore_info/info_approved_builders.json
  • openapi/hyperliquid_node_api/hypercore_info/info_perp_concise_annotations.json
  • openapi/hyperliquid_node_api/hypercore_info/info_settled_outcome.json
  • reference/hyperliquid-exchange-user-outcome.mdx
  • reference/hyperliquid-info-approved-builders.mdx
  • reference/hyperliquid-info-perp-concise-annotations.mdx
  • reference/hyperliquid-info-settled-outcome.mdx
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/hl-new-method-pages

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@mintlify

mintlify Bot commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
chainstack 🟢 Ready View Preview Jun 24, 2026, 7:12 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant