Vectr
Docs
Developers

Vectr API Reference

The Vectr API provides REST and SSE endpoints for token discovery, market data, trading quotes, creator fees and AI-agent jobs on Robinhood Chain — the same API the website, Terminal, Swap, CLI and MCP server all run on.

RESTSSE streamingX-API-KeyJSON
Basics

Base URL, auth and limits

Base URL
https://api.vectr.bot
Format
JSON over HTTPS
Rate limit
200 requests / 1 min / client
Agent auth
X-API-Key: vectr_…
Account auth
X-login session cookie
Key scoping
read-only · IP allowlist · recipient allowlist · expiry
public

No header needed — all token, price, fee and profile reads above

X-API-Key

Agent job endpoints and signing. Keys are read-write by default — set read-only, IP-allowlist, recipient-allowlist and expiry at creation in your profile

session

Account endpoints (/orders, /security, /api-keys, /files, /agent/memory) use the X-login session, not API keys

Quickstart

A job in two calls

Agent endpoints take a prompt, return a job id, and hand the built transaction back for a human to confirm in a UI surface.

curl -X POST https://api.vectr.bot/agent/job -H "X-API-Key: vectr_…" -H "Content-Type: application/json" -d '{"prompt": "buy 0.05 ETH of the top token"}'
→ { "jobId": "job_…" }
curl https://api.vectr.bot/agent/job/job_… -H "X-API-Key: vectr_…"
→ { "status": "completed", "response": "…", "richData": { "transaction": … } }

Tokens & market data

  • GET/tokens?limit=50public

    Top tokens by market cap (max 200)

  • GET/tokens/:addresspublic

    Token detail — price, mcap, curve state, creator

  • GET/tokens/search?q=moonpublic

    Search by name, symbol or address

  • GET/tokens/agents?limit=5public

    Agent-launched tokens, ranked

  • GET/tokens/statspublic

    Platform totals — tokens, traders, fees

  • GET/tokens/activity?limit=20public

    Latest launches, buys and sells

  • GET/tokens/:address/activitypublic

    Per-token feed · ?limit, ?before, ?kind=buy|sell

  • GET/tokens/:address/ohlcvpublic

    Candles for charts

  • GET/tokens/portfolio/:walletpublic

    Public holdings of any wallet

  • GET/tokens/created-by/:creatorpublic

    Tokens launched by an address

  • GET/tokens/trades/:wallet?limit=50public

    Public trade history of a wallet

  • GET/quote-assetspublic

    Pairing assets — native coin and tokenized stocks

  • GET/price/nativepublic

    Native coin USD price

  • GET/configpublic

    Chain id, RPC, contract addresses, live fee rates

  • GET/stockspublic

    Tokenized stocks available as pairing assets

  • GET/agent-profilespublic

    Public agent profiles

  • GET/agent-profiles/:walletpublic

    One agent profile

  • GET/skills/catalogpublic

    Published agent skills

Quoting & trading

  • GET/tokens/:address/quote?type=buy&amount=0.1public

    Price a buy or sell before signing

  • POST/tokens/:address/build-txpublic

    Build an unsigned buy/sell transaction

Launch & creator fees

  • GET/launch/estimate-fee?from=0x…public

    Estimated gas for a launch

  • GET/launch/fees/:walletpublic

    Accrued, claimable creator fees per asset

  • GET/launch/earnings/:wallet?days=30public

    Creator earnings history and projections

  • GET/launch/daily-limit/:walletpublic

    Launches used / remaining today

AI agent jobs

  • POST/agent/jobX-API-Key

    Submit a prompt — { "prompt": "…", "model"? } → { jobId }

  • GET/agent/job/:idX-API-Key

    Poll status → response · richData (transaction to confirm)

  • POST/agent/job/:id/cancelX-API-Key

    Cancel a running job

Realtime (SSE)

  • GET/tokens/streampublic

    Server-sent events for every indexed trade/price tick

  • GET/tokens/:address/stream?res=5mpublic

    Per-token candle stream — resumable via Last-Event-ID

Errors

Standard NestJS error shape

401 { "message": "X-API-Key header required" }
401 { "message": "Invalid or revoked API key" }
403 { "message": "IP 203.0.113.7 is not in this key's allowlist" }
404 token / profile / job not found
429 global rate limit (200 req/1min)

Keep going

Read-only endpoints are safe to call from anywhere. Agent jobs only prepare transactions — but a read-write API key can broadcast through /wallet/sign-and-submit, so scope keys down to read-only whenever a key only needs data.