opensea-cli 0.1.0 → 0.1.5

package/README.md

@@ -11,25 +11,7 @@ npm install -g opensea-cli
 Or use without installing:
 
 ```bash
-npx opensea-cli collections get boredapeyachtclub
-```
-
-## Local Development
-
-To test locally without publishing:
-
-```bash
-git clone https://github.com/ProjectOpenSea/opensea-cli.git
-cd opensea-cli
-npm install && npm run build
-export OPENSEA_API_KEY=your-api-key
-
-# Run directly with Node
-node dist/cli.js collections get tiny-dinos-eth
-
-# Or link globally to use the `opensea` command
-npm link
-opensea collections get tiny-dinos-eth
+npx opensea-cli collections get mfers
 ```
 
 ## Authentication
@@ -38,10 +20,10 @@ Set your API key via environment variable or flag:
 
 ```bash
 export OPENSEA_API_KEY=your-api-key
-opensea collections get boredapeyachtclub
+opensea collections get mfers
 
 # or pass inline
-opensea --api-key your-api-key collections get boredapeyachtclub
+opensea --api-key your-api-key collections get mfers
 ```
 
 Get an API key at [docs.opensea.io](https://docs.opensea.io/reference/api-keys).
@@ -103,6 +85,20 @@ opensea events by-collection <slug> [--event-type <type>]
 opensea events by-nft <chain> <contract> <token-id> [--event-type <type>]
 ```
 
+### Tokens
+
+```bash
+opensea tokens trending [--chains <chains>] [--limit <n>] [--cursor <cursor>]
+opensea tokens top [--chains <chains>] [--limit <n>] [--cursor <cursor>]
+opensea tokens get <chain> <address>
+```
+
+### Swaps
+
+```bash
+opensea swaps quote --from-chain <chain> --from-address <address> --to-chain <chain> --to-address <address> --quantity <quantity> --address <address> [--slippage <slippage>] [--recipient <recipient>]
+```
+
 ### Accounts
 
 ```bash
@@ -118,12 +114,12 @@ import { OpenSeaCLI } from "opensea-cli"
 
 const client = new OpenSeaCLI({ apiKey: process.env.OPENSEA_API_KEY })
 
-const collection = await client.collections.get("boredapeyachtclub")
-const stats = await client.collections.stats("boredapeyachtclub")
-const nfts = await client.nfts.listByCollection("boredapeyachtclub", { limit: 5 })
-const listings = await client.listings.best("boredapeyachtclub", { limit: 10 })
-const events = await client.events.byCollection("boredapeyachtclub", { eventType: "sale" })
-const account = await client.accounts.get("0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045")
+const collection = await client.collections.get("mfers")
+const stats = await client.collections.stats("mfers")
+const nfts = await client.nfts.listByCollection("mfers", { limit: 5 })
+const listings = await client.listings.best("mfers", { limit: 10 })
+const events = await client.events.byCollection("mfers", { eventType: "sale" })
+const account = await client.accounts.get("0x21130e908bba2d41b63fbca7caa131285b8724f8")
 ```
 
 ## Output Formats
@@ -131,7 +127,7 @@ const account = await client.accounts.get("0xd8dA6BF26964aF9D7eEd9e03E53415D37aA
 JSON (default) - structured output for agents and scripts:
 
 ```bash
-opensea collections get boredapeyachtclub
+opensea collections get mfers
 ```
 
 Table - human-readable output:
@@ -173,7 +169,7 @@ opensea nfts list-by-collection tiny-dinos-eth --limit 2
 opensea nfts list-by-contract ethereum 0xd9b78a2f1dafc8bb9c60961790d2beefebee56f4 --limit 2
 
 # List NFTs owned by an account
-opensea nfts list-by-account ethereum 0xde7fce3a1cba4a705f299ce41d163017f165d666 --limit 2
+opensea nfts list-by-account ethereum 0x21130e908bba2d41b63fbca7caa131285b8724f8 --limit 2
 
 # Get contract details
 opensea nfts contract ethereum 0xd9b78a2f1dafc8bb9c60961790d2beefebee56f4
@@ -224,14 +220,33 @@ opensea events by-collection tiny-dinos-eth --limit 2
 opensea events by-nft ethereum 0xd9b78a2f1dafc8bb9c60961790d2beefebee56f4 1 --limit 2
 
 # Get events for an account
-opensea events by-account 0xde7fce3a1cba4a705f299ce41d163017f165d666 --limit 2
+opensea events by-account 0x21130e908bba2d41b63fbca7caa131285b8724f8 --limit 2
+```
+
+### Tokens
+
+```bash
+# Get trending tokens
+opensea tokens trending --limit 2
+
+# Get trending tokens on a specific chain
+opensea tokens trending --chains base --limit 2
+
+# Get top tokens by 24-hour volume
+opensea tokens top --limit 2
+
+# Get top tokens on a specific chain
+opensea tokens top --chains base --limit 2
+
+# Get details for a specific token (DebtReliefBot on Base)
+opensea tokens get base 0x3ec2156d4c0a9cbdab4a016633b7bcf6a8d68ea2
 ```
 
 ### Accounts
 
 ```bash
 # Get account details
-opensea accounts get 0xde7fce3a1cba4a705f299ce41d163017f165d666
+opensea accounts get 0x21130e908bba2d41b63fbca7caa131285b8724f8
 ```
 
 ## Exit Codes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opensea-cli",
-  "version": "0.1.0",
+  "version": "0.1.5",
   "type": "module",
   "description": "OpenSea CLI - Query the OpenSea API from the command line or programmatically",
   "main": "dist/index.js",