List open offers of an address

cURL

curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/accounts/GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV/offers?limit=10' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
const res = await fetch('https://assets-testnet.lumeus.dev/accounts/GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV/offers?limit=10', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

import json
import os

import requests

res = requests.get(
    "https://assets-testnet.lumeus.dev/accounts/GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV/offers?limit=10",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "_embedded": {
    "records": [
      {
        "amount": "162979.0000000",
        "amount_raw": "1629790000000",
        "buying": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "flags": 0,
        "last_modified_ledger": 5332365,
        "offer_id": "929843",
        "paging_token": "OTI5ODQz",
        "price": "0.0613576",
        "price_d": 162979,
        "price_n": 10000,
        "seller": "GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV",
        "selling": "CETES:GC3CW7EDYRTWQ635VDIGY6S4ZUF5L6TQ7AA4MWS7LEQDBLUSZXV7UPS4"
      },
      {
        "amount": "43266.0000000",
        "amount_raw": "432660000000",
        "buying": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "flags": 0,
        "last_modified_ledger": 5332366,
        "offer_id": "929844",
        "paging_token": "OTI5ODQ0",
        "price": "0.2311284",
        "price_d": 43266,
        "price_n": 10000,
        "seller": "GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV",
        "selling": "TESOURO:GC3CW7EDYRTWQ635VDIGY6S4ZUF5L6TQ7AA4MWS7LEQDBLUSZXV7UPS4"
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/accounts/GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV/offers?limit=10"
    }
  },
  "address": "GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV",
  "limit": 10,
  "read_view": {
    "network": "testnet",
    "generation": "assets-testnet-v1-5253887",
    "as_of_ledger": 5332631,
    "as_of_closed_at": "2026-10-22T16:32:22Z",
    "bootstrap_ledger": 5253887
  }
}

GET

accounts

{address}

offers

cURL

curl --fail-with-body -sS 'https://assets-testnet.lumeus.dev/accounts/GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV/offers?limit=10' \
  -H "Authorization: Bearer $LUMEUS_API_KEY"

// Node 18+ (ES module)
const res = await fetch('https://assets-testnet.lumeus.dev/accounts/GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV/offers?limit=10', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_API_KEY}`,
  },
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

import json
import os

import requests

res = requests.get(
    "https://assets-testnet.lumeus.dev/accounts/GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV/offers?limit=10",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_API_KEY']}"},
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "_embedded": {
    "records": [
      {
        "amount": "162979.0000000",
        "amount_raw": "1629790000000",
        "buying": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "flags": 0,
        "last_modified_ledger": 5332365,
        "offer_id": "929843",
        "paging_token": "OTI5ODQz",
        "price": "0.0613576",
        "price_d": 162979,
        "price_n": 10000,
        "seller": "GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV",
        "selling": "CETES:GC3CW7EDYRTWQ635VDIGY6S4ZUF5L6TQ7AA4MWS7LEQDBLUSZXV7UPS4"
      },
      {
        "amount": "43266.0000000",
        "amount_raw": "432660000000",
        "buying": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
        "flags": 0,
        "last_modified_ledger": 5332366,
        "offer_id": "929844",
        "paging_token": "OTI5ODQ0",
        "price": "0.2311284",
        "price_d": 43266,
        "price_n": 10000,
        "seller": "GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV",
        "selling": "TESOURO:GC3CW7EDYRTWQ635VDIGY6S4ZUF5L6TQ7AA4MWS7LEQDBLUSZXV7UPS4"
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/accounts/GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV/offers?limit=10"
    }
  },
  "address": "GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV",
  "limit": 10,
  "read_view": {
    "network": "testnet",
    "generation": "assets-testnet-v1-5253887",
    "as_of_ledger": 5332631,
    "as_of_closed_at": "2026-10-22T16:32:22Z",
    "bootstrap_ledger": 5253887
  }
}

Authorizations

Authorization

string

header

required

Send Authorization: Bearer <key>, the same keys as Activity and RPC. Testnet: lum_test_…; Mainnet: lum_live_…. A key works only on its own network, so pick the server that matches it (the other network answers 401). Publishable lum_pub_… keys work only on the routes marked "Publishable keys allowed", from an allowed browser origin.

Path Parameters

address

string

required

Checksum-valid G or C address. An M… address resolves to its G account and the response carries muxed_input. B… and L… addresses are never holders.

Example:

"GBPAFJ3COSPSNDXZIPD36553DTM72W3R5WF2JU2L5SBGOLNR42ZORDTV"

Query Parameters

limit

integer

default:50

Records per page, 1 to 200 (default 50).

Required range: 1 <= x <= 200

Example:

10

cursor

string

Resume after this paging_token. Prefer following _links.next.href.

Response

A page of open offers.

read_view

object

required

Show child attributes

limit

integer

required

Effective page size: default 50, maximum 200.

_links

object

required

Show child attributes

_embedded

object

required

Show child attributes

address

string

required

The looked-up address (G or C; an M… input resolves to its G account).

Activity API

Assets API

Webhooks

RPC

Account

List open offers of an address

Authorizations

Path Parameters

Query Parameters

Response