---
title: "获取沙盒实时流信息"
canonical_url: "https://tweetstream.io/zh-cn/docs/api/get-agent-sandbox"
last_updated: 2026-11-05
---

# 获取沙盒实时流信息

免费沙盒实时流的信息：URL、固定账号列表、推送的操作类型、延迟和限制。无需 key 即可连接。

Canonical URL: https://tweetstream.io/zh-cn/docs/api/get-agent-sandbox

## `GET /api/agent/sandbox`

`https://tweetstream.io/api/agent/sandbox`

## 响应字段

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| `accounts` | `object[]`, 必填 |  |
| `accounts.handle` | `string`, 必填 | a string matching the pattern ^@?[A-Za-z0-9_]{1,15}$ |
| `accounts.id` | `string`, 必填 | a string matching the pattern ^[1-9][0-9]{0,19}$ |
| `delaySeconds` | `integer`, 必填 | an integer |
| `limits` | `object`, 必填 |  |
| `limits.connectionsPerClient` | `integer`, 必填 | an integer |
| `limits.sessionMinutes` | `integer`, 必填 | an integer |
| `next` | `object`, 必填 |  |
| `next.message` | `string` | a string at most 500 character(s) long |
| `next.action` | `enum<string>`, 必填 |  |
| `next.who` | `enum<string>`, 必填 |  |
| `operations` | `object[]`, 必填 |  |
| `operations.channel` | `enum<string>`, 必填 |  |
| `operations.op` | `enum<string>`, 必填 |  |
| `status` | `enum<string>`, 必填 |  |
| `stream` | `object`, 必填 |  |
| `stream.subprotocol` | `enum<string>`, 必填 |  |
| `stream.url` | `string`, 必填 | a string matching the pattern ^(https\|wss):\/\/[^\s]+$ |

## 响应

| 状态 | 说明 | 请求头 |
| --- | --- | --- |
| `200` | 成功 |  |
| `503` | 暂时不可用，请稍后重试 |  |

### 200

```json
{
  "accounts": [
    {
      "id": "1395261244769112065",
      "handle": "_richardteng"
    },
    {
      "id": "1470958472409792515",
      "handle": "a1lon9"
    },
    {
      "id": "877807935493033984",
      "handle": "binance"
    },
    {
      "id": "1400391752368992260",
      "handle": "binancewallet"
    },
    {
      "id": "1451036242431262720",
      "handle": "binancezh"
    },
    {
      "id": "973261472",
      "handle": "blknoiz06"
    },
    {
      "id": "1052454006537314306",
      "handle": "bnbchain"
    },
    {
      "id": "14379660",
      "handle": "brian_armstrong"
    },
    {
      "id": "1389913567671975937",
      "handle": "cb_doge"
    },
    {
      "id": "2259434528",
      "handle": "cobie"
    },
    {
      "id": "574032254",
      "handle": "coinbase"
    },
    {
      "id": "902926941413453824",
      "handle": "cz_binance"
    },
    {
      "id": "2704294333",
      "handle": "deitaone"
    },
    {
      "id": "44196397",
      "handle": "elonmusk"
    },
    {
      "id": "1284052345668673536",
      "handle": "eth_cedric"
    },
    {
      "id": "218406806",
      "handle": "fern"
    },
    {
      "id": "20749410",
      "handle": "finkd"
    },
    {
      "id": "3295423333",
      "handle": "firstsquawk"
    },
    {
      "id": "1749114887807320064",
      "handle": "flapdotsh"
    },
    {
      "id": "1816036559864619011",
      "handle": "fourdotmemezh"
    },
    {
      "id": "1003840309166366721",
      "handle": "heyibinance"
    },
    {
      "id": "2070631956824698880",
      "handle": "jensenhuang"
    },
    {
      "id": "2478756618",
      "handle": "jerallaire"
    },
    {
      "id": "18876842",
      "handle": "jessepollak"
    },
    {
      "id": "902839045356744704",
      "handle": "justinsuntron"
    },
    {
      "id": "1792724913528172544",
      "handle": "meadgod"
    },
    {
      "id": "1309886201944473600",
      "handle": "mert"
    },
    {
      "id": "636513296",
      "handle": "nikitabier"
    },
    {
      "id": "1164750442787561474",
      "handle": "nina_rong"
    },
    {
      "id": "4398626122",
      "handle": "openai"
    },
    {
      "id": "5943622",
      "handle": "pmarca"
    },
    {
      "id": "1261335549215989760",
      "handle": "polymarket"
    },
    {
      "id": "2076794413284569089",
      "handle": "ponsdotfamily"
    },
    {
      "id": "1622243071806128131",
      "handle": "pumpfun"
    },
    {
      "id": "25073877",
      "handle": "realdonaldtrump"
    },
    {
      "id": "1265037073",
      "handle": "robinhoodapp"
    },
    {
      "id": "352518189",
      "handle": "robinhoodcrypto"
    },
    {
      "id": "1605",
      "handle": "sama"
    },
    {
      "id": "244647486",
      "handle": "saylor"
    },
    {
      "id": "951329744804392960",
      "handle": "solana"
    },
    {
      "id": "34743251",
      "handle": "spacex"
    },
    {
      "id": "1755899659040555009",
      "handle": "theunipcs"
    },
    {
      "id": "2327407569",
      "handle": "toly"
    },
    {
      "id": "1200616796295847936",
      "handle": "unusual_whales"
    },
    {
      "id": "295218901",
      "handle": "vitalikbuterin"
    },
    {
      "id": "605700792",
      "handle": "vladtenev"
    },
    {
      "id": "1387497871751196672",
      "handle": "watcherguru"
    },
    {
      "id": "1879644163769335808",
      "handle": "whitehouse"
    },
    {
      "id": "3012852462",
      "handle": "zachxbt"
    },
    {
      "id": "18856867",
      "handle": "zerohedge"
    }
  ],
  "delaySeconds": 60,
  "limits": {
    "connectionsPerClient": 2,
    "sessionMinutes": 30
  },
  "next": {
    "action": "connect",
    "message": "Connect with the tweetstream.v1 subprotocol; no key is needed.",
    "who": "agent"
  },
  "operations": [
    {
      "channel": "tweet",
      "op": "content"
    },
    {
      "channel": "tweet",
      "op": "update"
    },
    {
      "channel": "tweet",
      "op": "meta"
    },
    {
      "channel": "tweet",
      "op": "delete"
    },
    {
      "channel": "tweet",
      "op": "pin"
    },
    {
      "channel": "tweet",
      "op": "unpin"
    }
  ],
  "status": "ready",
  "stream": {
    "subprotocol": "tweetstream.v1",
    "url": "wss://sandbox.tweetstream.io/ws"
  }
}
```

### 503

```json
{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "<string>",
    "reason": "not_offered",
    "retryAfterSeconds": 123
  },
  "next": {
    "message": "<string>",
    "action": "call_action",
    "method": "POST",
    "name": "<string>",
    "url": "<string>",
    "who": "agent"
  }
}
```

## 代码示例

### cURL

```bash
curl --request GET \
  --url https://tweetstream.io/api/agent/sandbox
```

### JavaScript

```javascript
const response = await fetch("https://tweetstream.io/api/agent/sandbox", {
  method: "GET",
});

console.log(response.status, await response.json());
```

### Python

```python
import requests

response = requests.get(
    "https://tweetstream.io/api/agent/sandbox",
)

print(response.status_code, response.json())
```
