Rarible Agentic Access
Rarible exposes 92 API operations that an AI agent could call, of which 27 are state-changing ‘acting’ operations. This is a recommended x-agentic-access execution contract — the scope, audience, consequence tier, short-lived token constraints, and escalation each action should carry before it is handed to an autonomous agent.
By consequence: 65 read, 15 write, 9 physical, and 3 safety-critical.
3 operations are classed safety-critical and should require human-in-the-loop approval at runtime.
Contracts are classified heuristically from the provider’s OpenAPI and refresh on every APIs.io network build; audience is bound per deployment. The model follows Curity’s Access Intelligence (apidays Munich 2026). Browse every provider’s agent contracts at agentic-access.apis.io.
By consequence
Highest-consequence actions
The physical and safety-critical operations an agent could invoke — the ones that most warrant scoped tokens, tight TTLs, and escalation. Full per-operation contracts are in the source below.
| Method | Path | Consequence | Human-in-loop |
|---|---|---|---|
| DELETE | /v0.1/collections/{collection}/refreshMeta | safety-critical | required |
| DELETE | /v0.1/collections/{collection}/resetMeta | safety-critical | required |
| DELETE | /v0.1/items/{itemId}/resetMeta | safety-critical | required |
| POST | /v0.1/encode/order | physical | conditional |
| POST | /v0.1/orders | physical | conditional |
| POST | /v0.1/orders/byIds | physical | conditional |
| POST | /v0.1/orders/{id}/prepareCancelTx | physical | conditional |
| POST | /v0.1/orders/{id}/prepareTx | physical | conditional |
| POST | /v0.1/orders/{id}/report | physical | conditional |
| POST | /v0.1/ownerships/byIds | physical | conditional |
| POST | /v0.1/ownerships/search | physical | conditional |
| POST | /v0.1/signature/validate | physical | conditional |
Source
Agentic Access
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