`get_offers`

Reads offer listings from the Boson subgraph. Supports pagination, ordering, and filtering (e.g. by sellerId). Read-only. Returns: array of offers with price, deposit, dates, and quantity.

Category: Offer management. Returns unsigned tx? No — read-only or returns signed payload.

Input schema

Field	Type	Required	Description
`offersSkip`	number	no
`offersFirst`	number	no
`offersOrderBy`	`agentFee` \| `agentId` \| `buyer` \| `buyerCancelPenalty` \| `buyerId` \| `buyer__active` \| `buyer__id` \| `buyer__wallet` \| `collection` \| `collectionIndex` \| `collection__collectionIndex` \| `collection__externalId` \| `collection__externalIdHash` \| `collection__id` \| `collection__sellerId` \| `condition` \| `condition__gatingType` \| `condition__id` \| `condition__maxCommits` \| `condition__maxTokenId` \| `condition__method` \| `condition__minTokenId` \| `condition__threshold` \| `condition__tokenAddress` \| `condition__tokenType` \| `createdAt` \| `creator` \| `disputePeriodDuration` \| `disputeResolutionTerms` \| `disputeResolutionTerms__buyerEscalationDeposit` \| `disputeResolutionTerms__disputeResolverId` \| `disputeResolutionTerms__escalationResponsePeriod` \| `disputeResolutionTerms__feeAmount` \| `disputeResolutionTerms__id` \| `disputeResolutionTerms__mutualizerAddress` \| `disputeResolver` \| `disputeResolverId` \| `disputeResolver__active` \| `disputeResolver__admin` \| `disputeResolver__assistant` \| `disputeResolver__clerk` \| `disputeResolver__escalationResponsePeriod` \| `disputeResolver__id` \| `disputeResolver__metadataUri` \| `disputeResolver__treasury` \| `exchangeToken` \| `exchangeToken__address` \| `exchangeToken__decimals` \| `exchangeToken__id` \| `exchangeToken__name` \| `exchangeToken__symbol` \| `exchanges` \| `id` \| `metadata` \| `metadataHash` \| `metadataUri` \| `metadata__animationUrl` \| `metadata__condition` \| `metadata__createdAt` \| `metadata__description` \| `metadata__externalUrl` \| `metadata__id` \| `metadata__image` \| `metadata__licenseUrl` \| `metadata__name` \| `metadata__numberOfCommits` \| `metadata__numberOfRedemptions` \| `metadata__quantityAvailable` \| `metadata__schemaUrl` \| `metadata__type` \| `metadata__validFromDate` \| `metadata__validUntilDate` \| `metadata__voided` \| `numberOfCommits` \| `numberOfRedemptions` \| `price` \| `priceType` \| `protocolFee` \| `quantityAvailable` \| `quantityInitial` \| `range` \| `range__end` \| `range__id` \| `range__minted` \| `range__owner` \| `range__start` \| `resolutionPeriodDuration` \| `royaltyInfos` \| `seller` \| `sellerDeposit` \| `sellerId` \| `seller__active` \| `seller__admin` \| `seller__assistant` \| `seller__authTokenId` \| `seller__authTokenType` \| `seller__clerk` \| `seller__id` \| `seller__metadataUri` \| `seller__sellerId` \| `seller__treasury` \| `seller__voucherCloneAddress` \| `validFromDate` \| `validUntilDate` \| `voided` \| `voidedAt` \| `voucherRedeemableFromDate` \| `voucherRedeemableUntilDate` \| `voucherValidDuration`	no
`offersOrderDirection`	`asc` \| `desc`	no
`offersFilter`	object	no
`includeExchanges`	boolean	no
`exchangesSkip`	number	no
`exchangesFirst`	number	no
`exchangesOrderBy`	`buyer` \| `buyer__active` \| `buyer__id` \| `buyer__wallet` \| `cancelledDate` \| `committedDate` \| `completedDate` \| `dispute` \| `disputeResolver` \| `disputeResolver__active` \| `disputeResolver__admin` \| `disputeResolver__assistant` \| `disputeResolver__clerk` \| `disputeResolver__escalationResponsePeriod` \| `disputeResolver__id` \| `disputeResolver__metadataUri` \| `disputeResolver__treasury` \| `dispute__buyerPercent` \| `dispute__decidedDate` \| `dispute__disputedDate` \| `dispute__escalatedDate` \| `dispute__exchangeId` \| `dispute__finalizedDate` \| `dispute__id` \| `dispute__refusedDate` \| `dispute__resolvedDate` \| `dispute__retractedDate` \| `dispute__state` \| `dispute__timeout` \| `disputed` \| `disputedDate` \| `expired` \| `finalizedDate` \| `id` \| `mutualizerAddress` \| `offer` \| `offer__agentFee` \| `offer__agentId` \| `offer__buyerCancelPenalty` \| `offer__buyerId` \| `offer__collectionIndex` \| `offer__createdAt` \| `offer__creator` \| `offer__disputePeriodDuration` \| `offer__disputeResolverId` \| `offer__id` \| `offer__metadataHash` \| `offer__metadataUri` \| `offer__numberOfCommits` \| `offer__numberOfRedemptions` \| `offer__price` \| `offer__priceType` \| `offer__protocolFee` \| `offer__quantityAvailable` \| `offer__quantityInitial` \| `offer__resolutionPeriodDuration` \| `offer__sellerDeposit` \| `offer__sellerId` \| `offer__validFromDate` \| `offer__validUntilDate` \| `offer__voided` \| `offer__voidedAt` \| `offer__voucherRedeemableFromDate` \| `offer__voucherRedeemableUntilDate` \| `offer__voucherValidDuration` \| `protocolFeeCollected` \| `protocolFeeCollected__amount` \| `protocolFeeCollected__exchangeId` \| `protocolFeeCollected__exchangeToken` \| `protocolFeeCollected__executedBy` \| `protocolFeeCollected__id` \| `redeemedDate` \| `revokedDate` \| `seller` \| `seller__active` \| `seller__admin` \| `seller__assistant` \| `seller__authTokenId` \| `seller__authTokenType` \| `seller__clerk` \| `seller__id` \| `seller__metadataUri` \| `seller__sellerId` \| `seller__treasury` \| `seller__voucherCloneAddress` \| `state` \| `validUntilDate`	no
`exchangesOrderDirection`	`asc` \| `desc`	no
`exchangesFilter`	object	no
`configId`	string	yes	Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server.

Reference → MCP tools — full catalogue.
Build for AI agents → The 3-step signing pattern — what to do with returned unsigned transactions.
Concepts → Signing & meta-transactions — canonical signing reference.

Input schema

Related