generated: '2026-07-15' method: generated source: openapi/openapi.yaml description: Recommended x-agentic-access execution contracts, classified heuristically from the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind audience per deployment. See research/curity/agentic-governance/. summary: operations: 92 by_action_class: connected: 65 acting: 27 by_consequence: read: 65 write: 15 safety-critical: 3 physical: 9 human_in_the_loop_required: 3 operations: - path: /v0.1/items/{itemId} method: get operationId: getItemById x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/items/byIds method: post operationId: getItemByIds x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/items/{itemId}/royalties method: get operationId: getItemRoyaltiesById x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/items/{itemId}/resetMeta method: delete operationId: resetItemMeta x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /v0.1/items/byOwner method: get operationId: getItemsByOwner x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/items/byCreator method: get operationId: getItemsByCreator x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/items/byCollection method: get operationId: getItemsByCollection x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/items/byOwnerWithOwnership method: get operationId: getItemsByOwnerWithOwnership x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/items/all method: get operationId: getAllItems x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/items/traits method: get operationId: queryTraits x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/items/traits/search method: get operationId: searchTraits x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/items/traits/rarity method: post operationId: queryTraitsWithRarity x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/items/search method: post operationId: searchItems x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/items/search/duplicates method: post operationId: searchDuplicatedItems x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/items/lazy/{itemId} method: get operationId: getLazyItemById x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/items/lazy/mint method: post operationId: mintLazyItem x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/items/lazy/burn method: post operationId: burnLazyItem x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/ownerships/{ownershipId} method: get operationId: getOwnershipById x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/ownerships/byIds method: post operationId: getOwnershipsByIds x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/ownerships/byCollection method: get operationId: getOwnershipsByCollection x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/ownerships/byItem method: get operationId: getOwnershipsByItem x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/ownerships/search method: post operationId: searchOwnerships x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/ownerships/collections method: get operationId: getCollectionsWithOwnedItems x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/{id} method: get operationId: getOrderById x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/{id}/prepareTx method: post operationId: prepareOrderTransaction x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/orders/{id}/prepareCancelTx method: post operationId: prepareOrderCancelTransaction x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/orders/{id}/report method: post operationId: reportOrderById x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/orders method: post operationId: upsertOrder x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/orders/{id}/validate method: get operationId: getValidatedOrderById x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/byIds method: post operationId: getOrdersByIds x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/orders/all method: get operationId: getOrdersAll x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/sync method: get operationId: getAllSync x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/sell/byMaker method: get operationId: getSellOrdersByMaker x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/sell/byItem method: get operationId: getSellOrdersByItem x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/sell method: get operationId: getSellOrders x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/bids/byMaker method: get operationId: getOrderBidsByMaker x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/bids/byItem method: get operationId: getOrderBidsByItem x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/floorBids/byCollection method: get operationId: getOrderFloorBidsByCollection x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/settings/fees method: get operationId: getOrderFees x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/history/bestActiveAtTime method: get operationId: getBestActiveOrdersAtTime x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/history/closestActiveAtTime/byOrder method: get operationId: getClosestActiveOrdersAtTimeByOrder x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/orders/history/closestActiveAtTime/byPrice method: get operationId: getClosestActiveOrdersAtTimeByPrice x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/activities/byUser method: get operationId: getActivitiesByUser x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/activities/byUsers method: post operationId: getActivitiesByUsers x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/activities/byItem method: get operationId: getActivitiesByItem x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/activities/byCollection method: get operationId: getActivitiesByCollection x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/activities/sync method: get operationId: getAllActivitiesSync x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/activities/all method: get operationId: getAllActivities x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/collections/{id}/charts/sales method: get operationId: getSalesChart x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/activities/search method: post operationId: searchActivities x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/activities/search/count method: post operationId: searchActivitiesCount x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/collections/{collection} method: get operationId: getCollectionById x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/collections/{collection}/generateTokenId method: get operationId: generateTokenId x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/collections/{collection}/refreshMeta method: delete operationId: refreshCollectionItemsMeta x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /v0.1/collections/{collection}/resetMeta method: delete operationId: resetCollectionMeta x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /v0.1/collections/byOwner method: get operationId: getCollectionsByOwner x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/collections/all method: get operationId: getAllCollections x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/collections/search method: post operationId: searchCollection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/data/rankings/{entity}/volume method: get operationId: getUserRankingByVolume x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/data/rankings/collections/volume method: get operationId: getCollectionRankingByVolume x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v2.0/data/leaderboard/collections method: get operationId: getCollectionLeaderboard x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v2.0/data/leaderboard/collections/byOwner method: get operationId: getCollectionLeaderboardByOwner x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v2.0/data/collections/{id}/statistics/global method: get operationId: getGlobalCollectionStatistics x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v2.0/data/collections/statistics/global/byIds method: post operationId: getGlobalCollectionStatisticsByIds x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2.0/data/collections/statistics/aggregated method: post operationId: getCollectionsAggregatedStatistics x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2.0/data/collections/{id}/statistics/period method: get operationId: getPeriodCollectionStatistics x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v2.0/data/collections/statistics/period/byIds method: post operationId: getPeriodCollectionStatisticsByIds x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2.0/data/collections/{id}/owners method: get operationId: getOwners x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v2.0/data/collections/{id}/bidsByPrice method: get operationId: getBidsByPrice x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v2.0/data/collections/{id}/charts/floorPrice method: get operationId: getFloorPriceChart x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v2.0/data/collections/{id}/charts/volume method: get operationId: getVolumeChart x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/data/collections/{collection}/transactions method: get operationId: getTransactions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/data/collections/{collection}/stats method: get operationId: getCollectionStats x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/data/collections/{collection}/statistics method: get operationId: getCollectionStatistics x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/data/collections/{collection}/sellers method: get operationId: getSellers x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/data/collections/{collection}/gmv method: get operationId: getGmv x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/data/collections/{collection}/floorPrice method: get operationId: getFloorPrice x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/data/collections/{collection}/buyers method: get operationId: getBuyers x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/data/collections/{collection}/listed method: get operationId: getListed x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/domains/{domain}/resolution method: post operationId: resolve x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/signature/validate method: post operationId: validate x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/signature/input method: post operationId: getInput x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/encode/order method: post operationId: encode x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v0.1/currencies/{currencyId}/rates/usd method: get operationId: getUsdRate x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/currencies/all method: get operationId: getAllCurrencies x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/balances/{currencyId}/{owner} method: get operationId: getBalance x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/points/rewards method: get operationId: getPointsRewards x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/points/rewards/{address} method: get operationId: getPointsRewardsByAddress x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/points/claim/signature method: get operationId: getClaimSignature x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/reconciliation/items method: get operationId: getReconciliationItems x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/reconciliation/collections method: get operationId: getReconciliationCollections x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v0.1/blocks/latestIndexed method: get operationId: getLatestIndexedBlock x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none