Skip to content

Update documentation to match current SDK state#1919

Merged
ryanio merged 2 commits intomainfrom
docs/update-documentation-accuracy
Feb 27, 2026
Merged

Update documentation to match current SDK state#1919
ryanio merged 2 commits intomainfrom
docs/update-documentation-accuracy

Conversation

@ryanio
Copy link
Collaborator

@ryanio ryanio commented Feb 27, 2026

Summary

  • Fix inaccurate code examples and return types in developer docs to match current SDK implementation
  • Add missing documentation for Token API (getTrendingTokens, getTopTokens, getSwapQuote, getToken) and Search API (search) endpoints
  • Add missing parameters across multiple endpoints (includePrivateListings, traits/numericTraits, generateFulfillmentData params)
  • Replace fragile line-number GitHub links with stable file-level links

Details

Fixes:

  • getting-started.md: "Fetching an Order by Hash" example incorrectly used getOrder() with non-existent params — fixed to use getOrderByHash()
  • api-reference.md: getCollectionOffers return type was ListCollectionOffersResponse | null but actual return is GetOffersResponse; also added missing limit/next params
  • faq.md: GitHub links pointed to specific line numbers that were outdated — replaced with stable file-level links referencing method/type names

New documentation:

  • Token Endpoints: getTrendingTokens, getTopTokens, getSwapQuote, getToken
  • Search Endpoint: search across collections, tokens, NFTs, and accounts
  • Multi-trait offers (traits array) and numeric trait offers (numericTraits) for buildOffer, postCollectionOffer, and createCollectionOffer
  • includePrivateListings param on getAllListings, getBestListing, getBestListings, getNFTListings
  • unitsToFill, recipientAddress, includeOptionalCreatorFees params on generateFulfillmentData

Test plan

  • Verify all code examples compile against current SDK types
  • Verify all documented method signatures match actual source code
  • Verify all links resolve correctly

🤖 Generated with Claude Code

ryanio and others added 2 commits February 27, 2026 09:42
Fix inaccuracies and add missing documentation for recently added features:
- Fix getOrder by hash example to use correct getOrderByHash method
- Fix getCollectionOffers return type and add missing pagination params
- Add Token API endpoints (getTrendingTokens, getTopTokens, getSwapQuote, getToken)
- Add Search API endpoint documentation
- Add multi-trait and numeric trait offer params to buildOffer/postCollectionOffer
- Add includePrivateListings param to listing endpoints
- Add missing generateFulfillmentData params
- Fix FAQ GitHub line reference for GET/POST methods

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Line number references break whenever the file changes. Link to the
file and reference method/type names instead.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@ryanio ryanio merged commit 061f013 into main Feb 27, 2026
8 checks passed
@ryanio ryanio deleted the docs/update-documentation-accuracy branch February 27, 2026 14:46
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