get_exchanges
Reads exchange records (offer commitments) from the Boson subgraph. Filter by buyer/seller/state. Read-only. Returns: array of exchanges with offerId, state (Committed/Redeemed/Completed/Disputed/Cancelled/Revoked), and voucher details.
Category: Exchange management. Returns unsigned tx? No — read-only or returns signed payload.
Input schema
| Field | Type | Required | Description |
|---|---|---|---|
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. |
Related
- 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.