---
title: "Fetch offers"
method: GET
path: "/atomicassets/v1/offers"
tags: ["offers"]
---

# Fetch offers

`GET /atomicassets/v1/offers`

## Query parameters

- `account` string
- `sender` string
- `recipient` string
- `memo` string
- `match_memo` string
- `state` string
- `is_recipient_contract` boolean
- `asset_id` string
- `template_id` string
- `schema_name` string
- `collection_name` string
- `account_whitelist` string
- `account_blacklist` string
- `sender_asset_whitelist` string
- `sender_asset_blacklist` string
- `recipient_asset_whitelist` string
- `recipient_asset_blacklist` string
- `hide_contracts` boolean
- `hide_empty_offers` boolean
- `offer_id` string
- `ids` string
- `lower_bound` string
- `upper_bound` string
- `before` integer
- `after` integer
- `collection_blacklist` string
- `collection_whitelist` string
- `page` integer
- `limit` integer
- `order` 'asc' | 'desc'
- `sort` 'created' | 'updated'

## Response `200`

OK

- object
  - `success` boolean
  - `data` Offer[]
    - `contract` string
    - `offer_id` string
    - `sender_name` string
    - `recipient_name` string
    - `memo` string
    - `state` integer
    - `is_sender_contract` boolean
    - `is_recipient_contract` boolean
    - `sender_assets` Asset[]
      - `contract` string
      - `asset_id` string
      - `owner` string
      - `name` string
      - `is_transferable` boolean
      - `is_burnable` boolean
      - `template_mint` string
      - `collection` object
        - `collection_name` string
        - `name` string
        - `author` string
        - `allow_notify` boolean
        - `authorized_accounts` string[]
        - `notify_accounts` string[]
        - `market_fee` number
        - `created_at_block` string
        - `created_at_time` string
      - `schema` object
        - `schema_name` string
        - `format` object[]
          - `name` string
          - `type` string
        - `created_at_block` string
        - `created_at_time` string
      - `template` object
        - `template_id` string
        - `max_supply` string
        - `issued_supply` string
        - `is_transferable` boolean
        - `is_burnable` boolean
        - `immutable_data` object
        - `created_at_time` string
        - `created_at_block` string
      - `backed_tokens` object[]
        - `token_contract` string
        - `token_symbol` string
        - `token_precision` integer
        - `amount` string
      - `immutable_data` object
      - `mutable_data` object
      - `data` object
      - `burned_by_account` string
      - `burned_at_block` string
      - `burned_at_time` string
      - `updated_at_block` string
      - `updated_at_time` string
      - `transferred_at_block` string
      - `transferred_at_time` string
      - `minted_at_block` string
      - `minted_at_time` string
    - `recipient_assets` Asset[]
      - `contract` string
      - `asset_id` string
      - `owner` string
      - `name` string
      - `is_transferable` boolean
      - `is_burnable` boolean
      - `template_mint` string
      - `collection` object
        - `collection_name` string
        - `name` string
        - `author` string
        - `allow_notify` boolean
        - `authorized_accounts` string[]
        - `notify_accounts` string[]
        - `market_fee` number
        - `created_at_block` string
        - `created_at_time` string
      - `schema` object
        - `schema_name` string
        - `format` object[]
          - `name` string
          - `type` string
        - `created_at_block` string
        - `created_at_time` string
      - `template` object
        - `template_id` string
        - `max_supply` string
        - `issued_supply` string
        - `is_transferable` boolean
        - `is_burnable` boolean
        - `immutable_data` object
        - `created_at_time` string
        - `created_at_block` string
      - `backed_tokens` object[]
        - `token_contract` string
        - `token_symbol` string
        - `token_precision` integer
        - `amount` string
      - `immutable_data` object
      - `mutable_data` object
      - `data` object
      - `burned_by_account` string
      - `burned_at_block` string
      - `burned_at_time` string
      - `updated_at_block` string
      - `updated_at_time` string
      - `transferred_at_block` string
      - `transferred_at_time` string
      - `minted_at_block` string
      - `minted_at_time` string
    - `updated_at_block` string
    - `updated_at_time` string
    - `created_at_block` string
    - `created_at_time` string
  - `query_time` integer, nullable

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.net/worldwide-asset-exchange/apis/atomicassets-api.md) · [All operations](https://skmtc.net/worldwide-asset-exchange/apis/atomicassets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worldwide-asset-exchange/atomicassets-api/versions/6e5b195ccabb/schema)