Rotas para pessoas e para agentes.
Draft for counsel review. These endpoints support the first-party beta interface and may change without notice. They are not a supported public trading API. The canonical machine-readable description is OpenAPI 3.1 JSON.
Disponível no beta atual
GET /api/tokens | Linhas de mercado dos tokens listados e contexto de atualização. |
GET /api/token/:chain/:address | Perfil detalhado de mercado e de risco armazenado. |
GET /api/chains | Metadados das redes suportadas. |
GET /api/portfolio | Posições somente leitura para um endereço público EVM ou Solana informado por quem chama. |
GET /api/quote | Cotação do provedor para um swap suportado. |
POST /api/build | Dados de transação não assinados vinculados a uma cotação anterior e a um endereço público de carteira. |
GET /api/xquote | Cotação de rota entre redes e material de transação não assinado quando disponível. |
GET /api/xstatus | Status atual da transação de ponte conforme informado pelo provedor. |
POST /api/solrpc | Leituras de Solana em lista de permissões e relé limitado de transações serializadas já assinadas. |
Autenticação e limite de assinatura
As rotas do beta atual não autenticam um usuário de API e não aceitam credencial de API de quem chama. Um endereço público de carteira é entrada de roteamento, não prova de titularidade. O servidor pode usar internamente seu próprio acesso a provedores, mas essas credenciais nunca fazem parte do contrato público de requisição ou resposta.
/api/build constructs unsigned material only. It does not authorize, sign, submit or confirm a transaction. A compatible caller-controlled wallet must show and sign the exact transaction. /api/solrpc is the narrow exception for submission: it can forward already-signed Solana bytes after verifying signatures, enforcing the 1,232-byte transaction limit, requiring preflight and bounding retries. It cannot create a signature, change the signed message or authorize the transaction.
Limites de taxa e atualidade
Limits are in-memory fixed windows of 60 seconds, identified by the Cloudflare client address when present and otherwise the socket address. /api/quote, /api/build and /api/xquote share 60 requests per client and 1,200 globally per window. Portfolio cache misses allow 12 per client and 300 globally. Solana RPC reads allow 60/1,200, single signed submissions 6/120, and signed batches of 2–10 transactions 2/20. Exhausted budgets return HTTP 429; process restarts reset the counters. These are current implementation limits, not service guarantees.
The token list is rebuilt at most once every 10 seconds. Identical portfolio requests can reuse a response for 30 seconds. Non-RPC application JSON responses carry Cache-Control: no-store, but internal reuse still applies and source market, profile, RPC and provider observations have independent timestamps and can be older. Quotes, transaction material, prices and bridge statuses can become stale before use; request a fresh quote and verify current chain state in the signing wallet.
Riscos e disponibilidade
Providers can be unavailable, routes can disappear, price coverage can be missing, and thin or adversarial markets can make estimates misleading. Token scores and risk fields are heuristics, not audits or safety guarantees. Validate recipient, chain, assets, amounts, approvals, fees, slippage and calldata before signing. See Safety, Fees and the Risk Disclosure.
Status do MCP: em desenvolvimento
Hoje não há endpoint MCP público da MemeSwap implantado. A superfície planejada limita-se a leituras de pesquisa, cotações e construção não assinada. Ela não guardará segredos de carteira, não assinará mensagens, não enviará chamadas de contrato irrestritas nem oferecerá uma ferramenta genérica de execução de ordens. Seu modelo de autorização, nomes de ferramentas, pacotes de SDK e garantias de serviço ainda não são contratos públicos.
Taxas e acesso
Vinculação de taxas, metadados de OAuth, pacotes de SDK e garantias de serviço ainda não são oferecidos publicamente. Não construa sistemas de produção sobre endpoints não documentados.
Segurança
Report vulnerabilities privately to [email protected]. Agentic Labs LLC, San Antonio, Texas 78261.