Squidlor

View saved version →

---
name: squidlor-prices
description: >-
  Use when the user asks for a crypto or tokenized-stock price (BTC, ETH, SOL,
  NVDA, TSLA, AAPL...), "what is X at", a market level, a price at a past time,
  price history, OHLC candles, whether oracle providers agree, whether a price
  feed is stale, or which feeds Squidlor publishes. Answers come from the
  Squidlor MCP server tools (get_price, get_realtime_prices, compare_oracles,
  get_price_history, get_ohlc, get_price_at, list_feeds, get_audit_trail).
---

# Squidlor prices

Squidlor publishes aggregated price feeds on Arc (chain `arc`). Each feed is the
median of what the oracle providers (Chainlink, Pyth, RedStone, DIA, Supra,
eOracle, Chronicle, Stork, Squidlor's own exchange median, Uniswap TWAP) report
for a pair. The tools below read that data. None of them needs an API key.

## Which tool

| User asks | Call |
|---|---|
| "price of BTC", "what is ETH at", one current level | `get_price` with `chain: "arc"`, `pair: "BTC/USD"` |
| several assets at once, or sub-second freshness | `get_realtime_prices` with `symbols: ["BTC","ETH"]` |
| "do the oracles agree", "what does Chainlink say vs Pyth", "is this stale" | `compare_oracles` |
| "what was X at <time>" | `get_price_at` with the time as ISO-8601 or unix seconds |
| "last 24h", "chart", "candles", volatility | `get_ohlc` (candles) or `get_price_history` (median series) |
| "which feeds / pairs / assets exist" | `list_feeds` first, then the price tool |
| "did the oracle lie", deviations, flagged prints | `get_audit_trail` or `list_flagged` |

Pairs are `SYMBOL/USD`. Tokenized stocks use the ticker: `NVDA/USD`, `TSLA/USD`.
If a pair might not exist, call `list_feeds` rather than guessing.

## Reporting a price

- Quote the aggregated median and say it is an on-chain median across oracle
  providers. Give the time of the print when the result includes one.
- The result may carry a coverage verdict or age annotation (how many sources are
  healthy, how old the newest print is). Pass that on when it is anything other
  than fully healthy and fresh. A price from one source, or minutes old, is not the
  same answer as a fresh median of eight.
- When the user asks whether providers agree, give the spread in basis points or
  percent between the highest and lowest provider, name the outlier, and say
  whether it is stale.
- Do not convert a USD price into another currency unless the user asks, and then
  say which rate you used.
- Do not invent a price. If the tool errors or returns nothing, say so and stop.

View saved version →

---
name: squidlor-transfer
description: >-
  Use when the user wants to send, transfer or pay a token to an address ("send
  50 USDC to 0x...", "pay 0.1 ETH to", "transfer"), or asks what a wallet holds.
  Uses the Squidlor MCP tools get_wallet_overview and quote_send. quote_send
  returns an UNSIGNED transaction for the user to sign with their own wallet;
  nothing here can sign or move funds.
---

# Squidlor transfers

`quote_send` builds a token transfer the user can sign. It resolves the token from
what the sender wallet actually holds, checks the balance, and returns the
unsigned transaction fields. Codex has no wallet, so the output of this skill is a
transaction the user signs elsewhere, never a sent transfer.

Transfers work on Ethereum (1), BNB Chain (56), Polygon (137), Arbitrum (42161),
Optimism (10) and zkSync (324). Squidlor's price feeds live on Arc; that is not a
transfer chain here.

## Hard rules

1. **Never ask for, accept, or store a private key or seed phrase.** If the user
   offers one, refuse and explain that the transaction is signed in their wallet.
2. **Never write an address from memory.** Sender and recipient come from the
   user, in this conversation, as full `0x` addresses. If either is missing, ask.
3. **Confirm before quoting.** Repeat token, amount, recipient and chain back to
   the user and get a yes before calling `quote_send`.
4. **Pass the sender explicitly.** This surface has no linked wallet, so every
   `quote_send` and `get_wallet_overview` call needs `wallet: "<sender address>"`.
5. **One quote, then stop.** After presenting the transaction, do not re-call
   `quote_send` unless the user changes something.

## Steps

1. Collect: sender address, recipient address, token ticker, amount in whole
   units (`25` for 25 USDC, never base units), and the chain if known.
2. If the user has not said which chain, or asks what they hold, call
   `get_wallet_overview` with `wallet: "<sender>"` and show the balances.
3. Confirm the four facts with the user (rule 3).
4. Call `quote_send` with `symbol`, `amount`, `to`, `wallet`, and `chainId`.
   - `AMBIGUOUS_CHAIN`: the ticker is held on several chains. Show them and ask
     which one. Do not pick the larger balance.
   - `TOKEN_NOT_HELD`: the wallet does not hold that ticker on any chain the
     engine could read. Say so; a chain the engine could not reach is absent, so
     this is not proof of zero.
   - `NO_LINKED_WALLET`: you forgot `wallet`. Add it and retry once.
5. Present the result.

## Presenting the unsigned transaction

The result has `transfer` (what is being sent) and `transaction` (what to sign).
Show both, in this form:

```
Transfer: <amount> <symbol> on <chain name> (<chainId>)
From:     <transaction.from>
To:       <transfer.to>

Unsigned transaction (sign in your own wallet):
  chainId: <transfer.chainId>
  to:      <transaction.to>
  value:   <transaction.value>
  data:    <transaction.data>
```

Explain the shape once: for a native-coin send, `to` is the recipient and `value`
is the amount in wei; for an ERC-20 send, `to` is the token contract, `value` is
`0`, and `data` is the `transfer(recipient, amount)` calldata. Say that
`transaction.data` is calldata, not a transaction hash, and that there is no
explorer link until the user has signed and broadcast it.

Ways to sign, offered as options and not instructions to run:

- Foundry: `cast send --rpc-url <rpc> --ledger <to> <data> --value <value>`
  (or `--interactive` to be prompted for a key; never put a key on the command
  line).
- A wallet or dapp that accepts a raw transaction (`to`, `value`, `data`) on the
  named chain.
- The Squidlor chat at https://chat.squidlor.com, which runs the same `quote_send`
  with a connected browser wallet and signs in place.

If the result has `indicative: true` or a `transaction` of `null`, there is
nothing to sign. Report the reason in the result and stop; do not tell the user
to look for a signing step that does not exist.