v1

latestOpenAPI 3.0.0raw.githubusercontent.com2025-08-296916379.5 KB
offers

Fetch offers

get/atomicassets/v1/offers

Query parameters

accountstring

Notified account (can be sender or recipient) - separate multiple with ","

senderstring

Offer sender - separate multiple with ","

recipientstring

Offer recipient - separate multiple with ","

memostring

Search for exact memo

match_memostring

Search for text in memo

statestring

Filter by Offer State (0: PENDING - Offer created and valid, 1: INVALID - Assets are missing because ownership has changed, 2: UNKNOWN - Offer is not valid anymore, 3: ACCEPTED - Offer was accepted, 4: DECLINED - Offer was declined by recipient, 5: CANCELLED - Offer was canceled by sender) - separate multiple with ","

is_recipient_contractboolean

Filter offers where recipient is a contract

asset_idstring

only offers which contain this asset_id - separate multiple with ","

template_idstring

only offers which contain assets of this template - separate multiple with ","

schema_namestring

only offers which contain assets of this schema - separate multiple with ","

collection_namestring

only offers which contain assets of this collection - separate multiple with ","

account_whiteliststring

Only offers which are sent by one of these accounts

account_blackliststring

Exclude offers which are sent by one of these accounts

sender_asset_whiteliststring

Only offers which contain these assets

sender_asset_blackliststring

Exclude offers which contain these assets

recipient_asset_whiteliststring

Only offers which contain these assets

recipient_asset_blackliststring

Exclude offers which contain these assets

hide_contractsboolean

dont show offers from or to accounts that have code deployed

hide_empty_offersboolean

dont show offers where one side is empty

offer_idstring

seperate multiple ids with ","

idsstring

seperate multiple ids with ","

lower_boundstring

lower bound of primary key (value included)

upper_boundstring

upper bound of primary key (value excluded)

beforeinteger

Only show results before this timestamp in milliseconds (value excluded)

afterinteger

Only show results after this timestamp in milliseconds (value excluded)

collection_blackliststring

Hide collections from result. Split multiple with ","

collection_whiteliststring

Show only results from specific collections. Split multiple with ","

pageinteger

Result Page

limitinteger

Results per Page

order'asc' | 'desc'

Order direction

sort'created' | 'updated'

Column to sort

Response

OK

successboolean
query_timeinteger nullable