Meta

• License: MIT License (MIT)
• Author: Josh Alley
• Tags 2s.io , agentic , ai-agents , base , pay-per-call , stablecoin , usdc , x402
• Requires: Python >=3.10
• Provides-Extra: svm

Classifiers

• Development Status
  • 4 - Beta
• Intended Audience
  • Developers
• License
  • OSI Approved :: MIT License
• Programming Language
  • Python :: 3
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
• Topic
  • Internet :: WWW/HTTP
  • Software Development :: Libraries :: Python Modules

2sio (Python)

Python client for 2s.io — the (most) everything API. Pay-per-call AI-agent data APIs on Base or Solana via x402.

pipinstall2sio

🎁 Try before you buy — free, no wallet

Verify any endpoint before funding a wallet. trial=True makes free calls (one per endpoint per hour, no key, no signup):

fromtwosioimport TwoS

trial = TwoS(trial=True)
print(trial.validate.iban(iban="GB82WEST12345698765432").data["items"][0]["valid"])
# real result; once/hour/endpoint, then raises TwoSError(code="TRIAL_EXHAUSTED")

Pass private_key=... (below) to pay per call for unlimited access.

Quick start

importos
fromtwosioimport TwoS

# private_key is an EVM key (0x...) holding USDC on Base mainnet.
client = TwoS(private_key=os.environ["EVM_PRIVATE_KEY"])

r = client.patents.search(q="neural network", limit=5)
print(r.data["hits"][0]["title"])
print("paid:", r.cost_usd, "USDC, tx:", r.settlement["tx_hash"])

Settles on Base mainnet in ~2 seconds. Prices start at $0.001/call.

If you'd rather construct the signer yourself (e.g. for a custodial KMS-backed wallet), pass it directly:

frometh_accountimport Account
signer = Account.from_key(os.environ["EVM_PRIVATE_KEY"])
client = TwoS(signer=signer)

What's included

An ever-expanding catalog of 300+ endpoints across 95 groups, namespaced by group:

client.patents.search(q="...")
client.patents.detail(applicationNumber="18566276")
client.crypto.address_validate(chain="eth", address="0xd8dA...")
client.ai.summarize(url="https://example.com")
client.law.sanctions_check(name="John Smith")
client.security.cve(id="CVE-2021-44228")
client.geocode.address(query="350 5th Ave, New York, NY")
client.weather.zip(zip="94103")
# ... and more — patents, law, finance, gov, vehicles, health, security,
# agriculture, energy, maritime, space, geo/weather, business registries

Full catalog: https://2s.io/api/directory. OpenAPI: https://2s.io/api/openapi.

Safety

• The client refuses to sign payments above max_price_usd (default $0.10).
• Optional on_payment_requested hook for per-call approval.

client = TwoS(
 private_key=os.environ["EVM_PRIVATE_KEY"],
 max_price_usd=0.05,
 on_payment_requested=lambda info: info["amount_usd"] < 0.02,
)

Errors

• TwoSError — HTTP error from 2s.io.
• PaymentRefusedError — local refusal (price cap or hook).

License

MIT.

Verified details

These details have been verified by PyPI

Maintainers

👁 Avatar for 2sio from gravatar.com
2sio

Unverified details

These details have not been verified by PyPI

Project links

• Homepage
• Issues
• Source

• Download URL: 2sio-1.58.0.tar.gz
• Upload date: Jun 18, 2026
• Size: 49.0 kB
• Tags: Source
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/6.2.0 CPython/3.11.15

Hashes for 2sio-1.58.0.tar.gz

Algorithm	Hash digest
SHA256	ec274ee61d888ef0049afc8b6789816e6c1ed582e5ad4885ba15539157461da9
MD5	a481ad45f52e7cad1506aecd39853176
BLAKE2b-256	c717d48780d21a75b10d6921ffe4417e50fb8ce26a5df7db1b71a9093afbbc1a

See more details on using hashes here.

• Download URL: 2sio-1.58.0-py3-none-any.whl
• Upload date: Jun 18, 2026
• Size: 48.2 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/6.2.0 CPython/3.11.15

Hashes for 2sio-1.58.0-py3-none-any.whl

Algorithm	Hash digest
SHA256	fb5e5d1c2e01133484b68395f689524882966fe86e2cffd5e0a833ec5383f8a8
MD5	8b32faf7fc914529af8897134127519c
BLAKE2b-256	34168d53bdb452a847ac4bc71a2350fec2dc70fccbd822578e844f053d17d60e

See more details on using hashes here.