Guia

Tudo aqui usa moedas inventadas. Nada pode ser comprado, convertido ou ganho em dinheiro de verdade. Os números mostrados são os padrões atuais; um Stonkverse pode alterar alguns deles.

Novo por aqui? Comece aqui

O que é isto?

OneStonks é uma bolsa em que, no lugar de empresas, há personagens, lugares e maravilhas de uma história. Cada um é um stonk. Você ganha moedas grátis para jogar, compra "ações" dos stonks em que acredita e as vende depois. Se um stonk fica mais popular entre os outros jogadores, o preço sobe e você lucra. Se não, ele cai. Os rankings mostram quem jogou melhor.

Por que “stonks”?

O nome é uma homenagem ao meme da internet: “stonks”, uma grafia propositalmente errada de “stocks” (ações) que acompanha um rosto convencido e um gráfico subindo, mesmo quando não deveria. Gostamos demais para não pegar emprestado, e este é o nosso agradecimento ao original. Aqui está ele, e o Know Your Meme conta a história dele.

O meme stonks: um homem de terno com os braços cruzados diante de um painel de bolsa azul, uma seta laranja subindo e a palavra “stonks” — O verdadeiro meme stonks. Não é nosso: obrigado a quem o fez e o compartilhou.

Primeiros passos

Cadastre-se e abra um Stonkverse. Um Stonkverse é uma comunidade construída em torno de uma história, com seus próprios stonks e suas próprias moedas. Ao entrar, você recebe 10.000 moedas da moeda desse Stonkverse. Cada Stonkverse é um mundo à parte: as moedas nunca passam de um Stonkverse para outro.
Escolha um stonk. Abra a lista do mercado e busque ou ordene. Todo stonk tem um ticker (um código curto como ZORO) e um preço.
Compre. Digite quantas moedas quer gastar. A página mostra quantas ações você recebe e qual será o preço depois, antes de você confirmar.
Acompanhe. Os preços só se movem quando as pessoas negociam. Adicione stonks à sua lista de observação, veja o gráfico e confira seu portfólio.
Venda quando quiser suas moedas de volta. Seu lucro é a diferença, menos as taxas.

De onde vêm os preços? (ninguém está "do outro lado")

Numa bolsa de verdade, um comprador precisa de um vendedor. Aqui, cada stonk tem um pool: um estoque de ações e um estoque de moedas mantidos pelo próprio jogo. O preço é simplesmente moedas no pool ÷ ações no pool.

Quando você compra, coloca moedas no pool e tira ações. Menos ações e mais moedas fazem o preço subir.
Quando você vende, devolve ações e tira moedas. O preço cai.
Assim, o preço reflete quantas pessoas compraram em relação a quantas venderam. Stonks populares sobem, os esquecidos afundam.
O pool nunca pode ser esvaziado. Quanto mais perto um comprador chega de levar todas as ações, mais cada ação adicional custa: sempre sobra alguma, mas fica caríssima.

Um exemplo prático

Um stonk novo começa em 10 moedas, com 3.000 ações e 30.000 moedas no pool. Você gasta 100 moedas:

Taxa de negociação (2%)	2 moedas
Moedas que realmente entram no pool	98 moedas
Ações que você recebe	9,76
Preço médio que você pagou	10,23 (um pouco acima de 10: você empurrou o preço para cima ao comprar)
Novo preço do stonk	10,06 (alta de 0.65%)
Se você vendesse tudo de volta na hora	96,03 moedas (você perde a taxa duas vezes, mais um pequeno efeito no preço)

Quanto maior a sua operação em relação ao pool, mais você move o preço contra si mesmo. Isso se chama impacto no preço. A maior compra individual permitida é 2% das moedas do pool (600 aqui), o que moveria este preço em cerca de 4.0%. Muitas operações pequenas têm menos impacto do que uma enorme. Se quiser usar mais de uma vez, marque Gaste mais, em várias ordens (ou Venda mais, em várias ordens) no formulário: ele divide o gasto ou a venda em várias ordens, cada uma dentro do limite, uma após a outra. O limite continua e você paga por isso: cada ordem move um pouco o preço e paga a taxa, então na média você paga mais (ou recebe menos) do que com uma ordem só. Até 20 ordens por vez.

Taxas

Toda compra e toda venda paga 2%. As taxas são destruídas, não são pagas a ninguém. Se o preço se mover contra você mais de 2% entre o momento em que você vê uma cotação e o momento em que a operação é executada, a operação é recusada em vez de lhe dar um negócio pior.

Trocar um stonk por outro

Quer passar de um stonk para outro sem fazer as contas sozinho? Abra a página de um stonk e use Trocar: escolha a direção (trocar deste stonk ou para ele), escolha o outro stonk e uma quantidade e leia a pré-visualização. Uma troca é uma venda seguida logo de uma compra com o que a venda rendeu, feita de uma só vez: você paga a comissão nas duas partes e os dois preços mexem-se, exatamente como se tivesse feito as duas operações. Se uma das partes for recusada, não acontece nada. Os botões de percentagem e o controle deslizante vão até à maior troca permitida neste momento.

Ordens que esperam por você

Compra limitada: "compre para mim se o preço cair para X" (comprar mais barato).
Venda limitada: "venda se o preço subir para X" (realizar lucro).
Venda stop: "venda se o preço cair para X" (cortar uma perda).
Compra stop: "compre se o preço subir para X" (entrar numa tendência de alta).

Você pode ter até 10 ordens abertas; elas expiram após 30 dias. São verificadas cerca de uma vez por minuto, não instantaneamente.

Apostar na queda: a venda a descoberto

Se você acha que um stonk vai cair, pode vendê-lo a descoberto: o jogo empresta ações a você, você as vende agora e as recompra depois. Se o preço caiu nesse meio-tempo, você fica com a diferença. Se subiu, você a perde, e pode perder mais do que esperava, então é para jogadores experientes. Você precisa depositar uma garantia (5% da venda), há uma pequena taxa diária (0.1% por dia) e o jogo encerra sua venda a descoberto por você se a sua margem de segurança ficar baixa demais.

Rankings, temporadas e recomeços

O patrimônio líquido é o seu saldo em moedas mais o que suas ações realmente pagariam se você as vendesse todas agora (taxas e impacto no preço incluídos).
Há rankings de patrimônio líquido total, de ganho percentual deste mês e da temporada atual de 90 dias. As porcentagens permitem que uma conta pequena vença uma grande.
Para aparecer, você precisa de 7 dias no Stonkverse e 3 operações, e o seu perfil precisa permitir. As temporadas nunca reiniciam ninguém; só começam um ranking novo e mantêm os pódios antigos.
Faliu? Depois de 30 dias você pode recomeçar um Stonkverse: suas ações são vendidas ao preço de mercado e você recebe uma carteira nova, desde que não esteja na frente (patrimônio líquido de no máximo 1% do seu último valor inicial). Suas medalhas ficam.
As medalhas Diamond Hands premiam quem mantém um stonk por 90 dias (bronze), 365 dias (prata) e 1095 dias (ouro).

Horário do mercado (em alguns Stonkverses)

Alguns Stonkverses seguem uma história lançada num calendário: um capítulo semanal, uma edição mensal, um episódio. Para que vazamentos e spoilers não movam os preços antes do lançamento oficial, um Stonkverse assim pode ter horário de mercado: ele fecha alguns dias antes do lançamento e reabre no momento em que o novo capítulo ou episódio sai. Uma história semanal pode ficar aberta do domingo à noite até a noite de terça e fechada no resto da semana.

Enquanto o mercado está fechado, você ainda pode ver tudo: preços, gráficos, rankings, sua carteira. O que para é comprar, vender, novas ordens e vendas a descoberto. As ordens que já estavam esperando continuam esperando e podem ser executadas quando o mercado reabrir, e a taxa de empréstimo de uma venda a descoberto não corre enquanto o mercado está fechado.

A página do Stonkverse sempre diz se o mercado está aberto e quando isso muda, no seu fuso horário. Os administradores podem abrir ou fechar o mercado antes do previsto, por exemplo se um capítulo sai mais cedo ou um spoiler vaza. Quando fazem isso, a página avisa e a mudança fica registrada no registro de atividades. Os Stonkverses que não precisam disso ficam sempre abertos.

Conquistas

Pequenos marcos que dizem «você fez isso pela primeira vez»: a primeira compra, uma primeira troca, ter três stonks ao mesmo tempo e mais. Ao desbloquear uma, um cartãozinho desliza por alguns segundos e você recebe uma notificação. São só por diversão: nunca dão moedas nem qualquer vantagem, e você pode ver todas (e as que ainda estão bloqueadas) na página da sua conta.

Convide amigos

Cada conta tem um link de convite pessoal (Conta, depois Convide amigos); um amigo também pode digitar o seu código no formulário de cadastro. Quem entra por ele ganha uma moldura de perfil exclusiva «Convidado por um amigo». Quando se torna um jogador ativo (e-mail verificado, conta com pelo menos 3 dias e pelo menos 5 negociações) você também ganha uma conquista e uma moldura exclusiva: Explorador por 1 amigo, Recrutador por 3, Capitão por 10, Lenda por 25.

As molduras e as conquistas são só estéticas: nunca mexem nas suas moedas, negociações, limites ou classificação, e funcionam sem Premium. No máximo 10 amigos podem começar a contar para você em qualquer período de 7 dias; os outros esperam a vez.

Parte das taxas. No momento não está ativa. Pode ser ligada mais tarde: quem convidou um amigo receberia de volta uma pequena porcentagem das taxas que esse amigo paga, por um tempo limitado, na moeda de cada Stonkverse em que vocês dois jogam. Sairia de taxas que são queimadas de qualquer jeito e teria tetos rígidos, por amigo e no total por Stonkverse, então trazer muitos amigos não desequilibra um mercado. Se for ligada, os números exatos aparecem aqui.

Avisos no seu dispositivo

Se quiser, o OneStonks pode enviar um aviso curto para o celular ou computador que você está usando (Conta, depois Avisos neste dispositivo). Só pede quando você aperta o botão, e de lá você pode desativar, ou remover um dispositivo, quando quiser.

Foi pensado para ser raro. Só trata de coisas que você mesmo configurou: uma ordem limite ou stop executada, falha ou expirada, e uma venda a descoberto encerrada automaticamente (propostas, temporadas e novos emblemas podem ser adicionados, mas ficam desligados até você escolher). Sem anúncios, sem mensagens de “volte”, nada sobre conquistas ou convites. Várias coisas ao mesmo tempo viram uma só mensagem, nunca há mais de 3 por dia nem com menos de 10 minutos de intervalo, nos seus horários de silêncio nada chega (das 22:00 às 08:00, a menos que você mude; o que acontecer nesse meio-tempo chega junto depois) e um aviso que esperou mais de 12 horas é descartado em vez de chegar atrasado. Se o site estiver aberto na sua frente, o sino avisa e nenhum aviso aparece. Ao sair da conta, esse dispositivo é removido.

Precisa de um navegador compatível (Chrome, Edge, Firefox, Safari no Mac; no iPhone e iPad só depois de adicionar o OneStonks à Tela de Início). Os avisos podem aparecer com a tela bloqueada.

Sugerir um stonk

Falta alguém? Quando você for um jogador de confiança (mais de 14 dias e mais de 20 operações no Stonkverse, ajustado ao tamanho da comunidade), pode propor um stonk. Ele precisa dos votos de 5% dos jogadores de confiança (pelo menos 3) e da aprovação de um administrador.

Bons hábitos

Leia a cotação antes de confirmar: ela mostra as ações exatas e o preço depois.
Stonks pequenos têm pools finos: oscilam muito e custam mais para negociar em volume.
Não ponha tudo em um só stonk. Os preços podem cair tão rápido quanto sobem.
É um jogo. Nada aqui é aconselhamento financeiro e as moedas não são dinheiro.

Resumo para traders experientes

Resumo: AMM de produto constante de ativo único por stonk (x·y = k, reservas virtuais, sem livro de ofertas, sem preço externo), taxa do taker queimada, ordens limitadas/stop opcionais e vendas a descoberto sobre a mesma curva, moeda fictícia, sem dividendos, sem ETFs.

Mecânica do mercado

Item	Valor / regra
Mercado	Pool por stonk: reserva de moedas X, reserva de ações Y, preço P = X / Y, invariante k = X·Y. Reservas virtuais: sem contraparte real.
Taxa f	2% do lado do taker, em toda compra e venda, queimada. Não é adicionada ao pool, então k só cresce por arredondamento.
Compra, gasto S	n = S·(1 − f); Y′ = ⌈k / (X + n)⌉; ações recebidas = Y − Y′; X′ = X + n.
Venda, s ações	Y′ = Y + s; X′ = ⌈k / Y′⌉; bruto = X − X′; pagamento = bruto·(1 − f).
Impacto no preço	≈ n / X para compras pequenas (a curva inteira é x·y = k). Ida e volta custa ≈ 2f + impacto.
Arredondamento	Sempre a favor do pool; operações minúsculas repetidas não conseguem extrair valor.
Pool inicial	Y₀ = 3.000 × multiplicador de profundidade, P₀ = 10, então X₀ = 30.000 × multiplicador. O multiplicador é 1 para todos os stonks (ninguém pode saber de antemão quem ficará popular); um administrador só pode aprofundar um pool depois, o que multiplica as duas reservas pelo mesmo fator e deixa o preço inalterado.
Limites de ordem	Mín. 10 moedas; máx. 2% da reserva de moedas do pool por ordem; 30 operações por usuário por minuto. Opção «várias ordens»: até 20 ordens por pedido, cada uma dentro do limite.
Proteção contra derrapagem	A operação é recusada se o preço for pior que a cotação em mais de 2%.
Escala de liquidez	Cada pool é mantido em X ≥ 16 × moedas emitidas no Stonkverse × (seu peso de profundidade ÷ peso total). X e Y são multiplicados pelo mesmo fator, então P não muda; só a profundidade cresce. Os pools nunca diminuem. Ignorado quando o crescimento é inferior a 1%.
Oferta	Sem número fixo de ações. A oferta líquida só muda por operações, coberturas de vendas a descoberto, fusões (ações novas para os titulares convertidos) e aposentadorias (titulares pagos em moedas novas; ambas registradas e reportadas).
Execução	Ordens a mercado são executadas na hora contra a curva. O preço médio de execução difere do preço spot da cotação pelo impacto.
Troca	A perna de venda e depois a de compra com o resultado, numa só transação. Cada perna mantém a comissão, o limite por ordem (contam os dois pools), o horário de mercado, a permissão para jogar e a proteção de preço; se uma falhar, a troca inteira é recusada. Guardada como duas operações normais ligadas por um identificador de troca. Bloqueada enquanto tiver uma venda a descoberto no stonk que compraria. As ordens limite, stop e as vendas a descoberto continuam a ser só contra moedas: não existe ordem de stonk contra stonk. Conta como duas negociações para o limite por minuto.

Ordens

Tipo	Dispara quando	Execução
Compra limitada	preço ≤ gatilho	Espera, a menos que a execução média (antes das taxas) esteja no limite ou abaixo dele
Venda limitada	preço ≥ gatilho	Espera, a menos que a execução média (antes das taxas) esteja no limite ou acima dele
Compra stop	preço ≥ gatilho	A mercado
Venda stop	preço ≤ gatilho	A mercado

Avaliadas pelo cron de um minuto, não tick a tick. Mesma taxa, limites e regras das ordens a mercado. Máx. 10 abertas por jogador, expiram após 30 dias.

Venda a descoberto

Item	Regra
Abertura	Vender n ações emprestadas pela mesma curva; receita P = bruto − taxa; deposita-se margem M = 5% × bruto; bloqueado = P + M.
Patrimônio	bloqueado − custo de recompra (taxa incluída) − taxa de empréstimo acumulada.
Manutenção	Cobertura forçada pelo cron quando o patrimônio < 25% × custo de cobrir.
Taxa de empréstimo	0.1% por dia sobre o valor da venda, queimada.
Teto de posição vendida	Total de ações vendidas a descoberto por stonk ≤ 5% da reserva de ações do pool.
Dívida incobrável	Se o custo excede o bloqueado, o jogador não recebe nada e o déficit é criado como moedas, registrado no relatório da economia. A perda do jogador fica, portanto, limitada à garantia bloqueada.
Encerramento	Compra de tamanho exato que destrói as ações emprestadas.

Pontuação, recomeço e progressão

Item	Regra
Patrimônio líquido	Saldo + valor de liquidação das posições (vendidas na curva, taxa incluída) + patrimônio em vendas a descoberto (com piso em 0).
Ganho mensal	(PL − base) ÷ base. Base = patrimônio líquido no fim do mês passado, ou seu último valor inicial se você começou depois.
Ganho da temporada	Igual, medido desde o início da temporada (90 dias). Os 10 primeiros são arquivados. Nada é reiniciado.
Requisitos para o ranking	7 dias e 3 operações desde a entrada ou o último recomeço, e "mostrar nos rankings" ativado.
Carteira inicial	10.000 por Stonkverse, selada: sem transferências entre Stonkverses.
Recomeço	No máximo a cada 30 dias, só se PL ≤ 1% × último valor inicial. As vendas a descoberto são cobertas e as ordens canceladas, as posições vendidas na curva, um novo valor inicial é concedido, o histórico é arquivado e as medalhas ficam.
Diamond Hands	Mantenha um stonk por 90 / 365 / 1095 dias para bronze / prata / ouro.
Usuário de confiança	14 dias e 20 operações, escalados por (jogadores ÷ 100)^0.50000000, limitados a 0.25000000–5.00000000.
Nova listagem	Votos de 5% dos usuários de confiança (mín. 3), depois aprovação de um administrador.
Conquistas	Marcos da conta, cada um definido por uma regra simples (primeira compra, venda, troca, short ou ordem; três posições ao mesmo tempo; negociar em cinco dias diferentes; um distintivo; um voto; um reinício). Verificadas após as ações que podem desbloqueá-las e no login. Apenas cosméticas: nunca afetam negociações, taxas, limites ou classificação.
Convites	Seu link está em Conta. Um amigo que se torna ativo desbloqueia molduras e conquistas exclusivas para os dois. Só estética; a parte das taxas opcional é descrita no guia quando está ativa.
Não implementado	Dividendos, ETFs e cestas, transferências entre Stonkverses, valor em dinheiro real.
Horário do mercado	Opcional por Stonkverse. Fecha N dias antes do lançamento num horário local definido e reabre no lançamento; o lançamento se repete a cada N dias ou todo mês, ou é definido à mão. Fechado: só consulta. Compras, vendas, novas ordens, vendas a descoberto e coberturas são recusadas; ordens em espera esperam e podem ser executadas na reabertura; a taxa de empréstimo das vendas a descoberto não acumula. Os administradores podem fechar ou abrir antes do previsto (mostrado na página, registrado); vale até o próximo lançamento previsto.

Glossário

Stonk: Algo que você pode negociar: um personagem, um lugar ou uma coisa de uma história. Cada um tem seu próprio preço.
Ticker: O código curto de um stonk, como LUFFY.
Pool: O estoque de ações e moedas do próprio jogo para um stonk. Define o preço.
Impacto no preço: Quanto a sua própria operação move o preço. Operações maiores ou pools mais finos significam mais.
Derrapagem (slippage): A diferença entre o preço que você esperava e o que você obteve.
Profundidade: O tamanho de um pool. Mais profundo significa preços mais estáveis.
Patrimônio líquido: Suas moedas mais o que suas ações pagariam se você as vendesse agora.
Ordem limitada / stop: Uma instrução que espera um preço antes de agir.
Troca: Vender um stonk e comprar outro com o que a venda rendeu, num só passo.
Conquista: Um pequeno marco que você desbloqueia na primeira vez que faz algo. Só por diversão: sem moedas, sem vantagem.
Convite: Seu link pessoal (ou código) para trazer um amigo. Quando ele se torna um jogador ativo, os dois desbloqueiam molduras e conquistas exclusivas. As recompensas são estéticas.
Venda a descoberto: Uma aposta de que o preço vai cair: vender ações emprestadas agora e recomprá-las depois.
Margem: A garantia que você bloqueia para abrir uma venda a descoberto.
Temporada: Um período fixo com seu próprio ranking. Ninguém é reiniciado.
Recomeço: Começar um Stonkverse de novo com uma carteira nova quando você ficou para trás.

Para desenvolvedores: API pública (beta)

Uma pequena API somente leitura com os dados de mercado que você já vê no site. É um primeiro passo e vai crescer: com o tempo chegarão novos endpoints e campos; os que existem hoje não serão renomeados nem removidos sem aviso.

Anônima. Sem chave, sem conta, sem cookies. Só dados de mercado: nada sobre os jogadores é exposto.
Somente leitura. Não dá para negociar nem alterar nada.
Uso justo. 60 requisições por minuto por endereço; acima disso você recebe 429 com o cabeçalho Retry-After. As respostas ficam em cache por 30 segundos, então perguntar com mais frequência não adianta.
Por diversão. As moedas são inventadas e nenhum preço aqui é dinheiro de verdade nem conselho; não há promessa de disponibilidade.

O básico

Endereço base: https://www.onestonks.app/api/v1. Toda resposta é JSON com o mesmo envelope: {"data": …} (mais "meta" em listas e histórico) ou {"error": {"code", "message"}}. Os preços são strings decimais com 8 casas, para que nada seja arredondado no caminho; as porcentagens são strings com 2 casas. Os horários são segundos Unix (UTC) ou ISO 8601. Qualquer site pode chamá-la pelo navegador (CORS aberto). As mensagens de erro estão em inglês.

Endpoint	O que devolve
`GET /api/v1`	Esta lista, a versão e o limite.
`GET /api/v1/stonkverses`	Os Stonkverses visíveis: slug, nome, moeda, estado, quantos stonks têm e se o mercado está aberto (`market`: `open`, `next_change`).
`GET /api/v1/stonkverses/{slug}/stonks`	Seus stonks com preço e variação. Parâmetros: `sort` = `price` (padrão), `gainers`, `losers` ou `ticker`; `limit` de 1 a 200 (padrão 50); `offset`. `meta.total` diz quantos existem no total.
`GET /api/v1/stonkverses/{slug}/stonks/{ticker}`	Um stonk: preço, variação em 24 h e desde a estreia, data de estreia, pool e abertura, máxima e mínima do dia.
`GET /api/v1/stonkverses/{slug}/stonks/{ticker}/history`	Pontos de preço como `{"t", "price"}`, no máximo 240. Parâmetro: `range` = `1d` (padrão), `1w`, `1m` ou `all`. `meta` traz abertura, máxima, mínima, último e variação.

Experimente

curl "https://www.onestonks.app/api/v1/stonkverses/one-piece/stonks?sort=gainers&limit=3"

Resposta (resumida, valores de exemplo):

{"data":[
  {"ticker":"LUFFY","name":"Monkey D. Luffy","status":"active","price":"10.00217789",
   "change_24h_pct":"0.02","change_since_listing_pct":"0.02","url":"…/s/one-piece/LUFFY"}
 ],
 "meta":{"total":1450,"limit":3,"offset":0,"sort":"gainers"}}

Erros

`400 bad_parameter`	Um parâmetro está fora do intervalo ou não é reconhecido; a mensagem diz qual.
`404 not_found`	Esse Stonkverse ou esse stonk não existe.
`429 rate_limited`	Mais de 60 requisições em um minuto. Espere os segundos indicados em `Retry-After`.

Sentiu falta de algo que usaria? Conte para nós na página de contato: o que vocês pedirem decide o que vem a seguir.