January 3, 2026•by Engineering

What is the Write API?

XCROP is the only crypto data API that also lets you write to X/Twitter programmatically. Create tweets, reply to threads, quote-tweet, like, retweet, follow/unfollow, and delete posts, all through simple API calls.

Common uses include:

• Trading alert bots: auto-post when your system detects signals

• Community engagement tools: reply to mentions and threads automatically

• Content automation: schedule and publish crypto content

• Portfolio update bots: share trading results with your audience

Want ready-to-run bot code instead of the full reference? See How to Automate Twitter Posts for a scheduled posting bot, a KOL engagement bot, and an auto-reply bot built on the endpoints below.

Connecting Your X Account

Before using write operations, you need to connect your X/Twitter account to XCROP. A residential proxy is required. All write operations are routed through your proxy to protect your account from detection.

Connect via API (Credentials)

PYTHON

import requests
import os

response = requests.post(
    "https://xcrop.io/api/v2/account/connect",
    headers={
        "Authorization": "Bearer " + os.environ["XCROP_API_KEY"],
        "Content-Type": "application/json"
    },
    json={
        "email": "[email protected]",
        "password": "your-x-password",
        "proxy": "http://user:pass@host:port",
        "totp_secret": "JBSWY3DPEHPK3PXP"  # Optional: base32 TOTP secret for 2FA
    }
)

result = response.json()
print("Status: " + result["status"])
# "connected" - ready to use write operations

Connect via Cookies (Alternative)

If you prefer not to store credentials, you can connect using browser cookies:

PYTHON

response = requests.post(
    "https://xcrop.io/api/v2/account/connect",
    headers={
        "Authorization": "Bearer " + os.environ["XCROP_API_KEY"],
        "Content-Type": "application/json"
    },
    json={
        "auth_token": "your_auth_token_cookie",
        "ct0": "your_ct0_cookie",
        "proxy": "http://user:pass@host:port"
    }
)

> Note: Cookie-based sessions do not auto-refresh. When cookies expire, you'll need to provide new ones. Credential-based connections refresh sessions automatically.

Proxy Requirements

• Required: you must provide a proxy URL when connecting

• Format: http://user:pass@host:port or socks5://user:pass@host:port

• Recommended: Residential proxies for best reliability and lowest detection risk

• Validated: Proxy is checked for liveness before the connection is accepted

• All write operations are automatically routed through your proxy

Check Connection Status

JAVASCRIPT

const response = await fetch("https://xcrop.io/api/v2/account/status", {
  headers: { "Authorization": "Bearer " + apiKey }
});

const result = await response.json();
console.log("Connected: " + result.connected);
if (result.data) {
  console.log("Username: @" + result.data.username);
  console.log("Proxy configured: " + result.data.proxy_configured);
}

Security: How We Protect Your Credentials

Here's how XCROP keeps your X account credentials secure:

• AES-256-GCM encryption: all credentials and proxy URLs are encrypted at rest

• Per-user isolation: each user's session is completely separate

• No credential sharing: your login is never shared with other XCROP users

• Disconnect anytime: one API call removes all stored credentials permanently

PYTHON

# Disconnect and remove all stored credentials + proxy
response = requests.delete(
    "https://xcrop.io/api/v2/account/disconnect",
    headers={"Authorization": "Bearer " + os.environ["XCROP_API_KEY"]}
)
print(response.json()["status"])  # "disconnected"

Creating Tweets

Simple Tweet

PYTHON

response = requests.post(
    "https://xcrop.io/api/v2/tweets/create",
    headers={
        "Authorization": "Bearer " + os.environ["XCROP_API_KEY"],
        "Content-Type": "application/json"
    },
    json={
        "text": "GM crypto! Markets looking bullish today."
    }
)

tweet = response.json()["data"]
print("Tweet posted! ID: " + tweet["tweet_id"])

Long-Form Content (Note Tweets)

For content over 280 characters, XCROP automatically switches to X's Note Tweet feature. No extra code needed:

PYTHON

long_text = (
    "Market Analysis - March 2026\n\n"
    "Key observations:\n"
    "- BTC holding strong above $95k support\n"
    "- ETH/BTC ratio recovering after months of decline\n"
    "- DeFi TVL hitting new ATH at $180B\n"
    "- Solana ecosystem showing strong developer growth\n\n"
    "My thesis: We are in the early stages of a macro bull run. "
    "The combination of ETF inflows, halving effects, and increasing "
    "institutional adoption creates a perfect storm.\n\n"
    "DYOR. Not financial advice."
)

response = requests.post(
    "https://xcrop.io/api/v2/tweets/create",
    headers=headers,
    json={"text": long_text}
)
# Automatically posted as a Note Tweet (>280 chars)

Replying to Tweets

Build conversational bots that reply to specific tweets:

PYTHON

response = requests.post(
    "https://xcrop.io/api/v2/tweets/reply",
    headers=headers,
    json={
        "tweet_id": "1234567890123456789",
        "text": "Great analysis! I agree with your take on the ETH/BTC ratio."
    }
)

reply = response.json()["data"]
print("Reply posted! ID: " + reply["tweet_id"])

Quote Tweeting

Share and comment on others' content:

PYTHON

response = requests.post(
    "https://xcrop.io/api/v2/tweets/quote",
    headers=headers,
    json={
        "quoted_tweet_id": "1234567890123456789",
        "text": "This is exactly the kind of on-chain analysis traders need."
    }
)

quote = response.json()["data"]
print("Quote tweet posted! ID: " + quote["tweet_id"])

Like, Retweet, Follow

PYTHON

# Like a tweet
requests.post(BASE_URL + "/tweets/1234567890/like", headers=headers)

# Retweet
requests.post(BASE_URL + "/tweets/1234567890/retweet", headers=headers)

# Follow a user
requests.post(BASE_URL + "/users/elonmusk/follow", headers=headers)

# Unfollow
requests.delete(BASE_URL + "/users/elonmusk/follow", headers=headers)

# Unlike
requests.delete(BASE_URL + "/tweets/1234567890/like", headers=headers)

# Unretweet
requests.delete(BASE_URL + "/tweets/1234567890/retweet", headers=headers)

Deleting Tweets

Remove tweets programmatically:

PYTHON

response = requests.delete(
    "https://xcrop.io/api/v2/tweets/1234567890123456789",
    headers=headers
)
print(response.json()["status"])  # "deleted"

Use Case: Trading Signal Bot

Here's a complete example that combines XCROP's read and write APIs to build a trading signal bot:

PYTHON

import requests
import time
import os

API_KEY = os.environ["XCROP_API_KEY"]
HEADERS = {
    "Authorization": "Bearer " + API_KEY,
    "Content-Type": "application/json"
}
BASE_URL = "https://xcrop.io/api/v2"

def check_kol_signals():
    """Monitor KOL tweets and auto-post signals."""
    tweets = []
    for kol in ["CryptoHayes", "DefiIgnas", "Pentosh1"]:
        response = requests.get(
            f"{BASE_URL}/users/{kol}/tweets",
            headers=HEADERS,
            params={"count": 20}
        )
        tweets += response.json().get("data", [])

    for tweet in tweets:
        likes = tweet["metrics"]["likes"]

        # Only post about high-engagement tweets
        if likes > 5000:
            author = tweet["author"]["username"]
            signal_text = (
                "KOL Alert!\n\n"
                + "@" + author
                + " just posted with " + str(likes) + " likes:\n\n"
                + "\"" + tweet["text"][:200] + "\"\n\n"
                + "#crypto #alpha"
            )

            # Post the signal
            post_resp = requests.post(
                BASE_URL + "/tweets/create",
                headers=HEADERS,
                json={"text": signal_text}
            )

            if post_resp.status_code == 200:
                tweet_id = post_resp.json()["data"]["tweet_id"]
                print("Signal posted: " + tweet_id)

# Run every 5 minutes
while True:
    check_kol_signals()
    time.sleep(300)

Credit Usage for Write Operations

Write operations use a flat rate of 100 credits per operation:

OperationCredits

Create tweet100

Reply100

Quote tweet100

Like / Unlike100

Retweet / Unretweet100

Follow / Unfollow100

Delete tweet100

Account connect/disconnect/status100

With the Pro plan ($9.9/mo, 2M credits), you can make 20,000 write operations per month plus thousands of read operations for signal detection.

Best Practices

1. Use a residential proxy. It's required for connecting, and it protects your account from detection.

2. Keep credentials secure. Use environment variables, never hardcode API keys or passwords.

3. Prefer credential-based auth. Sessions auto-refresh, unlike cookie-based connections.

4. Respect X/Twitter rate limits. Don't spam, space out automated posts.

5. Test in Endpoints first. Try write endpoints in the XCROP Endpoints page before automating.

6. Add value. Automated posts should provide genuine value to your audience.

7. Comply with X/Twitter ToS. Automated posting must follow platform rules.

Build this with the XCROP API

One API for X/Twitter data: profiles, tweets, followers, search and real-time streams. Start free with 5,000 credits/month, no card required.

Get your free API key Read the docs See pricing

Automate X/Twitter Posts via API: Write API Guide

What is the Write API?

Connecting Your X Account

Connect via API (Credentials)

Connect via Cookies (Alternative)

Proxy Requirements

Check Connection Status

Security: How We Protect Your Credentials

Creating Tweets

Simple Tweet

Long-Form Content (Note Tweets)

Replying to Tweets

Quote Tweeting

Like, Retweet, Follow

Deleting Tweets

Use Case: Trading Signal Bot

Credit Usage for Write Operations

Best Practices